SDK 内置的系统命令、产品配置项(config 通道),以及设备主动上报的事件。
系统命令({"system":...})
| 命令 | 说明 |
|---|---|
| {"system":"info"} | 获取系统信息(id/key/mode/bench/version 等) |
| {"system":"network"} | 获取网络信息 {"type","mac","ip","mask","gateway","dns"}:type 为当前联网方式(wifi/ether),ip/mask/gateway/dns 为当前网卡地址信息(WiFi 专有的 channel/signal/ssid 等桌面/移动端无 API 不携带) |
| {"system":"state"} | 获取设备属性(未注册属性时为空 {}) |
| {"system":"reg"} | 重新注册(换绑/转工作台后触发) |
| {"system":"ntp"} | 强制对时 |
| {"system":"restart"} | 仅应答不执行(Flutter 应用无法自重启) |
| {"system":{"host":"..."}} | 换服务器(下次连接生效) |
| {"system":"private"/"platform"} | 私有化/平台模式切换(无自重启,手动重启后生效) |
| ble_* / wifi_* 等 | 硬件网络管理类命令对播放器无意义,固定报不支持 |
设备配置项(config 通道)
平台在产品定义中声明配置项,经 config 主题读写(与控制台配置页同款机制)。当前产品的配置项:
| name | 含义 | 值 |
|---|---|---|
| autorun | 开机自启动 | 0 / 1 |
| restore | 启动时恢复显示(重开区域并恢复内容) | 0 / 1 |
| layout | 显示区域布局(AreaLayout JSON) | JSON |
| ctrlcode | 控制码(未登录遥控器的控制凭证;空 = 禁用控制码控制) | 6 位数字 / 空 |
| speech_engine | 语音引擎:跟随系统 / 系统引擎 / 内置离线引擎 | "" / system / sherpa |
| speech_lang | 播报语言 | sys / zh / en |
| speech_volume | 播报音量 | 0~100 |
| speech_rate | 语速倍率 | 0.5~2.0 |
| bgm_volume | 背景音音量 | 0~100 |
| bgm_duck | 声音避让(播报时背景音处理) | no / 10 / 20 / 30 / pause |
| orientation | 显示方向(仅手机/平板端生效) | system / landscape / portrait |
| locale | 屏幕端界面语言 | sys / zh / en |
- 云端写入(config/server)→ 设备立即应用并持久化;云端读取(fetch)→ 返回设备当前真实状态
- 设备端本地修改 → 经 config 主题发布数值型
{"autorun":1}(不是 event 主题) - 平台以后在产品定义里新增配置项,网站设置面板会自动出现,无需改代码
设备事件上报(event/client)
一条事件只针对一个显示区域;多个区域同时变化时上报多条。
| name | 时机 | data 内容 |
|---|---|---|
| online | 上线(SDK 内置) | {"name":"online","state":{...}} |
| offline | 断线遗嘱(SDK 内置) | {"name":"offline"} |
| open | 区域窗口打开 | {"name":"open","area":"a6"} |
| close | 区域窗口关闭(含崩溃) | {"name":"close","area":"a6"} |
| change | 区域布局变化 | {"name":"change","area":"a6","data":[t,l,w,h,layer]};删除时 data 为 [] |
| content | 区域内容变化(投放/清空/恢复) | {"name":"content","data":{"area":"a6","type":"video"}};清空时 type 为空串 |
| user | 页面经 SS.report() 主动上报(设备级限频 30 次/分钟) | {"name":"user","area":"a6","data":{...}} |
| custom | 页面经旧接口 superScreenEvent 上报(兼容保留) | {"name":"custom","area":"a6","data":{...}} |
| toggle | 用户现场手动切换工作模式(命令路径的切换只体现在应答里,不发本事件) | {"name":"toggle","data":{"mode":"console|screen|remote"}}(不带 area) |
上下线只有 online/offline 两个事件(SDK 机制,无 boot/shutdown)。通过开放平台的消息推送可订阅这些事件(见《接口》册)。