显示页与设备互动的全部通道:注入对象、参数 DATA、自定义事件、UA 标记。
window.superScreen(document start 注入,页面任何脚本执行前可读)
SS facade(document start 注入,推荐调用方式)
| 方法 | 说明 |
|---|---|
| SS.info | 同 window.superScreen(设备信息对象) |
| SS.data | plugin/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 时页面也能正常显示)