启动并控制 Player
打开房间的 Player 视图,从 Studio 的传输栏驱动它,对正在运行的 timer 即时微调,全屏运行或作为 OBS 来源嵌入。
最近更新
启动并控制 Player
Player 是 Timers Studio 的屏幕输出。它就是你的观众、发言人、舞台显示屏读的那个画面。本页教你怎么打开它、从 Studio 控制它、让它适配运行的硬件。
前提条件
- rundown 里至少有一个 timer(见 创建你的第一个 timer)
- 一个打开了
timers.studio/id/<your-room>的浏览器 tab 作为 Studio - 另外一个 tab、窗口或设备作为 Player 本身
步骤
1. 打开 Player 视图
在新浏览器 tab 里打开 timers.studio/player/<your-room>。用和 Studio URL 相同的 room ID。Player 加载后从 Supabase 读取当前房间状态,然后通过 Gateway 通道订阅更新。
Player URL 不需要认证。它就是设计给你分享给发言人、舞台显示屏或 OBS 的 — 任何拿到链接的人都能看到实时时钟。如果你要保护视图,用 Moderator URL。
2. 从 Studio 启动 timer
回到 Studio,看中间列的 ControlPanel。主按钮在 timer 停止时显示 Play,在运行时显示 Pause。点 Play 或按 Space。TimerState 切换到 RUNNING,Player 在 100 ms 内开始计时。
要停止,点红色的 Stop 按钮。要暂停但不重置,再按一次 Space。
3. 微调正在运行的 timer
ControlPanel 还提供四个快速调整按钮:
+1m— 给当前 timer 加 60 秒+30s— 加 30 秒-30s— 减 30 秒-1m— 减 60 秒
每次点击都通过 onAction('TWEAK', <seconds>) 发出一个 TWEAK 动作。Player 接收到新的已用值并立即重新渲染。发言人需要多一分钟、或者你想把 rundown 里的空档补上时就用这个。
4. 在 timer 之间跳转
两个箭头按钮 — Previous 和 Next — 跳到当前 timer 的前一个或后一个。点 rundown 列表里的某一行效果一样。键盘快捷键是 ←(前一个)和 →(后一个)。
Player 始终渲染活动条目。切换索引就是切换屏幕上的内容。
5. 让 Player 全屏
在 Player tab 按 F,或者动一下鼠标,然后点角落控制覆盖层里出现的全屏图标。Player 会隐藏 BrandLogo(Pro 套餐上)、鼠标光标和所有内部 chrome — 你得到一个干净的时钟。
做舞台输出时,你通常想抑制多余的 UI:
?hideTitle=true— 隐藏 timer 标题覆盖?hideMessage=true— 隐藏当前发言人消息?theme=light— 强制浅色主题,不管 Studio 的设置?theme=transparent— 强制深色主题加透明背景(做 OBS 合成时有用)
用 & 组合,例如 timers.studio/player/<your-room>?hideTitle=true&hideMessage=true。
6. 把 Player 嵌入 OBS
在 OBS 添加一个 Browser Source,把 Player URL 粘进去。设置分辨率(1920×1080 或 1280×720 是安全默认),并勾选 Refresh browser when scene becomes active,如果你的节目在片段之间重启流。Player 会自动侦测 Smart TV 和 Console 的 user agent,并缩小到 90% 安全区以避开 overscan — 这个侦测在 OBS 里不会触发,所以默认 100% 布局继续生效。
本地视口控制
Player 暴露了一个小的控制面板,只存在于 Player tab(对 Studio 没有副作用):
- 水平翻转(
flipH) - 垂直翻转(
flipV) - 旋转 0° / 90° / 180° / 270°
- 安全区 — 默认、90%、80%、关闭
当物理屏幕被侧装、倒装,或者你喂给一台会裁切边缘的电视时,用这些。
预期结果
一个 Player tab,一个和 Studio 同步运行的时钟。每一个传输动作(Play、Pause、Stop、Next、Previous、微调)都在 100 ms 内反映到 Player 上。同一个 room ID 上打开的每一个 Player tab,不论什么时候打开,都显示精确到十分之一秒的同一时间。
故障排查
Player 为什么停在 00:00?
Player 在 timerState 不是 RUNNING 时停止计时。检查你在 Studio 按的是 Play,而不是 Pause 或 Stop。timer 在运行时,ControlPanel 按钮会变绿。
Player 需要和 Studio 同一个登录吗? 不需要。Player URL 按设计是公开的 — 任何拿到链接的人都能看到实时时钟。房间密码只保护 Moderator 视图。
怎么隐藏标题或消息覆盖?
在 Player 链接里加 URL 参数:?hideTitle=true 移除 timer 标题,?hideMessage=true 隐藏当前发言人消息。两者可以组合。
能不能让 Player 在竖屏上旋转或翻转?
能。Player 提供本地视口控制(flipH、flipV、rotate、safeArea)。把鼠标悬停到 Player 上,会出现控制面板,然后选方向。这些设置只在当前 tab 生效。