日常怎么用、常见操作怎么做
1. 界面总览
FoxDisplay 有三个界面形态,共用同一套场景数据:
| 形态 | 入口 | 用途 |
|---|---|---|
| 展示态 | 启动默认 | 大屏全屏展示当前场景,无任何固定按钮 |
| 触控编辑 | 展示态右下角「配置」角标 | 现场直接编辑场景 |
| 管理后台 | 浏览器打开 http://<大屏IP>:42301 |
场景/模板/资产/设置/日志全功能 |
2. 展示态
- 全屏无边框渲染当前场景;轻触或移动鼠标,右下角淡显「配置」角标,3.5 秒无操作自动隐藏;
- 收到切换命令(TCP/UDP/HTTP)立即换页并落盘;
- 断电重启后自动恢复最近场景。
3. 触控编辑(编辑态)
3.1 悬浮工具区
| 位置 | 内容 | 说明 |
|---|---|---|
| 左上 | ‹ 返回 · 场景名 | 场景名可点击重命名;黄点表示未保存 |
| 右上 | 撤销 重做 模板 另存 保存 | 保存为绿色主按钮;Ctrl+Z / Ctrl+Y 等价 |
| 左下 | + | 展开:添加元素(文字/图标文字/时钟/形状)、背景设置(色板/上传/内置图库 30 张) |
| 元素下方 | 元素工具条 | 选中元素后浮现,按钮自动换行成两排 |
3.2 元素操作
- 选中:单击元素;点空白处取消;
- 移动:按住拖动;方向键微移(Shift ×10);
- 缩放:四角控制点拖动;双指捏合等比缩放;
- 旋转:双指旋转,或在属性数值中直接输入角度;
- 改字:双击文字/图标文字元素,就地编辑,点「完成」提交(Esc 取消);
- 删除:工具条「删除」,立即生效,可用撤销找回。
3.3 元素工具条逐项
| 按钮 | 作用 | 说明 |
|---|---|---|
| ✎ 编辑 | 进入就地改字 | 仅文字/图标文字 |
| A− / A+ | 字号 ±10 | 范围 12–400 |
| 字 | 换字体 | 内置 4 款 + 上传字体(按文件名显示) |
| B | 字重循环 | 常规 400 → 中等 500 → 半粗 600 → 加粗 700 |
| ■ 颜色 | 飞出色板 | 12 预设色 + 自定义取色 |
| ⇔ 对齐 | 左/中/右循环 | |
| ◆ 图标 | 飞出面板 | 图标位置(左/右/无)、20 个内置图标与上传图标、图标颜色;仅图标文字块 |
| ⏱ 格式 | 时钟格式 | 仅时钟元素:YYYY-MM-DD HH:mm 等 7 种 |
| ○− / ○+ | 形状圆角 | 仅形状 |
| ↑ / ↓ | 上移/下移一层 | 调整层级 |
| 🗑 删除 | 删除元素 | 立即生效,可撤销 |
3.4 撤销与保存
- 每个手势结束、每次属性修改记一步历史(最多 60 步),Ctrl+Z / Ctrl+Y 撤销重做;
- 「保存」将场景写入磁盘并立即应用到大屏;「另存」复制为新场景;
- 有未保存修改时点「返回」会三选确认:保存并退出 / 不保存退出 / 继续编辑。
4. 管理后台(浏览器)
访问 http://<大屏IP>:42301,共六页:
| 页面 | 功能 |
|---|---|
| 总览 | 三端口状态、当前场景、运行时长、版本 |
| 场景管理 | 新建(可指定模板底稿)/ 显示(切换大屏)/ 编辑 / 复制 / 重命名 / 删除(内置模板受保护);场景变更实时同步 |
| 模板库 | 内置 20 模板一览,「用此模板新建」直达编辑器 |
| 资产中心 | 背景图片 / 字体 / 图标的上传与删除(背景 ≤10MB、字体 ≤20MB、图标 ≤2MB) |
| 系统设置 | 端口(修改后服务热切换)、开机自启、全屏、Kiosk、访问密码 |
| 接口文档 | 端口与命令速查 + 运行日志(3 秒刷新) |
后台里的「编辑」与触屏编辑器是同一套功能;编辑指定场景用 /editor?scene=<场景id>。
5. 参数说明(settings.json)
数据目录下 settings.json,一般通过后台「系统设置」修改,手工改完重启生效:
| 字段 | 默认 | 说明 |
|---|---|---|
| ports.http / tcp / udp | 42301 / 42302 / 42303 | 三服务监听端口,范围 1024–65535,不可重复 |
| window.fullscreen | true | 启动即全屏 |
| window.kiosk | false | Kiosk 锁定全屏 |
| autoStart | false | 开机自启(也可在后台设置) |
| currentSceneId | tpl-welcome-leader-01 | 启动时显示的场景 |
| password | (空) | 访问密码,空 = 关闭鉴权 |
6. 日常维护动作
- 每天:无需操作(断电自恢复);
- 有来访:触屏或后台换欢迎页、改称呼;
- 每周:后台总览页扫一眼端口状态与日志有无异常记录;
- 节前:模板库选节日模板另存后微调保存。
7. 数据与文件位置
| 内容 | 位置(数据目录) |
|---|---|
| 系统设置 | settings.json |
| 用户场景 | scenes/<场景id>.json |
| 上传资产 | assets/backgrounds|fonts|icons/ |
| 运行日志 | 管理后台「接口文档」页在线查看(内存环形缓冲 500 条) |
| 内置模板与图库 | 随安装包分发,只读(Linux 安装于 /opt 或应用目录内 resources/) |