Moderator 模块总览

Moderator 模块是演出时的第二双手。导播从 Studio 推进 rundown；moderator 看到同样的舞台输出，可以转达信息、发起 poll、呼叫讲者，或与导播私聊 — 而不需要触碰主要的 timer 控制。本页介绍 /moderator/<room> 上会看到什么、模块如何与 Timers Studio 的其余部分对话、以及 moderator 能做和不能做什么。

一条路由，一个房间

模块由一个 URL 提供：

• timers.studio/moderator/<room> — 打开由 ModeratorPlayerView 渲染的 moderator player。房间 ID 与导播 Studio (/id/<room>) 和公开 Player (/player/<room>) 使用的 ID 相同。

moderator 从不看到导播的传输栏。它看到观众所看到的，加上边上的一组小组件用于处理其 moderation 任务。

登录后看到什么

ModeratorLoginView 会要求输入会话密码，该密码由导播在 Links 模态中设置。验证通过后，moderator 进入一个两区布局：

• 主区 — Player 镜像。公开 Player 的像素级复制：来自同一实时状态的 TimerDisplay 或 AgendaPlayerView。当导播启动一个 timer 时，moderator 看到计时器与舞台同毫秒地走动。
• 小组件区 — Moderation 工具。由 DynamicWidgetGrid 渲染的网格，最多可容纳九个小组件：timer、agenda、agenda_focus、intercom、visual_pager、wharton、qa_push、qa_radar、poll。由导播决定哪些可见、按何顺序排列。

与导播交流

moderator 和导播共享一个私有 intercom，由 ModeratorIntercomChat 渲染。消息存储于 Supabase 表 moderator_intercom，并实时推送到两端。intercom 支持：

• 纯文本和表情。
• Emojicons — 代表重复概念的小图标（[TIMER]、[MODERATOR]、[TECH_ISSUE] 等）。
• 闪烁信号（闪电按钮）— 让对方的输入框持续闪烁，直到其中一方回复。
• 输入指示器和送达回执。

发起一次实时投票

投票是 moderator 的主要输出工具。三个组件构成完整闭环：

• PollModeratorWidget（moderator 端）— 创建、启动、关闭、推送结果。
• SpectatorPollVote（观众端，在 /ask/<room>）— 观众选择一个选项。
• PollWidget（player 端，在 /player/<room>）— 舞台覆盖层，当 moderator 点击 Push Results 后显示结果条。

详细步骤见 发起一次实时投票。

相关模块

• Timers — /id/<room> 的导播 Studio 是 rundown 与 timer 状态的唯一真相。moderator 只接收 Studio 推送的内容。
• Agenda — 导播播放 agenda 时，moderator 的镜像渲染 AgendaPlayerView。
• Gateway — 观众到达 /ask/<room> 为 moderator 发起的投票投票。Gateway 同时承载所有视图之间的实时更新。

范围边界

moderator 可以驱动 moderation 任务 — intercom、投票、visual pager、Q&A push。不能编辑 rundown、修改 timer、或在 Timer 视图与 Agenda 视图之间切换：这些仍在导播的 Studio 中。如果需要两个人同时操作 timer 本身，两人都用 director 链接打开 /id/<room>。

下一步阅读

• Moderator 登录与访问 — 密码机制，以及被拒绝时怎么办。
• 小组件网格与布局 — 选择、重排、缩放九个小组件。
• 与导播的 intercom — 发送消息、对导播闪烁、使用 emojicon。
• 发起一次实时投票 — 创建投票、启动投票、将结果推送到舞台。