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

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

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

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

在 Pockitle Cue 準備字幕

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

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

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

匯入套件結構與規範

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

將 QLab 連接至 Pockitle Cue 控制台

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

演出前進行排練

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

如果匯出後字幕有所變更

• 在 Pockitle Cue 中修改字幕並儲存編輯器。
• 依照您的現場工作流程，使用 更新現場字幕 或重新部署。
• 從更新後的部署下載新的 QLab 投影套件。
• 再次執行匯入器。同一個 Pockitle Cue cue 的文字修改會原地更新對應的 QLab 群組及其文字子提示。新的 Pockitle Cue cue 會盡可能插入在上一個群組後方；已移除的字幕會標記為「已移除」，而不是直接刪除。
• 只改文字不會改變 QLab 來源識別：舊套件仍可能同步 ASM，但 QLab 會顯示舊文字。改變 cue 順序、字幕行 ID、編號或類型會改變識別，舊套件事件便無法送達 ASM。每次更新後都要重新匯入最新版套件，並一起核對 QLab、ASM 與 Viewer。
• 重新匯入後，請在演出前檢查周圍的音效、燈光、影片、等待或待命 cue。

安全邊界

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