使用文档
SuperScreen 超级屏的安装、绑定与日常使用
绑定工作台
超级屏复用 ThingBoot 平台账号体系，工作台（bench）即租户：设备归属于工作台，工作台下所有成员都可以管理它的设备，无需逐人授权。
- 设备已设置 bench：该工作台任一成员登录本站即可直接遥控，无需再绑定。
- 设备未设置 bench：在设备首页输入你的工作台控制台 ID 即可（设备 ID 与控制台 ID 都显示在设备首页）。
显示区域
屏幕可划分为多个显示区域，每个区域是一个独立的无边框浏览器窗口。区域的位置用像素表示：[上边距, 左边距, 宽, 高, 叠放层?]。布局为空时存在一个占满整屏的默认区域。
| 操作 | 说明 |
|---|---|
add / update | 新增 / 修改区域（位置与叠放层） |
rename | 重命名区域 |
remove | 删除区域 |
info | 查询区域列表 |
clear | 清空区域内容 |
open / close | 打开 / 关闭窗口（不带区域名则作用于全部） |
show / hide | 还原显示 / 最小化（不清内容） |
内容下发
给区域下发一个 URL，设备即全屏加载它。视频给 MP4 直链（HTML5 播放），PDF 给直链（内置查看器）。支持附带 cookie、自定义 header 和 POST 数据；header 仅在初次加载时生效。收到新内容的窗口会自动提到最前（不抢焦点）。
{"display":{"area":"a5","url":"https://example.com/board"}}
不带 url 时查询该区域当前内容。
浏览器控制
对每个区域的浏览器窗口进行远程控制，支持自由键值组合，未知键会被忽略。
| key | 说明 |
|---|---|
back / forward | 后退 / 前进 |
reload / force_reload | 刷新 / 清缓存强刷 |
scroll / scroll_to | 相对 / 绝对滚动 [x,y] |
zoom | 页面缩放（百分比整数） |
clear | 清除内容 |
send | 向页面发送自定义 JSON 数据 |
语音播报
云端下发文本即可让设备播报。播报按 FIFO 队列依次播放。
text播报文本；lang语言（zh/en，缺省跟随系统）；volume音量（默认 60）；repeat重复次数（默认 1）；- 单独设置语言或音量会持久化；
stop停止播报。
{"speech":{"text":"欢迎光临","lang":"zh","volume":80,"repeat":3}}
页面 JS 桥
上屏网页可以与设备互动（应用橱窗开发者要点）：
- UA 标记：
SuperScreen/<deviceId>（无 ID 时为 0）； - 设备注入对象：
window.superScreen = {deviceId, area, bench, version}； - 接收云端 send 数据：
window.addEventListener('superscreen', e => e.detail)； - 页面上报自定义事件：
window.flutter_inappwebview.callHandler('superScreenEvent', data)。
页面请自适应任意分辨率与横竖屏，建议深色底（设备默认黑底），不要依赖键盘鼠标交互。
系统命令
设备信息与维护类命令：info 设备信息、network 网络信息、state 运行状态、reg 重新注册、ntp 对时。整包 OTA 升级由云端下发包名触发，设备自动下载、升级并重启。
事件上报
设备会持续向云端上报事件，遥控器页面可实时查看：online / offline 上下线，open / close 区域窗口开关（含崩溃），change 布局变化，custom 页面 JS 上报的自定义事件。