开发显示插件

显示页与参数

插件由显示页和可选配置面板构成。面板生成 JSON 参数，以 vars 发送并按区域保存。已注册插件使用 name 和可选版本 v，插件标识从项目服务获取；普通公开网页可直接使用 web。

{"plugin":{"area":"a1","name":"<registered-plugin-id>","vars":{"label":"IoT Devices"}}}

读取数据并接收命令

播放器在页面脚本执行前注入 window.superScreen，包含 deviceId、area、bench、version 和 data。启动时读取 data，随后监听 superscreen 事件获取更新；外部文本使用 textContent 渲染。普通浏览器没有播放器桥接对象，应提供缺省数据。

const title = document.querySelector("[data-screen-title]");
function render(data) {
  if (title) title.textContent = String(data?.label ?? "IoT Devices");
}
render(window.superScreen?.data);
window.addEventListener("superscreen", (event) => render(event.detail));

设备桥接能力

• SS.onCommand 接收 control.send 载荷；SS.report 上报 user 事件，设备级上限为每分钟 30 次，应检查返回结果。
• SS.speech 与 SS.stopSpeech 是本地托管插件页的语音能力，普通远程网页不具备该权限。离线运行仍取决于资源缓存及插件所需的外部数据。
• 测试横竖屏、参数缺失、断网与启动恢复。资源使用 HTTPS 地址，避免依赖需要现场操作的网站登录状态。