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)。通过开放平台的消息推送可订阅这些事件(见《接口》册)。