指南

以编程方式向电视发布内容

要从代码向电视发布内容,可以告诉你的 AI 智能体要显示什么,或在你的 CI 任务中运行一个简短的脚本。无论哪种方式,文件都会被上传,屏幕会指向它,你还会得到它正在播放的证明。本页先讲对话,再展示脚本。

更新于

免费开始查看定价

01 从一句话开始

从一句话开始

CI 任务在每次运行后用几行 Python 绘制一张状态海报。你希望最新的一张出现在团队区域的电视上。

  1. 你

    我们的 CI 任务在每次运行后绘制一张状态海报。把最新的一张放到团队区域的电视上,并在电视真正显示它时告诉我。

  2. 智能体

    构建 4821 已上线:通过,221 项测试中的 221 项。我发送后约两秒,电视确认已收到海报,我还拍了屏幕的图片来核对。

一张深色海报,显示“Main 分支,构建 4821,通过”(绿色)以及 221 项测试中的 221 项
电视上的构建 4821:通过,221 项测试中的 221 项。
  1. 你

    构建 4822 刚刚失败。更新电视。

  2. 智能体

    已更新。电视现在显示失败(红色),221 项测试中的 219 项。

一张深色海报,显示“Main 分支,构建 4822,失败”(红色)以及 221 项测试中的 219 项
更新后的构建 4822:失败(红色),221 项测试中的 219 项。

02 用脚本做同样的事

用脚本做同样的事

CI 任务不聊天。它运行一条命令来上传图片并写入播放列表,再运行第二条命令把它放到屏幕上,并等待电视确认:

终端
screenrig playlist init build-4821.png --screen-id SCREEN --duration-ms 600000 --output board.json
screenrig screen publish SCREEN board.json

CLI 底层是六个带 bearer 令牌的 HTTP 调用。声明上传,发送字节,提交,创建播放列表,让屏幕指向它,再读回屏幕状态。API 参考列出了每一个,CLI 参考列出了退出码。无人值守运行的脚本以服务客户端的身份登录。

03 发布会告诉你什么

发布会告诉你什么

发布最多等待电视两分钟,然后报告结果:

答复它意味着什么要做什么
播放中电视已确认收到播放列表。无需操作。
已分配,屏幕离线电视已关机或断开连接。重新连接后它会播放该播放列表。再次运行同样的发布来等待。它绝不会创建第二个播放列表。
已分配,正在显示接管屏幕上正在显示临时覆盖,所以新的播放列表是默认内容,并在覆盖结束时播放。等待,或清除接管。
已分配,电视拒绝了它电视无法切换,例如切换到地址中带登录信息的页面。阅读原因,修复它,然后刷新屏幕。
等待审核项目需要有人批准更改。在批准之前什么都不会播放。等待批准。
已发布完全相同的发布已经运行过,这是先前的答复。无需操作。

04 重试安全,分享也安全

重试安全,分享也安全

  • 重试不会重复。两次发送同样的发布请求,得到的是同一个播放列表,而不是第二个。
  • 过期的更新会被拒绝。请带上你读到的修订版本进行更新。如果另一个任务先更改了播放列表,你的更新会被拒绝并得知当前修订版本,所以两个任务不会互相覆盖。
  • 屏幕图片是免费的。刷新或一块屏幕上的备注也是。更新一整组屏幕的一条命令只算一次请求,无论它触达多少块屏幕。

你的智能体一分钟就能做出一个幻灯片放映。让它在每块屏幕、每台设备上持续播放多年,才是 screenRIG 要做的事。

播放器页面介绍如何在指定的电视上安装播放器。

下一步:每个调用、字段和错误都在 API 参考中。

05 影片

1:17

观看:你的智能体如何知道它正在播放

77 秒内验证播放:你的智能体发布、用截图自行检查屏幕、捕获问题并修复。

章节和转录 →

影片 / 你的智能体如何知道它正在播放

1:17

咖啡馆老板举起手机,手机屏幕显示柜台后方菜单板的截图

06相关

07 更多指南

screenRIG 免费。

安装官方插件,配对屏幕,你的智能体就能向它发布内容。

免费开始查看定价 →指南 →