5.4 QLab 控制 ASM 与观众端同步 (测试版)

这个 Beta 工作流程做什么

此工作流程将 SurtitleLive 保留为剧本、翻译、部署、控制台和 Viewer 系统。QLab 则成为演出期间字幕提示的控制界面。

• QLab 本地显示导入的字幕文本提示，使投影电脑拥有 QLab 原生字幕备份。
• 启用时，每个 SurtitleLive 字幕组（Group）也可以通知控制台跳转至对应的已部署提示。
• 控制台接着将正常的 SurtitleLive 提示状态发布至 Viewer 链接与观众手机。
• 这不是第二条部署路径。它使用的是现有的已部署演出、控制台链接和 Viewer 链接。

在 SurtitleLive 准备字幕

1. 在 Editor 中完成剧本编辑、翻译与字幕审阅。
2. 使用 模拟（Simulation） 确认提示顺序和语言。
3. 通过 Go Live 部署演出。
4. 在 Deployment Cockpit 中打开已部署的演出。

启用控制并下载导入包

1. 在 Deployment Cockpit 中，于观众与工作人员材料之后找到 QLab Cloud Sync 面板。
2. 开启 在 SurtitleLive 控制台启用 QLab 控制。这不会改变控制台链接、QR 码、复制或打开动作。
3. 下载该已部署演出的 QLab Projection Pack。
4. Beta 版 Deployment Cockpit pack 会使用已部署演出的默认值：单一已部署字幕语言、中置字幕、隐藏角色名称，并跳过舞台指示。
5. 在更新现场字幕（Update Live）或重新部署后，请下载全新的 QLab Projection Pack，以便 QLab 与控制台使用相同的已部署字幕来源。
6. 在将运行 QLab 的 Mac 电脑上下载该导入包。请注意，该 Mac 电脑必须先安装 Node.js (18 或更新版本) 以便运行桥接辅助程序。

导入 QLab 导入包

1. 在 QLab Mac 上解压缩导入包。
2. 打开您的 QLab 5 工作区。
3. 运行 import-into-qlab5.applescript 并选择 surtitlelive-qlab-cues.json。

导入套件结构与规范

• 已部署演出的导入包会将 SurtitleLive 字幕导入为 QLab 组（Groups）。每个组包含一个用于本地投影的 Text 子提示，以及一个将非机密提示识别发送至本地桥接器的 Script 子提示。
• 如果您稍后导入修正后的导入包，相符的 SurtitleLive 字幕组会通过稳定的提示键（cue key）进行更新，而非重复建立。
• 将整个 SurtitleLive 字幕组移动到主 QLab 节目清单中应该出现这些字幕的位置。
• 在 SurtitleLive 字幕组之前、之后或之间新增音效、灯光、视频、准备（standby）、等待（wait）、暂停（pause）或其他 QLab 提示。
• 保持每个 SurtitleLive 组的完整性。请勿将 Text 子提示与 Script 子提示分离，除非您刻意要让该字幕停止同步控制台与 Viewer。

将 QLab 连接至控制台

1. 从 Deployment Cockpit 中正常的 ASM Console 链接打开 SurtitleLive 控制台，并使用操作员密码解锁。
2. 在 QLab Mac 上启动 SurtitleLive Bridge Helper.app。
3. 在控制台中，点击 Connect local bridge 连接本地桥接器。
4. 确认控制台显示桥接辅助程序已连接且 Viewer 同步已就绪。
5. 点击 Allow QLab control 允许 QLab 控制。控制台会将移动 Viewer 和投影输出切换为提示对提示替换，因此当下一个 QLab 字幕提示触发时，前一个字幕便会消失。
6. 运行一个 QLab 字幕提示，以验证 QLab 提示输入是否已到达控制台。

演出前进行排练

• 从 QLab 运行一个早期的字幕，确认 QLab 投影、控制台目前提示和 Viewer 字幕皆相符。
• 确认当下一个 QLab 字幕提示出现时，前一个字幕会消失。
• 直接从 QLab 运行一个中间的字幕，而不仅仅是下一个提示。
• 跳转至错误的字幕，然后从 QLab 进行修正，并确认控制台和 Viewer 皆遵循修正后的提示。
• 如果您的演出使用 QLab 黑屏（blackout）、暂停（pause）、等待（wait）或准备（standby）提示，请将这些作为您自己的 QLab 提示进行测试。SurtitleLive beta 导入包不会新增额外的黑屏、准备、测试卡、备忘或最终清除提示。
• 若有任何检查失败，请点击 Stop QLab control 停用 QLab 控制，并使用控制台手动控制或仅限 QLab 本地投影作为备用方案。

如果导出后字幕有所变更

• 在 SurtitleLive 中进行字幕修改并保存 Editor。
• 根据您的现场工作流，使用 Update Live Subtitles 或重新部署。
• 从更新后的部署下载全新的 QLab Projection Pack。
• 再次运行导入器。针对同一个 SurtitleLive 提示的文本编辑会直接原地更新对应的 QLab 组。新的 SurtitleLive 提示会尽可能插入在上一个 SurtitleLive 组之后，而移除的字幕会被标记为已移除，而非直接删除。
• 如果提示顺序、行 ID、提示编号或提示类型发生变更，作用中的控制台来源识别可能会改变。旧的 QLab Projection Pack 会被刻意拒绝，直到导入最新包为止。
• 重新导入后，请在演出前检查周围的任何音效、灯光、视频、等待或准备提示。

安全边界

• QLab Projection Pack 不包含 SurtitleLive 密码、运行时令牌（runtime tokens）或管理员凭据。
• 如果网络中断，QLab 本地投影仍可继续，因为 Text 提示存在于 QLab 工作区中。
• 移动 Viewer 同步仍需要控制台、本地桥接器和 SurtitleLive 运行时控制连线。
• 本地桥接器仅将已 allowed 的提示跳转从 QLab 转发到演出 Mac 上的控制台。它监听于本机回环 localhost，而非公开网络接口。
• 直接浏览器 Web MIDI 并非此 Beta 的剧场路径。请使用本地桥接器工作流。
• 只有在 Deployment Cockpit 启用 QLab 控制，且操作员在 SurtitleLive 控制台连接并允许 QLab 控制后，控制台才会准备 QLab 同步时间轴。
• QLab 连接状态并非观众手机正在接收字幕的证明。请务必在演出前测试真实的 Viewer 链接。