Kendala Layar Jemaat & Proyektor
| Gejala atau Pesan Error | Akar Masalah | Langkah Perbaikan |
|---|---|---|
| Mengeklik "Open as window" tidak membuka apa pun | Browser memblokir pembukaan window pop-up otomatis. | Lihat sisi kanan bilah alamat browser Anda untuk menemukan ikon pop-up yang diblokir. Klik ikon tersebut, pilih Selalu izinkan pop-up dari situs ini, lalu klik tombol penayangan kembali. |
| Proyektor eksternal tidak muncul di menu "Project to" | Izin Window Management ditolak browser, atau pengaturan monitor Windows diatur ke mode Duplikasi (Duplicate). | Tekan Win + P di Windows lalu pilih Extend (Perluas). Pada Chrome atau Edge, klik ikon setelan situs di samping bilah alamat, pastikan izin Window management diatur ke Izinkan, lalu muat ulang konsol. |
| Status "Congregation screen active" muncul, tetapi layar gelap | Mode pemadaman layar (B) sedang aktif, atau slide saat ini tidak memiliki elemen teks yang tampak. | Tekan B pada keyboard atau klik tombol Blank di konsol operator untuk mengembalikan tayangan slide aktif. |
Kendala Capture HDMI Tamu
| Gejala atau Pesan Error | Akar Masalah | Langkah Perbaikan |
|---|---|---|
| "Permission denied" saat mengaktifkan capture | Izin kamera ditolak di browser, atau aplikasi dibuka lewat alamat HTTP tanpa enkripsi. | Pastikan aplikasi dibuka melalui HTTPS atau localhost (browser memblokir akses perangkat kamera pada alamat IP biasa seperti http://192.168.x.x). Klik ikon gembok pada bilah alamat browser lalu izinkan akses kamera. |
| Dropdown perangkat capture kosong | Capture card USB UVC terlepas, atau setelan privasi Windows memblokir akses kamera untuk aplikasi desktop. | Lepas dan colokkan kembali capture card USB. Buka Pengaturan Windows → Privasi & Keamanan → Kamera, lalu pastikan Izinkan aplikasi mengakses kamera dalam posisi Aktif. |
| Video tamu tampil di layar jemaat, tetapi tidak ada suara | Alur penangkapan video lewat browser sengaja tidak memproses audio demi mencegah latensi dan gangguan tempo puji-pujian. | Sambungkan kabel audio 3,5 mm fisik dari laptop tamu langsung ke mixer audio atau sistem tata suara gereja. |
Kendala Remote Ponsel Wi-Fi
| Gejala atau Pesan Error | Akar Masalah | Langkah Perbaikan |
|---|---|---|
| "Invalid or expired pairing code" | Kode 6 digit telah kedaluwarsa (berlaku 60 detik) atau salah ketik. | Klik badge Remote code pada header konsol operator untuk membuat kode 6 digit baru, lalu masukkan ke browser ponsel dalam waktu 60 detik. |
| Browser ponsel menampilkan "Unable to connect" | Ponsel menggunakan paket data seluler alih-alih Wi-Fi gereja, atau router mengaktifkan fitur isolasi klien (AP isolation). | Sambungkan ponsel ke jaringan Wi-Fi gereja yang sama dengan komputer WorshipDeck. Pastikan router mengizinkan lalu lintas antar-perangkat nirkabel lokal. |
| Remote ponsel tidak merespons pada installer desktop | Installer desktop mengunci port ke 127.0.0.1 (loopback lokal saja) dan menolak koneksi jaringan dari perangkat luar. | Untuk menggunakan remote ponsel lewat Wi-Fi, jalankan WorshipDeck pada server komputer menggunakan npm start, yang menerima koneksi dari 0.0.0.0. |
Kendala Parser & Regex
| Gejala atau Pesan Error | Akar Masalah | Langkah Perbaikan |
|---|---|---|
| "invalid regular expression: lookaround not supported" | Pola regex memuat fitur lookahead atau lookbehind (misal (?<=...)) yang ditolak engine RE2. | Tulis ulang pola memakai capturing groups standar (misal Awalan:\s*(?<value>.+)) tanpa menggunakan lookbehind. |
| Field terisi sebagai teks kosong | Pola regex cocok dengan baris, tetapi tidak memuat named group value atau grup capture posisi pertama. | Uji pola di Rundown Test Area & Sandbox (Kartu B) lalu pastikan teks target dibungkus di dalam (?<value>...). |
| "missing required placeholder" | Elemen tata letak ditandai sebagai wajib (required), tetapi token hasil pembacaan susunan acara tidak memiliki nilai. | Buka formulir ibadah lalu isi nilai yang wajib tersebut secara manual, atau hilangkan tanda centang required pada editor canvas tata letak. |
Kendala Ekspor PowerPoint & Font
| Gejala atau Pesan Error | Akar Masalah | Langkah Perbaikan |
|---|---|---|
| Peringatan: "Font does not permit embedding" | Tabel OS/2 TrueType pada font yang diunggah melarang embedding sesuai lisensi komersialnya. | WorshipDeck otomatis mengganti font dengan Inter pada file ekspor demi mencegah pelanggaran lisensi. Untuk menggunakan font kustom, pasang font open-source berlisensi SIL Open Font License atau Apache 2.0. |
| Slide hasil ekspor terbuka dengan jeda baris yang bergeser | Komputer tujuan menggunakan skala layar Windows yang berbeda atau belum memiliki font tersebut. | Pastikan opsi font embedded aktif saat ekspor, atau centang pilihan Pertahankan jeda baris persis seperti di canvas pada dialog unduhan PowerPoint di Run Sheet. |