每个显示区域就是一个浏览器,所有内容以 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://slughttps://app.thingboot.com/screen/plugin/show/slug/
plugin://slug:zh-cnhttps://app.thingboot.com/screen/plugin/show/slug/?lang=zh-cn
plugin://slug:enhttps://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),子资源失败不触发