通过云端开放平台向超级屏下发命令、查询设备、订阅事件。命令体与《命令》册完全一致。
下发命令
请求地址:http(s)://api.thingboot.com/{AppID}/order/?sign={sign}&ts={ts}(或 MQTT 主题 api/{AppID}/order)。参数与返回见平台接口文档「向设备下发指令」。
对超级屏而言,order 的内容就是命令包装键:
常用业务场景
| 场景 | 命令 |
|---|---|
| 门店海报上屏 | web 下发图片/海报页 URL(mp4 视频给直链) |
| 定时切换内容 | 你的调度系统按计划下发不同的 web |
| 分屏混排 | screen add/update 划分区域后,分别 web |
| 打烊清屏 | {"screen":{"action":"clear"}} |
| 到店欢迎 | speech 下发欢迎文本 |
| 插件投放 | plugin 下发插件 slug + vars(见《插件》册) |
查询与事件订阅
- 设备信息/网络/状态:
{"system":"info"}/{"system":"network"}/{"system":"state"}; - 区域布局与当前内容:
{"screen":{"action":"list"}}、{"web":{"area":"a5"}}(查询类命令直接返回数据); - 设备事件(上下线、区域开关、布局变化、页面自定义事件、本地设置变更)经平台消息推送订阅,机制见「平台接口文档」的消息推送部分;
- OTA 升级按平台固件 OTA 流程执行,按本产品 productKey 区分产物。
注意事项
- 多设备可同时下发(device 参数支持间隔符多选),但要求这些设备属于同一产品;
- 命令应答经原通道异步返回并携带原 mid,请在你的系统里做好请求-应答关联与超时处理;
- 下发频率建议控制在每秒数次以内,避免给设备与通道造成压力。
接口站端点(app.thingboot.com/screen/,遥控器/插件生态用)
与开放平台 AppID 体系并列的一组 HTTPS 端点,供遥控器页面与插件生态使用。鉴权二选一:?token= 登录令牌(Authorization: Bearer 头亦可)或 ?code= 设备控制码;JSON 返回 {"code","data","msg"}。
| 端点 | 说明 |
|---|---|
| GET device/channel/?id= | 云控通道信息(Pusher 连接参数 + 控制码开关 + 在线状态) |
| POST device/config/?id= | 配置读写(names 批量读 / fetch 全量读 / write 写) |
| POST device/system/?id= | 系统操作(转工作台 bench / 重新注册 reg / 重启 restart / 模式 mode) |
| GET device/info/?id= | 读设备名称与备注(控制码或登录鉴权) |
| POST device/rename/?id= | 改设备名称/备注(name 4~32 位,中文/英文/数字/_-;remark 空串=清空) |
| POST auth/control/ | Pusher 遥控通道鉴权(bench 归属免码,否则校验控制码) |
| GET plugin/show/<slug>/ | 插件显示页(UA 含 SuperScreen/ 或带 ?preview=1 才给内容) |
| GET plugin/panel/?id= | 插件控制面板页(DATA 变化经 postMessage 推给父页,跨域取参数用) |
| GET plugin/list/ | 插件市场列表(已上架;含 id/slug/title/icon/orient/has_panel/update_time) |
| GET plugin/my/ | 我的插件列表(需登录 token,返回当前用户的插件) |
| GET tts/sources/ | 语音模型补充下载源列表 |
登录令牌经 POST /user/login/ 获取(账号 + md5 密码 + 客户端设备标识;设备标识由 POST /user/device/register/ 签发)。