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

此测试版工作流程的作用

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

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

在 Pockitle Cue 准备字幕

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

启用 QLab Cloud Sync 并下载套件

1. 在 Deployment Cockpit 中，于观众与工作人员材料之后找到 QLab 云同步 面板。
2. 开启 在 Pockitle Cue 控制台启用 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，点击 开始演出，等待 Cloud publish: Ready。然后打开右下角的 QLab enabled，点击 Connect local bridge；如有提示，请允许本地网络访问。等待 Bridge helper: Connected，再点击 Allow QLab control。

导入套件结构与规范

• 已部署演出的套件会将 Pockitle Cue 字幕导入为 QLab 组。每个组包含一个或多个用于本地投影的 Text 子提示，以及一个将非机密提示识别发送至本地桥接器的 Script 子提示。
• 如果选择多种语言或多个屏幕，请将它们保留在同一个 Pockitle Cue 组中；它们属于同一个字幕提示，而不是不同的演出时刻。同屏语言应使用不同的 Text 子提示，并分别放在上方、中间或下方。
• 如果将舞台指示作为 Text cue 导入，它们也会成为普通的 Pockitle Cue 组，可在本地投影并同步到观众手机，适合无障碍字幕。备忘 cue 不支持同步。
• 如果您稍后导入修正后的导入包，相符的 Pockitle Cue 字幕组会通过稳定的提示键（cue key）进行更新，而非重复建立。
• 将整个 Pockitle Cue 字幕组移动到主 QLab 节目清单中应该出现这些字幕的位置。
• 在 Pockitle Cue 字幕组之前、之后或之间新增音效、灯光、视频、准备（standby）、等待（wait）、暂停（pause）或其他 QLab 提示。
• 保持每个 Pockitle Cue 组的完整性。请勿将 Text 子提示与 Script 子提示分离，除非您刻意要让该字幕停止同步控制台与 Viewer。

将 QLab 连接至控制台

1. 从 Deployment Cockpit 中正常的 ASM 控制台 链接打开 Pockitle Cue 控制台，并使用操作员密码解锁。
2. 在 QLab Mac 上运行 3 - Start Local Bridge.command。
3. 在控制台中，点击 Connect local bridge 连接本地桥接器。如果端口 37621 已被占用，请勿在 QLab 中更改端口，也不要启动第二个桥接器。
4. 允许 QLab 控制前，请确认 ASM Console 显示 Bridge helper: Connected 和 Cloud publish: Ready。
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 提示进行测试。Pockitle Cue beta 导入包不会新增额外的黑屏、准备、测试卡、备忘或最终清除提示。
• 若有任何检查失败，请点击 Stop QLab control 停用 QLab 控制，并使用控制台手动控制或仅限 QLab 本地投影作为备用方案。

如果导出后字幕有所变更

• 在 Pockitle Cue 中进行字幕修改并保存 Editor。
• 根据您的现场工作流，使用 Update Live Subtitles 或重新部署。
• 从更新后的部署下载全新的 QLab Projection Pack。
• 再次运行导入器。同一 Pockitle Cue cue 的文字修改会原位更新对应的 QLab 组及其 Text 子提示，并保留原有 cue key。新的 Pockitle Cue cue 会尽可能插入在上一个组之后，而移除的字幕会被标记为已移除，而非直接删除。
• 只改文字不会改变 QLab 来源标识：旧包仍可能同步 ASM，但 QLab 会显示旧文字。改变 cue 顺序、行 ID、编号或类型会改变标识，旧包事件便无法送达 ASM。每次更新后都要重新导入最新包，并一起核对 QLab、ASM 和 Viewer。
• 重新导入后，请在演出前检查周围的任何音效、灯光、视频、等待或准备提示。

安全边界

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