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

此测试版工作流程的作用

此工作流程让 SurtitleLive 继续负责剧本、翻译、部署、演出控制台和观众手机字幕；QLab 则负责演出期间的字幕提示控制。

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

在 SurtitleLive 准备字幕

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

启用 QLab Cloud Sync 并下载套件

1. 在 Deployment Cockpit 中，于观众与工作人员材料之后找到 QLab Cloud Sync 面板。
2. 开启 在 SurtitleLive 控制台启用 QLab 控制。这不会改变控制台链接、QR 码、复制或打开动作。
3. 下载该已部署演出的 QLab Projection Pack。
4. 测试版 Deployment Cockpit 套件会使用已部署演出的默认值：单一已部署字幕语言、字幕置中、隐藏角色名称，并跳过舞台指示。
5. 更新现场字幕或重新部署后，请下载新的 QLab Projection Pack，确保 QLab 与 ASM 使用同一份已部署字幕来源。
6. 请在将运行 QLab 的 Mac 上下载套件。QLab Script cue 需要任何类型的 QLab 授权；该 Mac 还必须安装 Node.js 18 或更高版本，才能运行桥接辅助程序。

导入 QLab 导入包

1. 在 QLab Mac 上解压缩导入包。
2. 打开您的 QLab 5 工作区。
3. 运行 2a - Import into QLab.applescript，然后选择 2b - QLab Cue Data.json。
4. 双击 3 - Start Local Bridge.command 并保持终端窗口开启。打开并解锁普通 ASM Console，点击右下角的 QLab enabled，再点击 Connect local bridge；如有提示，请允许本地网络访问，等待 Viewer sync ready，然后点击 Allow QLab control。

导入套件结构与规范

• 已部署演出的套件会将 SurtitleLive 字幕导入为 QLab 组。每个组包含一个或多个用于本地投影的 Text 子提示，以及一个将非机密提示识别发送至本地桥接器的 Script 子提示。
• 如果选择多种语言或多个屏幕，请将它们保留在同一个 SurtitleLive 组中；它们属于同一个字幕提示，而不是不同的演出时刻。同屏语言应使用不同的 Text 子提示，并分别放在上方、中间或下方。
• 如果将舞台指示作为 Text cue 导入，它们也会成为普通的 SurtitleLive 组，可在本地投影并同步到观众手机，适合无障碍字幕。备忘 cue 不支持同步。
• 如果您稍后导入修正后的导入包，相符的 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 连接本地桥接器。如果端口 37621 已被占用，请勿在 QLab 中更改端口，也不要启动第二个桥接器。
4. 确认控制台显示桥接辅助程序已连接且 Viewer 同步已就绪。
5. 点击 Allow QLab control 允许 QLab 控制。控制台会将移动 Viewer 和投影输出切换为逐提示替换，因此当下一个 QLab 字幕提示触发时，前一个字幕便会消失；QLab 控制期间，ASM 的移动字幕显示切换会锁定。
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 cue 的文字修改会原位更新对应的 QLab 组及其 Text 子提示，并保留原有 cue key。新的 SurtitleLive cue 会尽可能插入在上一个组之后，而移除的字幕会被标记为已移除，而非直接删除。
• 如果提示顺序、行 ID、提示编号或提示类型发生变更，作用中的控制台来源识别可能会改变。旧的 QLab Projection Pack 会被刻意拒绝，直到导入最新包为止。
• 重新导入后，请在演出前检查周围的任何音效、灯光、视频、等待或准备提示。

安全边界

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