5.4 Kontrol QLab untuk sinkronisasi ASM dan Viewer (Beta)

Apa yang dilakukan alur kerja beta ini

Alur ini mempertahankan SurtitleLive sebagai sumber naskah, terjemahan, deployment, konsol langsung, dan Viewer penonton. QLab menjadi antarmuka kontrol pertunjukan untuk cue takarir selama pertunjukan.

• QLab menampilkan cue Teks takarir yang diimpor secara lokal, sehingga komputer proyeksi memiliki cadangan takarir asli QLab.
• Saat kontrol di-arm, setiap Grup takarir SurtitleLive juga dapat meminta konsol operator melompat ke cue deployment yang sesuai.
• Konsol operator kemudian mempublikasikan status cue SurtitleLive normal ke tautan Viewer dan ponsel penonton.
• Ini bukan jalur deployment terpisah. Ini menggunakan pertunjukan yang di-deploy yang sudah ada, tautan konsol operator yang sudah ada, dan tautan Viewer yang sudah ada.

Siapkan takarir di SurtitleLive

1. Selesaikan pengeditan naskah, terjemahan, dan peninjauan takarir di Editor.
2. Gunakan Simulasi untuk mengonfirmasi urutan cue dan bahasa.
3. Deploy pertunjukan melalui Go Live.
4. Buka pertunjukan yang di-deploy di Deployment Cockpit.

Aktifkan kontrol konsol operator dan unduh paket

1. Di Deployment Cockpit, temukan panel Kontrol QLab setelah Materi Penonton.
2. Aktifkan Aktifkan kontrol QLab di konsol operator. Ini tidak mengubah tautan konsol operator, kode QR, tindakan Salin, atau Buka.
3. Unduh QLab Projection Pack untuk pertunjukan yang di-deploy.
4. Paket beta menggunakan default pertunjukan yang di-deploy: satu bahasa takarir, takarir di tengah layar, nama karakter disembunyikan, dan petunjuk panggung dilewati.
5. Dalam dialog opsi QLab, pilih bahasa, posisi takarir, layar yang sama atau terpisah, nama layar/panggung, tampilan nama karakter, dan penanganan petunjuk panggung.
6. Default beta menyembunyikan nama karakter dan melewati petunjuk panggung. Unduh paket baru setelah Update Live atau deploy ulang agar QLab dan ASM memakai sumber takarir deployment yang sama.
7. QLab Cloud Sync memerlukan lisensi QLab jenis apa pun. Mac ini juga harus memiliki Node.js 18 atau yang lebih baru untuk menjalankan helper bridge.

Siapkan paket yang diunduh dalam tiga langkah

1. Ekstrak paket, buka ruang kerja QLab 5, lalu ikuti 1 - START HERE.txt, panduan singkat operator.
2. Jalankan 2a - Import into QLab.applescript, lalu pilih 2b - QLab Cue Data.json.
3. Klik dua kali 3 - Start Local Bridge.command dan biarkan Terminal tetap terbuka. Buka dan buka kunci ASM Console, aktifkan QLab enabled, pilih Connect local bridge, izinkan akses jaringan lokal jika diminta, tunggu Viewer sync ready, lalu pilih Allow QLab control.

Struktur & aturan paket yang diimpor

• Paket pertunjukan yang di-deploy mengimpor takarir SurtitleLive sebagai Grup QLab. Setiap Grup berisi cue anak Teks untuk proyeksi lokal dan cue anak Script yang mengirimkan identitas cue non-rahasia ke jembatan lokal.
• Jika beberapa bahasa atau layar dipilih, pertahankan semuanya dalam Grup SurtitleLive yang sama: itu satu cue takarir, bukan beberapa momen. Pada satu layar, versi bahasa tetap menjadi Text child cue terpisah di posisi atas/tengah/bawah.
• Petunjuk panggung yang dimasukkan sebagai Text cue juga dapat diproyeksikan dan disinkronkan ke ponsel penonton untuk accessibility captions. Memo QLab tidak mendukung sinkronisasi.
• Jika Anda mengimpor paket yang direvisi nanti, Grup takarir SurtitleLive yang cocok diperbarui dengan kunci cue stabil, bukan diduplikasi.
• Pindahkan seluruh Grup takarir SurtitleLive ke daftar pertunjukan QLab utama Anda di mana takarir tersebut seharusnya terjadi.
• Tambahkan cue suara, cahaya, video, standby, tunggu (wait), jeda (pause), atau cue QLab lainnya sebelum, sesudah, atau di antara Grup takarir SurtitleLive.
• Jaga agar setiap Grup SurtitleLive tetap utuh. Jangan memisahkan cue anak Teks dari cue anak Script kecuali Anda sengaja ingin takarir tersebut berhenti menyinkronkan konsol operator dan Viewer.

Periksa bridge dan hubungkan QLab

1. Buka konsol operator dari tautan ASM Console normal di Deployment Cockpit dan buka kuncinya dengan kata sandi operator.
2. Klik dua kali 3 - Start Local Bridge.command; Terminal terbuka otomatis. Bridge harus berjalan di Mac yang sama dengan QLab dan jendelanya harus tetap terbuka selama pertunjukan.
3. Jika file 3 tidak terbuka, jalankan bash "./3 - Start Local Bridge.command" dari folder paket yang diekstrak melalui Terminal.
4. Jika port 37621 sedang dipakai, jangan ubah port di QLab dan jangan jalankan bridge kedua. Jika perlu, periksa dengan lsof -nP -iTCP:37621 -sTCP:LISTEN; bila tidak dapat menutup prosesnya, nonaktifkan kontrol QLab dan gunakan ASM manual.
5. Di konsol operator, hubungkan ke bridge lokal dan izinkan akses jaringan lokal bila diminta. Pastikan helper bridge terhubung dan sinkronisasi Viewer siap.
6. Arm kontrol QLab. Konsol operator akan mengalihkan output Viewer seluler dan Proyeksi ke penggantian cue-ke-cue, sehingga takarir sebelumnya menghilang saat cue takarir QLab berikutnya berjalan.
7. Saat kontrol QLab diizinkan, ASM mengunci sakelar tampilan takarir seluler. Petunjuk panggung yang berupa Text cue tetap diproyeksikan dan disinkronkan ke ponsel. Jalankan satu cue takarir untuk memverifikasi input QLab mencapai ASM.

Latihan sebelum pertunjukan

• Jalankan satu takarir awal dari QLab og konfirmasikan proyeksi QLab, cue konsol operator saat ini, dan takarir Viewer semuanya cocok.
• Konfirmasikan takarir sebelumnya menghilang saat cue takarir QLab berikutnya muncul.
• Jalankan satu takarir tengah langsung dari QLab, bukan hanya cue berikutnya.
• Lompat ke takarir yang salah, lalu koreksi dari QLab, dan konfirmasikan konsol operator dan Viewer mengikuti cue yang dikoreksi.
• Jika pertunjukan Anda menggunakan cue blackout, jeda, tunggu, atau standby QLab, uji cue tersebut sebagai cue QLab Anda sendiri. Paket beta SurtitleLive tidak menambahkan cue blackout, standby, kartu tes, memo, atau pembersihan layar akhir tambahan.
• Jika ada pemeriksaan yang gagal, disarm kontrol QLab dan gunakan kontrol manual konsol operator atau proyeksi hanya melalui QLab sebagai fallback.

Jika takarir berubah setelah ekspor

• Buat perubahan takarir di SurtitleLive dan simpan Editor.
• Gunakan Perbarui Takarir Langsung (Update Live Subtitles) ou deploy ulang, tergantung pada alur kerja langsung Anda.
• Unduh QLab Projection Pack baru dari deployment yang diperbarui.
• Jalankan importir lagi. Pengeditan teks pada cue SurtitleLive yang sama memperbarui Grup QLab dan Text child di tempatnya. Cue SurtitleLive baru menerima kunci cue baru dan dimasukkan setelah Grup sebelumnya jika memungkinkan; takarir yang dihapus ditandai sebagai dihapus, bukan dihapus permanen.
• Jika urutan cue, ID baris, nomor cue, atau tipe cue berubah, identitas sumber konsol operator aktif dapat berubah. Paket Proyeksi QLab lama sengaja ditolak hingga paket terbaru diimpor.
• Setelah impor ulang, pastikan cue yang diperbarui tetap memiliki urutan dan kunci cue yang stabil.
• Setelah itu, periksa cue suara, cahaya, video, tunggu, atau standby di sekitarnya sebelum pertunjukan.

Batas keamanan

• QLab Projection Pack tidak berisi kata sandi SurtitleLive, token runtime, atau kredensial admin.
• Proyeksi lokal QLab dapat berlanjut jika jaringan terputus, karena cue Teks berada di ruang kerja QLab.
• Sinkronisasi Viewer di ponsel masih memerlukan ASM, bridge lokal, dan kontrol runtime SurtitleLive yang terhubung.
• Bridge lokal hanya meneruskan lompatan cue yang diizinkan dari QLab ke ASM di Mac pertunjukan. Ini satu-satunya jalur kontrol QLab → ASM; bridge mendengarkan di loopback localhost pada port 37621, bukan antarmuka jaringan publik.
• Web MIDI browser langsung bukanlah jalur tempat pertunjukan untuk beta ini. Gunakan alur kerja jembatan lokal.
• ASM menyiapkan linimasa sinkronisasi QLab hanya setelah kontrol QLab diaktifkan di Deployment Cockpit, bridge terhubung, dan operator mengizinkan kontrol QLab di ASM.
• Status terhubung QLab bukan bukti bahwa ponsel penonton menerima takarir. Selalu uji tautan Viewer yang sebenarnya sebelum pertunjukan.