我需要什么？
三样东西，你大概已经有其中两样：
- 一块屏幕。一台电视、一个电视棒、一台 Raspberry Pi，或接在屏幕上的一台电脑。它运行 screenRIG 播放器，这个应用会显示配对码。内置 Google TV 或 Android TV 的电视、Amazon Signage Stick、Apple TV、Mac、Windows 电脑、Linux、Raspberry Pi、BrightSign，以及 Samsung 和 LG 标牌显示屏都有对应的播放器，任何带现代浏览器的屏幕都能打开网页播放器。下载页面列出了每一种。
- 一个能运行命令的智能体。光是聊天回复不会设置任何东西，所以智能体必须能运行插件。Claude Code、ChatGPT dots 和 Codex、Gemini Spark、Grok Bot 和 Grok Build、Meta Muse 和 Hermes 都可以。插件带来的命令行工具，需要智能体运行命令的环境中有 Node.js 22.23.4+、24.22.1+ 或 26.12.1+。
- 官方插件。它携带你的智能体用来运行屏幕的技能和命令行工具。你粘贴一句话，你的智能体就会从 github.com/screenrig/plugin 安装它。
智能体如何把内容放到电视上？
把一句话粘贴给你的智能体。它会安装官方插件：
文本 I authorize you to install the official screenRIG plugin from https://github.com/screenrig/plugin.- 把你的电子邮件给智能体。它会创建你的项目，并通过电子邮件向你发送控制台邀请。任何事都不必等这封邮件，所以智能体会继续进行。千万不要把密码或令牌粘贴到聊天中。
- 在屏幕上打开播放器，把代码读给你的智能体。它会配对屏幕并为其命名。
- 说明电视上该显示什么。智能体制作内容、发布，并在说完成之前向屏幕索取截图。
每个助手都有各自的第一步，比如两条终端命令，或应用里的一条消息。开始页面提供了每个智能体的确切步骤。
它是什么样子？
这是在测试屏幕上录制的会话的完整首次运行。场所是虚构的。
- 你
用 screenrig.ai 配对这块屏幕。代码是 ABC 234。把它命名为 Devices TV。
- 智能体
配对完成。Devices TV 显示 PAIRING COMPLETED 并已在线。
- 你
放一个包含两条消息的看板。今晚：下午 5 点开放日，五点开门，咖啡和参观从前台开始。本周：休息室提供免费 Wi-Fi，网络名称请到前台询问。
- 智能体
完成。Devices TV 正在显示看板，先是开放日，然后是 Wi-Fi 消息。我发布后大约两秒它就出现在屏幕上，我也检查过截图。
智能体可以把什么放到电视上？
| 内容 | 智能体做什么 |
|---|---|
| 海报、菜单或欢迎看板 | 按屏幕的尺寸和用途来设计，或者用你的信息填充 200+ 款现成应用中的一款 |
| 你的照片和视频 | 转换并上传。视频先下载，再从设备自身存储播放，所以不会缓冲 |
| 表格、日历或仪表板 | 用自己的访问权限读取，并把行内容放到屏幕上。参见电视上的 Google 表格和电视上的仪表板 |
| 一个网站 | 让页面保持在屏幕上打开。参见全天候在电视上显示网站 |
| 实时摄像头或直播流 | 在每个播放器上播放 HLS 流，在 Android 和 Amazon Signage Stick 上播放实时 IP 摄像头 |
| 触摸自助终端 | 编写一个小应用并放到屏幕上。参见自助终端软件 |
第一块屏幕运行起来后，智能体还能做什么？
- 设置排程。早上显示早餐，九点以后显示打烊通知，各按屏幕自己的时间。
- 一次接管多块屏幕。给屏幕打上标签，然后一个请求就能在所有带该标签的屏幕上放置 30 分钟的消防演习通知。之后每块屏幕自行恢复到它的排程。
- 检查屏幕画面。它向一块屏幕索取截图，或向每块带标签的屏幕各索取一张，先查看再汇报。
- 发现掉线的屏幕。屏幕在 60 秒后算作离线，事件可以唤醒你的智能体去检查。
- 保持内容最新。要求一个例行任务，数据变化时智能体就会更改屏幕。像 ChatGPT dot 这样一直在线的智能体，无需你的电脑也能持续这样做。
- 等待你的批准。开启“要求智能体更改需审核”，或以“提议”访问级别让智能体登录。它仍会准备好一切，但在有人批准之前，什么都不会到达屏幕。
我们在真实运行中计时的结果
每一行都引自包含整个运行过程的页面。内容为演示内容，运行使用的是测试屏幕：用浏览器窗口中的播放器代替电视。
| 智能体做了什么 | 我们看到了什么 | 完整的运行记录 |
|---|---|---|
| 发布了一个两条消息的看板 | 发布约两秒后出现在屏幕上，并已检查截图 | 上面的会话 |
| 注册了账户并配对了一台电视，然后制作了一个“营业中”标牌 | 制作标牌并看到它播放，大约用了五秒 | 免费数字标牌 |
| 从表格发送了一行已更改的数据 | 电视在两秒多一点之后显示了它 | 电视上的 Google 表格 |
| 用演习通知接管了走廊屏幕 | 说完那句话两秒后出现在屏幕上，演习结束那句话说完四秒后解除警报 | 学校 |
我应该了解哪些限制？
- 播放器必须在运行，且位于驱动屏幕的设备上。你的智能体从它运行的任何地方发布，屏幕播放它。
- 智能体必须能运行命令。如果你的助手只是一个没有 shell 的聊天窗口，请问它缺少什么能力，或者改用上面列表中的一个。
- Apple TV 可播放图像、视频、直播流和现成应用。网页和你自己的应用需要其他播放器。播放器页面有完整对照表。
- 你的智能体的登录和你的 screenRIG 项目是分开的。智能体从不需要你的 screenRIG 密码。
- 有些网站拒绝在屏幕上显示。你的智能体会在放上网站之前检查，因为截图无法显示这一点。
不是聊天助手？
脚本、CI 任务或你自己的服务不用聊天也能做同样的事。它通过 API、命令行工具或浏览器 SDK 调用同样的操作。以编程方式向电视发布内容展示了对话和脚本，开发者页面列出了所有接入方式。
常见问题
ChatGPT、Claude 或 Gemini 能控制电视吗？
可以，都需要通过一个能运行官方插件的智能体。ChatGPT 通过 ChatGPT dots 或 Codex，Claude 通过 Claude Code，Gemini 通过 Spark。Grok 通过 Grok Bot 或 Grok Build 工作。
我需要特殊的电视吗？
不需要。任何能运行播放器的屏幕都可以，下载页面列出了各设备的播放器。内置 Google TV 或 Android TV 的电视可从 Google Play 安装，任何带现代浏览器的电视都能打开网页播放器。
我的智能体需要我的密码吗？
不需要。它用自己的凭据登录 screenRIG。读取表格或日历时，它使用你授予的访问权限，只有屏幕上的内容会发送到电视。
我能在更改到达屏幕之前批准吗？
可以。开启审核后，智能体会准备好每项更改并给你一个链接，在你于控制台批准之前，什么都不会播放。
我怎么知道内容正在播放？
发布会等待播放器报告新的播放列表，最长两分钟，并说明它是否正在播放。你的智能体还可以向屏幕索取截图并查看。人也仍然可以到现场看屏幕。
智能体能运行不止一块屏幕吗？
可以。给屏幕打上标签，一个请求就能更改、排程或接管所有带该标签的屏幕，答复会报告每块屏幕各自的结果。
费用是多少？
screenRIG 免费，屏幕数量不限。付费套餐增加商务工具、更多成员、专人沟通、治理和合同条款。参见定价。