术语表

本页汇集你在 Timers Studio 文档里会遇到的术语。大多数词都一对一对应到一个路由、一个组件或 Supabase 表里的一列,同一个词在产品和文档里指同一件事。

核心概念

Room(房间) 一场 Timers Studio 活动。一个 room 拥有一份 rundown、一个主题、一个 moderator 密码,以及一组公开 URL。用一个在所有 URL 里都出现的短 slug 识别(/id/<room>、/player/<room> 等)。

Rundown 一个 room 里 timer 的有序列表。Studio 在中间列展示它,Moderator 读它,Agenda 呈给观众,Player 一次播一项。

Timer rundown 里的一行。一个 timer 带有标题、可选的副标题和发言人、一个时长,以及一个模式(DURATION、FINISH_TIME、TIME_OF_DAY、COUNT_UP)。

Controller 服务端代表 room 的 Supabase 行(controllers 表)。UUID、studio_slug、player_slug、管理员语言、timer 状态。每一个实时通道都以这个 UUID 为 key。

四个模块

Studio — /id/<room> 导演的控制台。编辑 rundown,驱动 Player,拥有整场演出。需要登录。

Player — /player/<room> 面向舞台的屏幕。一个全屏倒计时加可选的覆盖层。公开,不登录。

Moderator — /moderator/<room> 给第二个操作员(主持人、现场指挥)的后台工作区。可自定义的 widget 网格、intercom、实时计数。每个 room 密码保护。

Agenda — /agenda/<room> 面向观众的日程。只读,三种显示模式(LIST、FOCUS、CURRENT_NEXT)。不登录。

Gateway — /ask/<room> + 嵌入 Studio 同一个模块的两面。/ask/<room> 路由是观众提交问题或投票的公开表单。Studio 里的操作员工作区 tab 打开 LiveMonitor、StageConfigurator、Tombola 和 Polls。

Timer 状态和模式

TimerState STOPPED、RUNNING、PAUSED 三者之一。房间里每一个 Player 在 100 ms 内反映变更。

DURATION 从你设定的长度开始倒数(例如 10:00 表示十分钟)。

FINISH_TIME 倒数到你设定的钟表时刻(例如本地 14:30)。

TIME_OF_DAY 显示当前本地时间的现场时钟,而不是倒计时。

COUNT_UP 从 00:00 开始正计时的秒表。

Tweak 对正在运行的 timer 做的实时调整(+1m、+30s、-30s、-1m)。Studio 发出,Player 实时接收。

路由和 URL

你会遇到的 Supabase 表

controllers — room 本身(UUID、slug、timer 状态、管理员语言)。

spectators — 给定 room 打开过 /ask/<room> 的人(姓、名、可选座位、浏览器指纹)。

spatial_questions — 观众提交的问题(status: pending、approved、answered、rejected,情感,可选座位向量)。

polls — 从 Moderator 创建的直播投票(status: draft、active、closed)。

poll_votes — 每一票一行。每个指纹每次投票只能投一次。

显示和主题

Theme(主题) 颜色 token、字体、毛玻璃效果、背景。应用到 Player 和 Agenda。从 Studio 的 customiser 里编辑。

Display mode(Agenda) LIST、FOCUS、CURRENT_NEXT 三者之一。由操作员切换,观众侧无需刷新即跟随。

Safe area 施加在 Player 上的视口内缩,用来避免电视的 overscan。默认、90%、80%、关闭。

实时

Channel 以 controller UUID 为 key 的 Supabase 实时通道。同一个 room 里的 Studio、Player、Moderator、Agenda、Gateway 页面都订阅同一个通道。

延迟包络 Studio 中一个动作到它在 Player 上可见的目标延迟。Timers Studio 端到端目标是 ≤ 100 ms。

下一步阅读

• Quickstart — 五分钟做一场演出。
• 创建你的第一个 timer — 试点教程。
• 键盘快捷键 — 完整地图。