Can I use this beta sync pack before deployment?

No. The sync pack belongs to a deployed show. Before deployment, use the Editor QLab import pack for offline projection only.

What does QLab control when this is armed?

QLab projects its local Text cues and sends armed cue jumps through the local bridge to the already-open SurtitleLive live console. SurtitleLive Cloud then publishes the normal cue state to Viewer links and audience phones.

Does enabling QLab control create a new ASM link?

No. Deployment Cockpit keeps the same ASM link, QR code, Copy, and Open actions. The toggle only allows the already-open ASM Console to connect and arm the local QLab bridge.

Can I add sound, light, video, or standby cues in QLab?

Yes. Add them before, after, or between whole SurtitleLive subtitle Groups. Keep each SurtitleLive Group intact so all language/screen Text child cues and the sync Script child stay together. Later QLab Projection Pack imports update matching SurtitleLive Groups by stable cue key and do not delete your other QLab cues.

What happens if the venue network drops?

QLab local projection can continue because the Text cues are inside the QLab workspace. Mobile Viewer sync still needs ASM, the local bridge, and SurtitleLive runtime control to be connected.

5.4 ASM 및 Viewer 동기화를 위한 QLab 제어 (베타) | SurtitleLive Guides

베타 버전

용도: QLab이 자막 Text cue를 현장에서 투사하는 동시에, 관객 휴대폰의 Viewer 자막에 전달할 SurtitleLive 라이브 cue 상태를 제어하도록 합니다.

중요: 먼저 공연을 배포하세요. 배포 전 QLab에서는 QLab 가져오기 팩 내보내기에 설명된 Editor 오프라인 내보내기만 사용할 수 있습니다.

이 베타 작업 흐름의 역할

이 작업 흐름에서도 대본, 번역, 배포, 공연 중 제어, 관객 휴대폰 전송은 SurtitleLive가 담당합니다. QLab은 공연 중 자막 cue를 제어하는 화면이 됩니다.

QLab에서 가져온 자막 Text cue가 로컬로 표시되므로, 프로젝터 컴퓨터에 QLab 기반 자막 백업이 남습니다.
QLab 제어를 허용하면 각 SurtitleLive 자막 Group이 SurtitleLive Cloud에 해당 배포 cue로 이동하도록 알립니다.
이미 열려 있는 SurtitleLive 라이브 콘솔은 일반 cue 상태를 Viewer 링크와 관객 휴대폰에 전달합니다.
이는 별도의 배포 경로가 아닙니다. 이미 배포된 공연, 기존 ASM 링크와 기존 Viewer 링크를 그대로 사용합니다.

SurtitleLive에서 자막 준비하기

Editor에서 대본 편집, 번역 및 자막 검토를 완료합니다.
큐 순서 및 언어를 확인하기 위해 시뮬레이션(Simulation)을 사용합니다.
Go Live를 통해 공연을 배포합니다.
Deployment Cockpit에서 배포된 공연을 엽니다.

QLab Cloud Sync 활성화 및 팩 다운로드

Deployment Cockpit에서 Front-of-House Materials 아래에 있는 QLab Cloud Sync 패널을 찾습니다.
SurtitleLive 콘솔에서 QLab 제어 활성화를 켭니다. ASM 링크, QR 코드, Copy 또는 Open 동작은 변경되지 않습니다.
배포된 공연의 QLab Projection Pack을 다운로드합니다.
다운로드 전에 QLab 옵션 대화상자에서 언어, 자막 위치, 같은 화면 또는 별도 화면 출력, 필요한 경우 QLab 화면/무대 이름, 등장인물 이름 표시, 무대 지시 처리 방식을 선택합니다.
베타 버전의 기본값은 공연에 안전하도록 등장인물 이름을 숨기고 무대 지시를 건너뜁니다. 필요한 경우에만 직접 포함하세요.
Update Live 또는 재배포 후에는 새 QLab Projection Pack을 다운로드하여 QLab과 ASM이 같은 배포 자막 원본을 사용하게 하세요.
QLab을 실행할 Mac에 팩을 다운로드합니다. QLab Script cue를 사용하므로 어떤 종류의 QLab 라이선스든 필요하며, 로컬 브리지 도우미를 실행하려면 Node.js 18 이상도 설치되어 있어야 합니다.

다운로드한 팩을 세 단계로 설정

팩의 압축을 풀고 QLab 5 작업 공간을 연 다음 1 - START HERE.txt의 안내를 따릅니다. 이 파일은 이 팩의 간단한 운영자 안내서입니다.
2a - Import into QLab.applescript를 실행한 다음 2b - QLab Cue Data.json을 선택합니다.
3 - Start Local Bridge.command를 두 번 클릭하고 공연 중 Terminal 창을 계속 열어 둡니다. 일반 ASM Console을 열어 잠금을 해제하고 QLab enabled, Connect local bridge를 차례로 누르세요. 요청되면 로컬 네트워크 접근을 허용하고 Viewer sync ready가 표시될 때까지 기다린 다음 Allow QLab control을 누릅니다.

가져온 팩 구조 및 규칙

배포된 공연 팩은 SurtitleLive 자막을 QLab Group으로 가져옵니다. 각 Group에는 로컬 투사용 Text child cue가 하나 이상 있고, 비밀이 아닌 cue 식별 정보를 로컬 브리지로 보내는 Script child cue가 하나 있습니다.
여러 언어나 화면을 선택했다면 같은 SurtitleLive Group 안에 두세요. 이는 여러 순간의 cue가 아니라 하나의 자막 cue입니다. 같은 화면의 언어는 top/middle/bottom 위치가 서로 다른 별도의 Text child cue로 유지합니다.
무대 지시를 Text cue로 포함하면 일반 SurtitleLive Group으로 가져옵니다. 로컬로 투사되고 관객 휴대폰과도 동기화되므로 접근성 자막에 유용합니다. Memos는 동기화를 지원하지 않습니다.
나중에 수정된 팩을 가져오면 매칭되는 SurtitleLive 자막 그룹이 중복되지 않고 안정적인 큐 키로 업데이트됩니다.
해당 자막이 나타나야 하는 메인 QLab 쇼 목록으로 SurtitleLive 자막 그룹 전체를 이동합니다.
SurtitleLive 자막 그룹 앞, 뒤 또는 사이에 사운드, 조명, 비디오, 대기(standby), 대기(wait), 일시 정지(pause) 또는 기타 QLab 큐를 추가합니다.
각 SurtitleLive Group을 그대로 유지하세요. 관객 휴대폰과의 동기화를 의도적으로 중단하려는 경우가 아니라면 Text child cue를 Script child cue에서 분리하지 마세요.

QLab 브리지 점검 및 연결

QLab과 같은 Mac에서 SurtitleLive 로컬 브리지를 시작합니다. Node.js 18 이상이 필요하며 공연 중 Terminal 창을 열어 두세요.
오퍼레이터 콘솔에서 로컬 브리지에 연결합니다.
오퍼레이터 콘솔에 브리지 헬퍼가 연결되고 Viewer 동기화 준비가 되었다고 표시되는지 확인합니다.
QLab 제어를 활성화(arm)합니다. 오퍼레이터 콘솔은 모바일 Viewer 및 프로젝터 출력을 큐 간 교체로 전환하므로 다음 QLab 자막 큐가 실행될 때 이전 자막이 사라집니다.
한 개의 QLab 자막 cue를 실행하여 QLab 입력이 ASM에 도달하는지 확인합니다.
포트 37621이 사용 중이어도 QLab에서 포트를 바꾸지 마세요. SurtitleLive 브리지가 이미 실행 중이면 그대로 두고 ASM을 연결하며, 두 번째 브리지를 시작하지 마세요.
다른 앱이 포트를 사용한다면 Terminal에서 lsof -nP -iTCP:37621 -sTCP:LISTEN을 실행해 확인한 뒤, 해당 앱을 닫고 3 - Start Local Bridge.command를 다시 실행하세요. 확인하거나 닫을 수 없다면 QLab 제어를 끄고 일반 ASM 제어를 사용하세요.
QLab 제어가 허용된 동안 ASM은 모바일 자막 표시 전환을 잠급니다. 팩에 무대 지시 Text cue가 포함되어 있다면 해당 cue도 투사되고 관객 휴대폰과 동기화됩니다.

공연 전 리허설

QLab에서 초기 자막 하나를 실행하고 QLab 투사, 오퍼레이터 콘솔의 현재 큐 및 Viewer 자막이 모두 일치하는지 확인합니다.
다음 QLab 자막 큐가 나타날 때 이전 자막이 사라지는지 확인합니다.
다음 큐뿐만 아니라 QLab에서 직접 중간 자막 하나를 실행합니다.
잘못된 자막으로 이동한 다음 QLab에서 수정하고 오퍼레이터 콘솔과 Viewer가 수정된 큐를 따르는지 확인합니다.
공연에 QLab 블랙아웃(blackout), 일시 정지, 대기 또는 스탠바이 큐가 사용되는 경우 이를 자체 QLab 큐로 테스트하십시오. SurtitleLive 베타 팩은 추가 블랙아웃, 대기, 테스트 카드, 메모 또는 최종 화면 지우기 큐를 추가하지 않습니다.
점검에 실패하면 QLab 제어를 비활성화(disarm)하고 오퍼레이터 콘솔의 수동 제어 또는 QLab 투사 전용을 대체 수단으로 사용하십시오.

내보내기 후 자막이 변경된 경우

SurtitleLive에서 자막을 변경하고 Editor를 저장합니다.
실시간 워크플로에 따라 실시간 자막 업데이트(Update Live Subtitles) 또는 재배포를 사용합니다.
업데이트된 배포에서 새로운 QLab Projection Pack을 다운로드합니다.
가져오기 도구를 다시 실행합니다. 같은 SurtitleLive cue의 텍스트를 수정하면 해당 QLab Group과 그 안의 Text child cue가 제자리에서 업데이트됩니다.
새 SurtitleLive cue에는 새 cue key가 부여되어 가능한 경우 이전 Group 뒤에 삽입됩니다. 삭제된 자막은 실제로 삭제하지 않고 삭제됨으로 표시됩니다.
큐 순서, 라인 ID, 큐 번호 또는 큐 유형이 변경되면 활성 ASM 소스 식별 정보가 변경될 수 있습니다. 최신 팩을 가져올 때까지 오래된 QLab Projection Pack은 의도적으로 거부됩니다.
그 다음 공연 전에 주변 사운드, 조명, 비디오, 대기 또는 스탠바이 큐를 확인하십시오.

안전 경계

QLab Projection Pack에는 SurtitleLive 비밀번호, 런타임 토큰 또는 관리자 자격 증명이 포함되어 있지 않습니다.
Text 큐는 QLab 작업 공간에 저장되어 있으므로 네트워크가 끊어져도 QLab 로컬 투사는 계속될 수 있습니다.
모바일 Viewer 동기화에는 ASM, 로컬 브리지 및 SurtitleLive 런타임 제어 연결이 여전히 필요합니다.
로컬 브리지는 허용된 큐 전환만 QLab에서 공연 Mac의 ASM으로 중계합니다. QLab → ASM 제어의 유일한 경로이며 포트 37621의 loopback localhost에서만 수신하고 공용 네트워크에는 노출되지 않습니다.
브라우저 직접 Web MIDI는 이 베타의 전시장 경로가 아닙니다. 로컬 브리지 워크플로를 사용하십시오.
오퍼레이터 콘솔은 Deployment Cockpit에서 QLab 제어가 활성화되고 오퍼레이터가 오퍼레이터 콘솔의 QLab 패널을 연결하고 활성화(arm)한 후에만 QLab 동기화 타임라인을 준비합니다.
QLab 연결 상태는 관객의 스마트폰이 자막을 수신하고 있다는 증거가 아닙니다. 공연 전에는 항상 실제 Viewer 링크를 테스트하십시오.

5.4 ASM 및 Viewer 동기화를 위한 QLab 제어 (베타)