显示页与设备互动的全部通道:注入对象、参数 DATA、自定义事件、UA 标记。
window.superScreen(document start 注入,页面任何脚本执行前可读)
SS facade(document start 注入,推荐调用方式)
方法说明
SS.info同 window.superScreen(设备信息对象)
SS.dataplugin/web 命令下发的 vars(无则为 null)
SS.speech(text, {lang, volume})调设备 TTS 本地播报,Promise 返回 {ok:true} / {ok:false,error};仅 plugin:// 本地托管页面可用,纯本地行为,不产生云端消息
SS.stopSpeech()停止页面触发的播报
SS.report(data)上报 user 事件到平台;设备级滑动窗口限频 30 次/分钟,超限返回 {ok:false,error:"rate limited"} 且不上报
SS.onCommand(fn)注册回调,接收 control send 命令透传的载荷(任意 JSON,结构由页面作者解释);同一载荷也经 superscreen 事件派发
接收数据

两条路径等价,插件页面只需写一套监听代码:

页面上报自定义事件
UA 标记

User-Agent 附加 SuperScreen/<deviceId>(无设备 ID 时为 SuperScreen/0),可用于主文档请求的服务端判定。注意:UA 只保证主文档请求携带,页面内的 fetch/图片等子请求不一定带——页面侧判断一律以 window.superScreen 为准。

显示页清单(发布前自查)
  • 自适应任意分辨率与横竖屏
  • 深色底,无键鼠依赖,无外部登录态依赖
  • 资源全部绝对 HTTPS 地址
  • 参数从 window.superScreen.data / superscreen 事件读取,有缺省兜底(未推送 DATA 时页面也能正常显示)