屏端在局域网开放命令服务(WebSocket 主通道 + HTTP 兼容通道),同网系统可直连下发命令,不走云端 MQTT。
端点
屏端监听 LAN 网卡,端口 9756 起顺延(被占 +1..+9,/ping 应答里带实际端口)。
| 端点 | 说明 |
|---|---|
| GET /ping | 设备摘要(无需 token,探测同网用):{"id":597391,"name":"SuperScreen","version":"1.0.0","bench":1685,"status":"online","mode":"platform","lip":"192.168.3.125","port":9756,"ws":true}(mode:platform / gateway / broker) |
| WS /order | 主通道(WebSocket 长连接)。握手鉴权:ws://<lip>:<port>/order?token=<6位控制码>&rid=<遥控器设备ID>&rname=<名称>(也可用 X-SS-Token / X-SS-Remote-Id / X-SS-Remote-Name 头);错误控制码或被禁遥控器返回 403。命令帧 {"mid":"...","data":{命令},"ts":...},应答帧携带原 mid;事件/进度为服务端主动广播的上行帧 |
| POST /order | HTTP 兼容通道(逐步废弃,建议用 WS)。Header X-SS-Token: <控制码>,Body {"mid":"...","data":{命令}},同步返回应答 |
命令格式与 MQTT 下行 data 完全相同(screen/web/plugin/control/cache/speech/bgm/image/document/video/audio/text 包装键 + system:"info"|"reg")。响应带 CORS 头(网页遥控器跨域直连)。
控制码
LAN 鉴权令牌 = 设备的 6 位控制码(本机首启生成,控制台/遥控器设置页可见可刷新;空 = 禁用控制码控制,LAN 一律 403)。控制码经云端配置项 ctrlcode 同步,屏端实时生效;屏端重新生成后旧码立即作废。
适用场景与限制
- 适合:门店本地中控、收银系统联动、对延迟敏感的联动控制、断外网时的应急管控;
- LAN 端点的 system 命令支持
info与reg,其余走云端; - HTTPS 网页(浏览器)直接 fetch LAN 的 http 地址会被浏览器混合内容策略拦截——网页遥控器只在 SuperScreen App 的遥控器模式(已放开混合内容)里使用 LAN 直连;你自己的本地系统(非浏览器)不受此限制;
- App 遥控器模式的媒体文件投放就是经 LAN 完成的:App 把文件托管在
http://<本机IP>:9757/f/<id>/,屏从 LAN 拉取后进入媒体缓存; - 屏处于遥控器模式时,显示族命令应答
{"ret":"error","msg":"device is in remote mode"}。