Skip to content

打开 Access Gateway 操作台

在 Timers Studio 中打开 AccessGateway 操作台、在 Monitor、Stage、Tombola、Polls 之间切换，并读取在线观众与待处理提问的实时计数。

最近更新

打开 Access Gateway 操作台

AccessGateway 是制作团队眼中的 Gateway 模块。它是嵌入 Studio 的分标签工作区，让你在一个地方就能照看全场、调整座位图、组织抽奖和主导实时投票。本页带你在两分钟内打开它并找到方向。

前提

  • 已创建的 Timers Studio 房间（controllers 表中已有 controller_id）
  • Studio 已打开在 timers.studio/id/<你的房间>
  • 有至少一位观众能帮助你看到计数变动，但打开工作区本身不需要

步骤

1. 在你的房间中打开 Studio

访问 timers.studio/id/<你的房间>。Studio 加载后会在 controllers 表中解析你的房间。如果 slug 写错，会先命中 404，Gateway 还来不及挂载。

2. 打开 Gateway 工作区

在 Studio 左侧栏点击 Gateway（部分房间标注为 Access）。AccessGateway 挂载在右侧，默认选中 LIVE 标签，因此你首先看到 LiveMonitor。

Gateway 在 Studio 内打开，不会跳转到其他 URL。观众也看不到这个界面——他们只看到 timers.studio/ask/<你的房间>。

3. 读取实时计数

工作区页头显示两个来自 Supabase 的计数：

  • 在线观众 — spectators 表中的行，按 controller_id 过滤，由观众端页面设置 online 标志。
  • 待处理提问 — spatial_questions 中 status = 'pending' 的行，使用相同过滤。

两个计数都订阅了 Realtime 频道。随着观众陆续进场，无需刷新也会自行变化。

4. 切换标签

四个标签覆盖 Gateway 周边的四套工具：

  • LIVE → LiveMonitor。实时显示已连接座位与进入的提问流。先在这里把脉全场。
  • STAGE → StageConfigurator。导播侧的场地图，用于划分区域和校准座位。请在开演前打开，而非演出中。
  • RAFFLE → RaffleControl，复用自 Moderator 模块。选定区域、触发抽奖、宣布获奖者。
  • POLLS → PollManager，复用自 Moderator 模块。创建、打开和关闭观众将在 SpectatorPollVote 看到的投票。

切换标签代价很低——订阅在后台保持，计数和数据不会被重置。

5. 运行抽奖或投票

在 RAFFLE 选择范围（整场或某个区域）并点击 抽奖。获奖者从当前 spectators 行中挑选并展示在屏幕上。

在 POLLS 点击 新建投票，填入选项，然后 打开。所有当前在 timers.studio/ask/<房间> 的手机都会从下方滑出 SpectatorPollVote。投票随时进入 poll_votes；关闭投票后，你可以通过 PollWidget 把结果推到 Player 上。

预期结果

AccessGateway 已在 Studio 中打开，选中 LIVE 标签。页头显示真实计数。切到 RAFFLE 或 POLLS，即可在不离开 Studio 的情况下使用 Moderator 控件。/ask/<房间> 的观众视图保持原样。

故障排查

/ask/<房间> 上明明有人，计数却一直为零。 确认 Studio URL 与观众 URL 的 room ID 完全一致。任何一个 slug 拼错,controller_id 关联就会失败,没有行能匹配。

RAFFLE 或 POLLS 标签是空的。 这些标签复用了 Moderator 的组件。如果你的方案未包含 Moderator 模块,该标签会以禁用态渲染。请切换到启用该模块的方案。

打开了投票，但手机上什么也没出现。 观众手机必须打开与 Studio 相同 room ID 的 timers.studio/ask/<房间>，而不是 Player URL。SpectatorPollVote 只会出现在 Gateway 的观众端。

延伸阅读