5.4 QLab 控制功能：ASM 與觀眾端同步（測試版）

這個測試 (Beta) 工作流程做什麼

此工作流程讓 SurtitleLive 繼續負責劇本、翻譯、部署、操作主控台與觀眾手機字幕；QLab 則負責演出期間的本機時間軸與字幕提示（Cue）觸發。

• QLab 會在本機播放匯入的字幕文字提示（Text Cue），讓投影電腦保有 QLab 原生的字幕備份。
• 啟用後，每個 SurtitleLive 字幕群組 (Group) 也可以通知 SurtitleLive 控制台跳到對應的已部署提示 (Cue)。
• SurtitleLive 主控台再把正常的提示（Cue）狀態同步到觀眾連結與觀眾手機。
• 這不是第二條部署路徑。它使用既有的已部署演出、控制台連結與觀眾連結。

在 SurtitleLive 準備字幕

1. 在編輯器中完成劇本編輯、翻譯與字幕審閱。
2. 使用 模擬 (Simulation) 確認提示 (Cue) 順序與語言。
3. 透過 Go Live 部署演出。
4. 在 部署控制台 (Deployment Cockpit) 中開啟已部署的演出。

啟用 QLab 控制並下載投影套件

1. 在部署控制台中，於觀眾與前台資料區塊後方找到 QLab Cloud Sync 面板。
2. 開啟 在 SurtitleLive 控制台啟用 QLab 控制。這只是允許 QLab 透過 SurtitleLive 主控台同步觀眾手機字幕，不會改變主控台連結或 QR 碼。
3. 下載該場已部署演出的 QLab 投影套件。
4. 測試版部署控制台套件會使用已部署演出的預設值：單一已部署字幕語言、字幕置中、隱藏角色名稱，並跳過舞台指示。
5. 在 QLab 選項中，請先選擇輸出語言、字幕位置、同一螢幕或分離螢幕、必要時的 QLab 螢幕／舞台名稱、角色名稱顯示，以及舞台指示處理方式。
6. 更新現場字幕或重新部署後，請下載新的 QLab 投影套件，確保 QLab 與 SurtitleLive 主控台使用同一份已部署字幕來源。
7. 請在將會執行 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 主控台，按一下右下角的 QLab enabled，再按一下 Connect local bridge；如有提示，允許本機網路存取，等待 Viewer sync ready，最後按一下 Allow QLab control。

匯入套件結構與規範

• 已部署演出的套件會將 SurtitleLive 字幕匯入為 QLab 群組。每個群組包含一個或多個本機投影用的文字子提示（Text Child Cue），以及一個把非機密提示識別資訊傳送到本機橋接器的腳本子提示（Script Child Cue）。
• 如果選擇多種語言或多個螢幕，請將它們保留在同一個 SurtitleLive 群組內；它們是同一個字幕提示，不是不同的演出時刻。同一螢幕的多種語言應放在不同的 Text child cue，並使用上方／中間／下方的位置。
• 如果將舞台指示匯入為文字 cue，它們也會成為一般的 SurtitleLive 群組，可以在本機投影並同步到觀眾手機，適合無障礙字幕。備忘 cue 不支援同步。
• 如果之後匯入修正版套件 (Pack)，相同的 SurtitleLive 字幕群組 (Group) 會透過穩定提示識別鍵 (Cue Key) 原地更新，而不是重複建立。
• 將整個 SurtitleLive 字幕群組 (Group) 移到主 QLab 演出清單 (Show List) 中實際需要出現的位置。
• 您可以在 SurtitleLive 字幕群組前後或之間加入音效、燈光、影片、待命、等待、暫停或其他 QLab cue。
• 請保持每個 SurtitleLive 群組完整。除非您刻意要讓該字幕停止同步 SurtitleLive 主控台與觀眾手機，否則不要拆開文字子提示（Text Child Cue）與腳本子提示（Script Child Cue）。

將 QLab 連接至 SurtitleLive 控制台

1. 從部署控制台 (Deployment Cockpit) 中正常的 ASM Console 連結開啟 SurtitleLive 控制台，並使用操作員密碼解鎖。
2. 在 QLab Mac 上啟動 SurtitleLive Bridge Helper.app。
3. 在主控台中，按一下 Connect local bridge，連接本機橋接器。若連接埠 37621 已被使用，請勿在 QLab 中更改連接埠，也不要啟動第二個橋接器。
4. 確認主控台顯示橋接輔助程式已連線（bridge helper connected）與觀眾同步就緒（Viewer sync ready）。
5. 按一下 Allow QLab control 允許 QLab 控制。SurtitleLive 主控台會把觀眾手機與投影輸出切換成逐提示取代模式，因此下一個 QLab 字幕提示觸發時，上一則字幕會立即消失；在 QLab 控制期間，ASM 的行動字幕顯示切換會鎖定。
6. 執行一個 QLab 字幕提示 (Cue)，確認 QLab 提示輸入 (Cue Input) 已到達 SurtitleLive 控制台。

演出前進行排練

• 從 QLab 執行一個早段字幕，確認 QLab 投影、控制台目前提示 (Cue) 與觀眾手機字幕都相符。
• 確認下一個 QLab 字幕提示 (Cue) 出現時，上一則字幕會消失。
• 直接從 QLab 執行一個中段字幕，不要只測下一句。
• 先跳到錯誤字幕，再從 QLab 修正，並確認控制台與觀眾手機跟隨修正後的提示 (Cue)。
• 如果您的演出使用 QLab 黑場、暫停、等待或待命 cue，請把它們當作您自己的 QLab cue 進行測試。SurtitleLive 測試套件不會額外加入黑場、待命、測試圖卡、備忘或最後清除 cue。
• 如果任何檢查失敗，請按一下 Stop QLab control 停用 QLab 控制，改用 SurtitleLive 主控台手動操作，或只用 QLab 本機投影作為備援。

如果匯出後字幕有所變更

• 在 SurtitleLive 中修改字幕並儲存編輯器。
• 依照您的現場工作流程，使用 更新現場字幕 或重新部署。
• 從更新後的部署下載新的 QLab 投影套件。
• 再次執行匯入器。同一個 SurtitleLive cue 的文字修改會原地更新對應的 QLab 群組及其文字子提示。新的 SurtitleLive cue 會盡可能插入在上一個群組後方；已移除的字幕會標記為「已移除」，而不是直接刪除。
• 如果 cue 順序、字幕行 ID、cue 編號或 cue 類型有變，目前主控台的來源識別資訊可能會改變。舊的 QLab 投影套件會被刻意拒絕，直到匯入最新版套件。
• 重新匯入後，請在演出前檢查周圍的音效、燈光、影片、等待或待命 cue。

安全邊界

• QLab 投影套件不包含 SurtitleLive 密碼、執行期權杖或管理員憑證。
• 如果網路中斷，QLab 本機投影仍可繼續，因為文字提示（Text Cue）已存在於 QLab 工作區。
• 觀眾手機同步仍需要 SurtitleLive 主控台、本機橋接器與 SurtitleLive 執行期控制保持連線。
• 本機橋接器只會把已允許的提示跳轉從 QLab 轉送到演出 Mac 上的主控台。它只監聽 localhost 回送介面，不是公開網路介面。
• 瀏覽器 Web MIDI 不是這個測試版的劇場使用路徑。請使用本機橋接器工作流程。
• 只有在部署控制台啟用 QLab 控制，且操作員在 SurtitleLive 主控台連接並允許 QLab 控制後，主控台才會準備 QLab 同步時間軸。
• QLab 已連線狀態不代表觀眾手機正在接收字幕。演出前務必測試真實觀眾端連結。