Pemecahan Masalah

Selesaikan kendala penayangan live, capture perangkat keras, remote ponsel, dan parsing susunan acara dengan cepat memakai tabel diagnostik berbasis pesan error asli aplikasi.

Ditulis untuk WorshipDeck 0.1.2

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.