大屏遥控

大屏遥控 是课堂评价现场的 导播台：在不进入编辑器的前提下，远程切换投屏页面、聚焦选手、控制倒计时、刷新排行榜、揭晓 Top3、切换扫码通道等。操作经 SSE 实时同步 到预览页与公开发布页。

入口

遥控 不进侧栏菜单。从 评价活动列表 行操作遥控，或活动 详情 / 概览 顶栏 遥控大屏 进入（须已关联大屏）。

前提条件

条件	说明
活动已发布	有 API Key 与评委凭证
已创建并关联大屏	一键建屏或手动关联
有 eval:read	可进入遥控页
切页/焦点/生命周期操作	须 eval:manage 且活动行 canManage
保存活动设置	须 eval:update

投屏端请使用 预览大屏 或 发布公开链接；编辑器内不会持续刷新评价数据。

页面布局（三 Tab）

┌──────────────────────────────────────────────────┐
│ 顶栏：活动名 | SSE 连接状态 | 打开投屏预览          │
├──────────────────────────────────────────────────┤
│ [ 现场遥控 ] [ 对象与评委 ] [ 活动设置 ]            │
├──────────────────────────────────────────────────┤
│  Tab 内容区                                       │
│  现场遥控：切页大按钮、焦点列表、倒计时、生命周期…    │
└──────────────────────────────────────────────────┘

Tab	作用
现场遥控	切页、定焦点、刷新榜、揭晓、扫码通道、倒计时、活动开始/暂停/结束
对象与评委	与活动详情相同，现场增删改对象/评委、CSV、二维码
活动设置	与活动详情相同，改时间、环节名、维度等（权限与锁定规则一致）

现场遥控 Tab

关联大屏页面切换

展示已关联大屏的 页面列表（大按钮）。点击某页：

写入 config.remote.pageKey
经 SSE 事件 remote 推送到所有订阅端
预览 / 发布页立即切页

优先级

当遥控设置了 pageKey 时，其优先级高于三页叙事按活动状态自动切到「进行中」页的逻辑。现场导播以遥控为准。

定焦点（评分对象）

评分对象列表 中点击某对象：

写入 focusTargetId
联动大屏上 聚光灯、雷达图 等读取 evalTargetId 的组件
排行榜行点击联动与遥控焦点 效果一致

适合答辩现场「当前答辩组」聚焦展示。

刷新排行榜

触发一次 全量排名重算 并推送 snapshot，大屏排行榜组件即时更新。用于怀疑缓存不一致或需要强制同步时。

揭晓 Top3

选择 揭晓目标页（通常为颁奖/揭晓页）
点 揭晓 Top3
设置 revealPodiumAt 等状态，颁奖台/聚光灯组件播放悬念升起特效

可与三页 preset 的 eval_finale 页配合使用。

扫码通道切换

控制 扫码打分 组件（evalQrPanel）生成的 H5 入口域名：

通道	典型用途
primary	主域名（默认）
backup	备用域名
lan	内网/局域网域名

切换后二维码 即时重绘，无需改大屏 JSON。

答辩倒计时遥控

与大屏 答辩倒计时 组件（evalCountdown）同步：

操作	说明
暂停 / 继续	冻结或恢复倒计时
重置	回到初始状态
+30s / +1min	现场加时

状态经 SSE 事件 countdown 推送；断线重连后会 replay 最近状态。

与自动切页

候场页倒计时结束 不会单独 触发切页；通常需配合 事件链（活动进入进行中/已结束 + 顶栏状态文案）或导播 手动切页。详见评价大屏与组件。

评委列表与二维码

现场 Tab 展示评委 实时打分进度；行内可打开 二维码 发给迟到的评委。

评分规则摘要

只读展示当前维度与 角色权重，便于导播核对规则。

活动生命周期（底栏）

按钮	作用
开始	进入进行中，允许 H5 打分
暂停	禁止打分，大屏停止实时刷新
恢复	回到进行中
结束	冻结排名，推送结束态

操作前均有二次确认。

顶栏

打开投屏预览：新标签打开关联大屏预览
SSE 连接状态：绿/红指示；断线时预览端会按 refreshInterval 降级轮询

投屏端如何消费遥控

预览页与公开发布页（/preview/:id、/p/:token）会：

订阅评价 SSE
监听 remote、countdown 事件
应用 pageKey、focusTargetId、hostChannel 等
刷新时从 summary 响应恢复 remote 状态

因此导播在遥控页切页后，墙上投屏 无需刷新浏览器 即可跟随（SSE 正常时）。

SSE 事件与遥控的关系

事件	遥控相关字段	消费方
remote	pageKey, focusTargetId, hostChannel, rankRefreshAt, revealPodiumAt	预览/发布切页、焦点、扫码、揭晓
countdown	暂停、剩余秒、截止时间	遥控页 + evalCountdown
summary	remote 快照、截止时间、环节名	头图、倒计时、刷新恢复
snapshot	rankings, progress, judgeStatus, tags	排行榜、评委展示、词云
score	增量打分、rank/prevRank	动态、评语墙、打分弹条
progress	活动 lifecycle	进度条、进度环、头图状态

三页叙事 preset

一键建屏默认三页：

pageKey	场景
`eval_lobby`	候场
`eval_live`	进行中
`eval_finale`	揭晓

模板类型可能使用 defenseThreePages（答辩）、roadshowThreePages（路演）、mutualEvalThreePages（互评）等 preset。

无遥控 pageKey 时，活动 进行中 可能自动切到 live 页
有遥控 pageKey 时，以遥控为准

权限与协作

角色	能否遥控
活动负责人 / 可管理成员	是（须功能权限）
仅查看协作成员	否
大屏协作者（非活动成员）	可编辑大屏，但不能进活动遥控（无 eval 管理权）

常见问题

现象	处理
切页后投屏没变	看 SSE 是否连接；刷新预览页；确认打开的是预览/发布而非编辑器
焦点不对	确认聚光灯/雷达开启「跟随联动」；检查 focusTargetId
二维码扫错环境	切换扫码通道 primary/backup/lan
倒计时不一致	看 countdown 事件；遥控与组件是否绑定同一活动
找不到遥控按钮	须已关联大屏；列表行需 canManage

更多见课堂评价总览 · 常见问题。

大屏遥控 ​

前提条件 ​

页面布局（三 Tab） ​

现场遥控 Tab ​

关联大屏页面切换 ​

定焦点（评分对象） ​

刷新排行榜 ​

揭晓 Top3 ​

扫码通道切换 ​

答辩倒计时遥控 ​

评委列表与二维码 ​

评分规则摘要 ​

活动生命周期（底栏） ​

顶栏 ​

投屏端如何消费遥控 ​

SSE 事件与遥控的关系 ​

三页叙事 preset ​

权限与协作 ​

常见问题 ​

相关文档 ​