每个显示区域就是一个浏览器,所有内容以 Web 页面方式显示。web 命令向区域下发 URL;插件可用专用 plugin 信封。旧信封
{"display":{...}} 已废弃,屏端报 invalid param: display。web 命令格式
| 字段 | 必填 | 说明 |
|---|---|---|
| url | 是 | 加载的页面地址。视频给 mp4 直链(HTML5 播放),PDF 给直链(内置查看器) |
| method | 否 | HTTP 方法,默认 GET;POST 时携带 data 作为请求体 |
| data | 否 | POST 请求体原文(表单串或 JSON 串,Content-Type 用 header 指定) |
| cookie | 否 | "k=v; k2=v2",加载前按 url 域注入 |
| header | 否 | 自定义请求头,仅对初次加载生效(站内跳转不带,浏览器语义) |
| vars | 否 | 注入页面的变量(插件参数,任意 JSON)。按区域持久化:页面经 window.superScreen.data 读取,且每次加载完成后自动派发一次 superscreen 事件携带该数据;同一插件 URL 在不同区域可带不同 vars |
| interval | 否 | 自动刷新间隔秒数,缺省 0 = 不自动刷新(运行期调节见 control 的 interval)。投放新内容自动清除旧 interval |
| cache | 否 | 布尔兼容,默认 1;cache:0 本次不读不写缓存并删除该 URL 已有缓存(私密内容用) |
plugin 命令(插件投放)
插件的专用信封(等价于 web 的 plugin:// 短链写法,语义更清晰):
| 字段 | 必填 | 说明 |
|---|---|---|
| name | 是 | 插件 slug(字符串 ID,市场/我的插件列表返回);缺失或非法报 invalid param: name |
| v | 否 | 更新版本号(插件 update_time),参与缓存键区分——插件编辑后 v 变化,屏端按新地址重新下载 |
| vars | 否 | 插件参数对象(任意 JSON),语义与 web 的 vars 相同 |
| area | 否 | 目标区域,缺省落默认显示区域 |
屏端展开为接口站显示页地址 https://app.thingboot.com/screen/plugin/show/<name>/(v 非空拼 ?v=),走插件本地托管链路上屏;持久化记展开后的地址,重启恢复时自愈。
plugin:// 短链
插件的 URL 写法(web 信封的 url 字段直接用):
| 短链 | 展开结果 |
|---|---|
plugin://slug | https://app.thingboot.com/screen/plugin/show/slug/ |
plugin://slug:zh-cn | https://app.thingboot.com/screen/plugin/show/slug/?lang=zh-cn |
plugin://slug:en | https://app.thingboot.com/screen/plugin/show/slug/?lang=en |
插件本地托管:plugin:// 与 plugin 信封的内容不走直连——设备先带 UA 标记(SuperScreen/<deviceId>)把页面下载到本地缓存(键 = md5(源URL),与媒体缓存同 LRU),区域窗口改加载本机地址 http://127.0.0.1:<port>/plugin/<md5>/。收益:与站点登录态隔离、离线可用、无混合内容。首次下载失败不上屏(不回退 https 直连);有缓存断网照常可用。普通 http(s) URL 完全不经过本地服务。
查询当前内容
{"web":{"area":"a5"}}(不带 url/data)→ 返回该区域当前内容 {"url":...,"method":...,"cookie":...,"header":{...}};无内容返回 {}。插件内容的 url 为持久化的源地址(接口站 show 地址)。
注意事项
- 收到 web/plugin 命令时该区域窗口自动提升到最前(不抢焦点)
- 未指定 area 时作用于默认显示区域(见本册首页「显示区域的命名与坐标」)
- 网站「插件中心 → 发送到屏幕」组的就是 plugin 命令(v 取插件 update_time 形成新缓存键,vars 为面板生成的 DATA)
- 主框架加载失败或 HTTP 4xx/5xx 时区域显示内置友好错误页(黑底、错误码、URL),子资源失败不触发