5.4 Controle do QLab para sincronização do ASM e Viewer (Beta)

O que este fluxo de trabalho beta faz

Este fluxo mantém o SurtitleLive como a fonte de texto, tradução, implantação, console do operador e Viewer. O QLab passa a ser a interface de controle do espetáculo para as cues de legenda durante a apresentação.

• O QLab exibe localmente as cues de texto importadas, para que o computador de projeção tenha uma cópia de segurança das legendas dentro do próprio QLab.
• Quando armado, cada grupo de legendas (Group) do SurtitleLive também pode pedir ao console do operador que avance para a cue implantada correspondente.
• O console do operador publica o estado normal das cues do SurtitleLive nos links do Viewer e nos celulares do público.
• Este fluxo não cria um segundo caminho de implantação: usa o espetáculo já implantado, o link existente do console do operador e os links existentes do Viewer.

Preparar legendas no SurtitleLive

1. Conclua a edição do texto, tradução e revisão de legendas no Editor.
2. Use a Simulação (Simulation) para confirmar a ordem das cues e os idiomas.
3. Implante o show através de Iniciar transmissão (Go Live).
4. Abra o show implantado no Deployment Cockpit.

Ativar o controle do QLab e baixar o pacote

1. No Deployment Cockpit, localize o painel Controle do QLab, depois de Materiais para o público.
2. Ative Ativar controle do QLab no console do operador. Isso não altera o link do console, o código QR nem as ações de copiar ou abrir.
3. Baixe o QLab Projection Pack para o show implantado.
4. O pacote beta usa os padrões do espetáculo implantado: um idioma de legenda, legendas centralizadas, nomes de personagens ocultos e rubricas ignoradas.
5. Nas opções do pacote, escolha o idioma, a posição das legendas, uma tela única ou telas separadas, o nome da tela ou do palco, a exibição de nomes de personagens e o tratamento das rubricas.
6. Por padrão, os nomes ficam ocultos e as rubricas são ignoradas. Baixe um novo pacote depois de Atualizar legendas ao vivo (Update Live) ou de uma nova implantação, para que QLab e o console usem a mesma fonte.
7. É necessário qualquer tipo de licença do QLab e Node.js 18 ou posterior. Baixe o pacote no Mac que executará o QLab.

Configurar o pacote baixado em três etapas

1. Descompacte o pacote e abra o espaço de trabalho do QLab 5 no Mac que executará o QLab. Em seguida, leia e siga 1 - START HERE.txt, o guia rápido do operador.
2. Execute 2a - Import into QLab.applescript e escolha 2b - QLab Cue Data.json.
3. Clique duas vezes em 3 - Start Local Bridge.command e mantenha o Terminal aberto. Abra e desbloqueie o ASM Console, ative QLab enabled, conecte a ponte local, permita o acesso à rede local quando solicitado, aguarde Viewer sync ready e selecione Allow QLab control.

Estrutura e regras do pacote importado

• O pacote do espetáculo implantado importa as legendas do SurtitleLive como Groups do QLab. Cada Group contém uma ou mais Text child cues para projeção local e uma Script child cue que envia à ponte local a identidade não secreta da cue.
• Se você importar um pacote revisado mais tarde, os grupos correspondentes serão atualizados por uma chave de cue estável, em vez de duplicados.
• Para vários idiomas ou telas, mantenha as cues correspondentes no mesmo Group: são a mesma cue de legenda, não momentos separados. Na mesma tela, mantenha idiomas diferentes em Text child cues separadas, nas posições superior, central ou inferior.
• As rubricas podem ser mantidas como Text cues e sincronizadas com os celulares do público, o que é útil para legendas acessíveis. Memos do QLab não são sincronizados.
• Mova grupos de legendas inteiros do SurtitleLive para a sua lista principal de shows do QLab onde essas legendas devem ocorrer.
• Adicione cues de som, luz, vídeo, standby, espera (wait), pausa ou outras cues do QLab antes, depois ou entre os grupos de legendas do SurtitleLive.
• Mantenha cada grupo do SurtitleLive intacto. Não separe a cue filha de texto da cue filha de script, a menos que queira interromper intencionalmente a sincronização com o console do operador e o Viewer.

Verificar a ponte e solucionar problemas

1. Abra o console do operador pelo link habitual de ASM Console no Deployment Cockpit e desbloqueie-o com a senha do operador.
2. Clique duas vezes em 3 - Start Local Bridge.command; o Terminal será aberto automaticamente. A ponte exige Node.js 18 ou posterior, deve funcionar no mesmo Mac do QLab e a janela do Terminal deve permanecer aberta durante o espetáculo.
3. Se o arquivo 3 não abrir, use o Terminal em Aplicativos → Utilitários e siga o fallback curto de 1 - START HERE.txt: execute bash "./3 - Start Local Bridge.command" na pasta descompactada.
4. Se a porta 37621 estiver ocupada, não a altere no QLab. Se já houver uma ponte SurtitleLive em execução, mantenha-a aberta e conecte o ASM a ela; não inicie uma segunda ponte.
5. No console do operador, conecte-se à ponte local e permita o acesso à rede local quando solicitado. Confirme que o auxiliar da ponte está conectado e que a sincronização do Viewer está pronta.
6. Arme o controle do QLab. O console passará o Viewer móvel e o projetor para a substituição cue a cue, fazendo a legenda anterior desaparecer quando a próxima cue do QLab for acionada.
7. Enquanto o controle do QLab estiver autorizado, os controles de exibição das legendas móveis ficam bloqueados. Se o pacote incluir rubricas como Text cues, essas cues continuam sendo projetadas e sincronizadas com os celulares. Execute uma cue de legenda para confirmar que a entrada do QLab chega ao console do operador.

Ensaio antes do show

• Execute uma legenda inicial do QLab e confirme se a projeção do QLab, a cue atual do console do operador e as legendas do Viewer são idênticas.
• Confirme se a legenda anterior desaparece quando a próxima cue de legenda do QLab aparece.
• Execute uma legenda intermediária diretamente do QLab, não apenas a próxima cue.
• Salte para uma legenda errada, depois corrija-a a partir do QLab e confirme se o console do operador e o Viewer seguem a cue corrigida.
• Se o seu show usar cues de blackout, pausa, espera ou standby no QLab, teste-as como suas próprias cues do QLab. O pacote beta do SurtitleLive não adiciona cues adicionais de blackout, standby, mira de teste, memorando ou de limpeza final de tela.
• Se alguma verificação falhar, desarme o controle do QLab e use os controles manuais do console ou apenas a projeção do QLab como alternativa.

Se as legendas mudarem após a exportação

• Faça a alteração da legenda no SurtitleLive e salve o Editor.
• Use a opção Atualizar legendas ao vivo (Update Live Subtitles) ou reimplante, dependendo do seu fluxo de trabalho ao vivo.
• Baixe um QLab Projection Pack atualizado da implantação atualizada.
• Execute o importador novamente. As edições de texto na mesma cue do SurtitleLive atualizam o Group correspondente e seus Text children no mesmo lugar. As novas cues recebem novas chaves estáveis e são inseridas depois do Group anterior, quando possível; as legendas removidas são marcadas como removidas, não excluídas.
• Se a ordem das cues, os IDs de linha, os números ou os tipos de cue mudarem, a identidade da fonte ativa do ASM pode mudar. Os pacotes antigos do QLab são rejeitados deliberadamente até que o pacote mais recente seja importado.
• Após a reimportação, confirme que as cues atualizadas mantêm a ordem e as chaves estáveis.
• Depois, verifique todas as cues de som, luz, vídeo, espera ou standby ao redor antes da apresentação.

Limites de segurança

• O QLab Projection Pack não contém senhas do SurtitleLive, tokens de runtime nem credenciais de administrador.
• A projeção local do QLab pode continuar se a rede cair, pois as cues de texto residem no espaço de trabalho do QLab.
• A sincronização do Viewer nos celulares ainda exige que o ASM, a ponte local e o controle de runtime do SurtitleLive estejam conectados.
• A ponte local apenas encaminha ao ASM os avanços de cue autorizados no QLab, no Mac do espetáculo: esse é o único caminho QLab → ASM. Ela escuta somente na interface de loopback localhost, na porta 37621, nunca em uma interface pública.
• O Web MIDI direto do navegador não é o caminho da sala de espetáculos para este beta. Use o fluxo de trabalho da ponte local.
• O ASM só prepara a linha do tempo de sincronização depois que o controle do QLab é ativado no Deployment Cockpit, a ponte é conectada e o operador autoriza o controle no ASM.
• O status conectado do QLab não prova que os celulares do público estão recebendo as legendas. Sempre teste um link real do Viewer antes da apresentação.