屏端在局域网开放命令服务(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 /orderHTTP 兼容通道(逐步废弃,建议用 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"}。