文档类型:使用手册 关联软件:FoxDisplay 更新于 2026-09-29

使用手册

展示态、触控编辑、管理后台的逐功能操作说明,参数与数据文件位置一览。

日常怎么用、常见操作怎么做

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/)

文档解决不了的,直接问我们

把现场条件和使用场景说清楚,我们的工程师会给出明确结论,而不是只发一份资料链接。