Pengaturan: Lanjutan
Jalankan event otomatis, biarkan mulai ulang otomatis saat event tetap aktif, atasi preview kamera hitam, putar video fps tinggi, atur penanganan error, pilih CPU atau GPU untuk Face Swap dengan Paket GPU, serta nyalakan Local API dan Remote control untuk HP.
Tab Lanjutan berisi pengaturan teknis: menjalankan event otomatis, cara preview kamera dan video ditampilkan, penanganan error, Engine Komputasi yang menjalankan alat wajah dan latar offline (Face Swap, Face Restore, Background Change) di prosesor atau kartu grafis Anda, serta Local API dengan Remote control untuk HP Anda. Biarkan semuanya pada default kecuali ada alasan — setiap opsi di bawah menjelaskan kapan perlu diubah.
Bab (13)
- 0:00Apa itu Remote Control
- 0:11Pengaturan › Lanjutan › Local API
- 0:21Port dan kata sandi
- 0:28Izinkan perangkat lain di jaringan, Simpan
- 0:37Izin firewall Windows
- 0:45Kode QR: sambungkan HP
- 0:59Remote: lampu online dan status
- 1:08Start event, start session, pilih templat
- 1:27Shoot, retake, process
- 1:41Print dan QR Share
- 1:47Home dan Stop event
- 1:53Tombol redup dan dialog
- 2:02Berikutnya: Local API untuk developer
Bab (12)
- 0:00Apa saja yang bisa dibuat
- 0:15Menyalakan: Pengaturan › Lanjutan › Local API
- 0:29Kata sandi: Bearer token atau X-QBooth-Key
- 0:37Sandbox bawaan
- 0:45Perintah abu-abu dan "available"
- 0:56202 accepted, lalu cek status
- 1:09Error: 409 wrong_page
- 1:18Satu tamu dalam empat panggilan
- 1:31Tidak ada yang dilewati
- 1:44Halaman Docs dan log API
- 1:54Tidak ngoding? Remote Control
- 2:01Penutup
Jika tab Lanjutan tidak terlihat, aktifkan Tampilkan semua pengaturan di kiri bawah jendela Pengaturan Aplikasi.

Jalankan Event Otomatis saat Aplikasi Dibuka
Menjadikan komputer booth yang menyala sendiri (sejak 5.4.0.0): saat Q-Booth dibuka, event yang dipilih langsung berjalan layar penuh dalam mode kios dengan sendirinya.
- Aktifkan Jalankan Event Otomatis saat Aplikasi Dibuka.
- Pilih Event yang dijalankan.
- Klik Simpan Pengaturan.
Saat Q-Booth dibuka berikutnya, hitung mundur muncul terlebih dahulu. Batalkan untuk tetap di aplikasi (misalnya untuk mengubah sesuatu sebelum event). Jika event yang dipilih kemudian dihapus, fitur ini otomatis mati.
Kombinasikan dengan Windows yang membuka Q-Booth otomatis setelah login, sehingga booth pulih sendiri setelah listrik padam. Pasang PIN keluar di event agar tamu tidak bisa keluar dari mode kios — lihat Pengaturan event.
Mulai ulang otomatis saat event
Sejak 5.9.0.0 ada dua sakelar di sini, keduanya aktif secara default:
- Mulai ulang saat video latar berhenti — jika video latar sebuah halaman berhenti diputar, booth memulai ulang di sela tamu lalu membuka event itu lagi.
- Mulai ulang saat memori terlalu tinggi — jika Q-Booth memakai memori jauh lebih banyak dari biasanya (sekitar separuh memori komputer, paling banyak 12 GB), aplikasi memulai ulang dengan cara yang sama, paling sering sekali setiap 30 menit.
Biarkan keduanya aktif. Jika restart karena video dimatikan, halaman menjadi hitam setelah video berhenti dan booth terus memakai memori makin banyak sampai komputer macet.
Seperti apa restart ini terlihat oleh tamu, dan apa yang dilakukan jika sering terjadi: lihat Booth memulai ulang sendiri saat event.
Mesin Render Live View
| Pilihan | Kapan dipakai |
|---|---|
| GPU (default) | Memakai kartu grafis untuk menampilkan preview kamera. Halus dan ringan bagi prosesor. |
| CPU | Pakai jika live view kamera tampil hitam di komputer ini (sering kali foto tetap terambil dengan benar). Berjalan di mana saja tetapi lebih membebani prosesor. |
Perubahan berlaku saat Anda membuka halaman kamera atau jendela kamera berikutnya — tanpa restart. Jika Q-Booth sama sekali tidak menemukan kartu grafis yang bisa dipakai, preview otomatis berjalan di CPU dan diberitahukan saat aplikasi dibuka (No GPU Detected); memperbarui driver grafis biasanya membantu.
Di versi sebelum 5.9.0.0, jika booth terus memulai ulang sendiri karena video latar berhenti, atur ini ke CPU lalu klik Simpan Pengaturan: preview CPU tidak menghabiskan memori grafis sedikit demi sedikit seperti preview GPU versi lama. Preview CPU lebih membebani prosesor, jadi pastikan preview tetap lancar. Penyebab yang paling mungkin sudah diperbaiki di 5.9.0.0, jadi lakukan update terlebih dahulu.
Engine Pemutar Video
| Pilihan | Kelebihan | Kekurangan |
|---|---|---|
| Bawaan (default) | Memutar sebagian besar video. Tombol dan objek di layar bisa tampil di atas video. | Klip yang direkam di atas 60 fps diputar lebih lambat dari aslinya. |
| VLC | Memutar video frame rate tinggi (120/240 fps) dengan kecepatan asli. | Tombol dan objek tidak bisa tampil di atas video. Perlu unduhan sekali: tombol Unduh Pack VLC muncul saat Anda memilih VLC dan pack-nya belum terpasang. |
Beralih ke VLC hanya jika klip fps tinggi (misalnya dari booth slow motion GoPro) patah-patah atau terlalu lambat, dan pastikan tidak ada halaman yang bergantung pada tombol di atas video. Di versi sebelum 5.9.5.0, VLC kadang membuat jendela "Please Wait" membeku tepat saat hasil AI siap — lihat Pemecahan masalah.
Simpan versi asli tanpa overlay
Jika aktif (sejak 5.4.0.0), Q-Booth menyimpan salinan tambahan setiap hasil gambar sebelum frame overlay diterapkan, ke folder _original di samping file hasil. Salinan ini tidak tampil di galeri dan tidak pernah dibagikan atau dicetak — salin secara manual saat klien menginginkan foto tanpa frame. Hanya untuk gambar, bukan video. Mati secara default, dan hanya berlaku untuk foto yang diambil setelah opsi ini dinyalakan.
Penanganan Error
Cara Q-Booth menanggapi error tak terduga: Show Error Dialog (default) menampilkan pesan. Dengan Silent, tidak ada pop-up — aplikasi langsung tertutup, dan tidak menyala lagi dengan sendirinya. Error-nya tetap tercatat di log.
Biarkan di Show Error Dialog kecuali ada alasan. Di kios tanpa operator, Silent berarti booth bisa tiba-tiba hilang dari layar dan harus ada orang yang membukanya lagi.
Engine Komputasi
Engine Komputasi menjalankan alat wajah dan latar offline di komputer ini — Face Swap, Face Restore, dan Background Change. Pengaturan ini tidak memengaruhi AI Online, yang berjalan di cloud. Engine ini juga terpisah dari AI Offline Server yang menjalankan template gambar AI Offline (Imagine, Re-Imagine…) — tidak ada pengaturan di sini yang menyalakan, memperbaiki, atau mempercepat server itu; lihat AI Offline Studio.
Perangkat Komputasi
| Pilihan | Fungsi |
|---|---|
| Auto (default) | Memakai kartu grafis bila bisa, jika tidak memakai prosesor. Disarankan untuk kebanyakan perangkat. |
| CPU | Selalu memakai prosesor. Berjalan di komputer apa pun, tetapi Face Swap dan Face Restore lebih lambat. |
| GPU | Selalu memakai kartu grafis. Jauh lebih cepat. Membutuhkan kartu NVIDIA RTX seri 30 atau lebih baru dan Paket GPU. Tidak bisa dipilih di komputer tanpa kartu NVIDIA. |
Mengunduh Paket GPU
Di komputer dengan kartu NVIDIA, mode GPU membutuhkan paket tambahan. Jika belum terpasang, tab menampilkan Mode GPU memerlukan paket tambahan sebelum dapat berjalan di GPU dan tombol Unduh Paket GPU.
- Pastikan koneksi internet stabil — paketnya besar (sekitar 2,4 GB). Lakukan di studio, bukan di lokasi event.
- Klik Unduh Paket GPU dan tunggu sampai selesai diunduh dan dipasang.
- Atur Perangkat Komputasi ke GPU (atau biarkan Auto).
- Klik Simpan Pengaturan lalu mulai ulang Q-Booth.
Menguji engine
Saat GPU dipilih di komputer NVIDIA, tab menampilkan GPU Terdeteksi dan tombol Uji Mesin. Pengujian memeriksa Akselerasi grafis, Face Swap, dan Face Restore, lalu melaporkan apakah semua lulus. Gunakan Tes Lagi setelah memperbaiki sesuatu (misalnya memperbarui driver grafis).
Boot Engine (warm-up)
Menentukan apakah engine AI tetap dimuat di memori (lebih cepat) atau baru dimuat saat dibutuhkan (lebih hemat memori). Pilihannya tergantung perangkat:
| Perangkat | Pilihan | Efek |
|---|---|---|
| GPU | Otomatis | Q-Booth memilih mode terbaik untuk kartu Anda. Disarankan. |
| Boot Hangat | Berpindah template tanpa jeda, tetapi menahan sekitar 3 GB memori grafis sepanjang sesi. | |
| Boot Dingin | Tidak memakai memori tambahan saat diam. Proses pertama sebuah template — dan proses pertama setelah berpindah template — perlu beberapa detik lebih lama. | |
| CPU (atau Auto tanpa kartu NVIDIA) | Tetap Dimuat | Disarankan. Dimuat sekali pada foto pertama lalu tetap siap; memakai sekitar 2,5 GB memori sampai aplikasi ditutup. |
| Bebaskan Tiap Foto | Membebaskan memori setelah setiap foto. Hanya untuk komputer dengan memori terbatas — setiap foto memuat engine lagi, yang bisa menambah hingga satu menit. |
Pilihan untuk CPU tersedia sejak 5.2.0.0.
Mengubah Perangkat Komputasi, atau Boot Engine di mode GPU, baru berlaku setelah Anda memulai ulang Q-Booth — tab mengingatkan dengan Perubahan ini berlaku setelah Anda memulai ulang aplikasi. Pilihan Boot Engine untuk CPU berlaku mulai foto berikutnya, tanpa restart. Memilih Auto untuk Perangkat Komputasi juga mengembalikan Boot Engine ke Otomatis. Jangan pernah mengubahnya di tengah event.
Local API dan Remote control
Sejak 5.9.2.0, aplikasi lain — di PC ini atau di jaringan yang sama — bisa mengendalikan booth yang sedang berjalan: memulai atau menghentikan event, memulai sesi tamu, memilih template, mengambil foto, foto ulang, memproses, mencetak, menampilkan kode QR, dan kembali ke Home. Cara termudah tidak perlu coding sama sekali: Remote control di HP Anda.

- Aktifkan Local API — mati secara default. Klik Simpan Pengaturan untuk menerapkan.
- Port — default
8730. Ubah hanya jika port itu sudah dipakai program lain. - Kata sandi — wajib di setiap panggilan. Jika dikosongkan, dibuatkan otomatis saat menyimpan. Kata sandi baru membuat yang baru; aplikasi dan HP yang memakai kata sandi lama berhenti bekerja sampai diberi yang baru.
- Izinkan perangkat lain di jaringan — mati: hanya aplikasi di PC ini yang bisa terhubung. Hidup: perangkat apa pun di jaringan yang sama bisa, dengan kata sandi. Windows mungkin sekali bertanya untuk mengizinkan Q-Booth melewati firewall — izinkan.
- Sandbox → Buka — halaman uji di browser dengan tombol untuk setiap perintah (ketik kata sandi dulu) dan tautan Documentation. Untuk developer: referensi Local API.
- Remote control → Buka menampilkan remote di PC ini; Kode QR menampilkan kode untuk membukanya di HP.
Aturan booth tetap berlaku: pembayaran, PIN Start, PIN cetak, atau batas cetak tetap jalan, dan dialog di layar booth (pembayaran, PIN, QR, pemberitahuan) harus ditutup di booth dulu. Menghentikan event lewat cara ini tidak meminta PIN keluar. Setiap panggilan dicatat di log aplikasi (log\local_api\).
Sejak 5.9.4.0 aplikasi juga bisa menampilkan pemilih template dan layar hasilnya sendiri: daftar template dan kategori bisa dikirim lengkap dengan gambar cover masing-masing, dan panggilan "result" memberikan foto dan video tamu terakhir sebagai link yang bisa langsung ditampilkan aplikasi. Yang tersedia hanya hasil tamu terakhir — sejak halaman Hasil tampil sampai tamu berikutnya mulai — tidak pernah foto tamu sebelumnya.
Local API hanya koneksi lokal. Tidak bisa dipakai lewat internet, dan bukan layanan cetak cloud — orang lain tidak bisa mengirim foto mereka sendiri ke booth untuk dicetak. Contoh aplikasi siap pakai ada di Contoh Local API.
Remote control
Remote sederhana untuk booth dengan tombol besar, di HP atau tablet apa pun yang tersambung ke Wi-Fi yang sama. Tidak perlu memasang apa pun.
- Nyalakan Aktifkan Local API dan Izinkan perangkat lain di jaringan, lalu klik Simpan Pengaturan. Jika Windows menanyakan firewall, klik Allow.
- Di samping Remote control, klik Kode QR.
- Pindai kodenya dengan HP yang tersambung ke Wi-Fi yang sama dengan PC booth. HP langsung membuka remote, sudah tersambung.


Lampu hijau Online menandakan remote tersambung; panel di bawahnya menunjukkan event, halaman booth saat ini, dan langkah kamera. Tombol di remote berbahasa Inggris; gunakan dari atas ke bawah:
- Event — pilih event, lalu Start event atau Stop event.
- Session — Start session sama dengan tombol Start tamu; Home mengakhiri sesi dan kembali ke halaman Welcome.
- Template — pilih template, lalu Pick. Sejak 5.9.4.0 remote menampilkan cover template untuk dipilih.
- Camera — tombol besar Shoot memulai hitung mundur di booth; lalu Retake atau Process.
- Result — Print dan QR Share untuk hasil yang tampil di layar. Sejak 5.9.4.0 remote juga menampilkan foto tamu setelah diproses.
Tombol yang redup berarti booth belum bisa melakukannya sekarang (halaman berbeda, ada dialog terbuka, foto sedang diproses). PIN Start, pembayaran, atau PIN cetak tetap muncul di layar booth dan dijawab di sana, bukan di HP.
Kode QR membawa kata sandi: siapa pun yang memindainya bisa menjalankan booth. Jangan unggah atau sebarkan; jika bocor, klik Kata sandi baru lalu simpan. Remote hanya bekerja di jaringan lokal — ini bukan remote support dan tidak membuka akses ke PC.
Pemecahan masalah
Preview kamera hitam.
Atur Mesin Render Live View ke CPU, simpan, lalu buka ulang halaman kamera. Lihat juga pemecahan masalah Kamera.
AI Offline Server tetap offline.
Pengaturan Engine Komputasi di tab ini tidak memengaruhi AI Offline Server — mengganti Perangkat Komputasi tidak akan memperbaikinya. Lihat AI Offline Studio untuk kebutuhan server tersebut. Jika server tidak pernah berwarna hijau di lisensi Pro dengan kartu RTX, kirim log ke support (Ekspor Log).
Face Swap sangat lambat.
Dengan kartu NVIDIA RTX: atur Perangkat Komputasi ke GPU (atau Auto), Unduh Paket GPU, lalu restart. Tanpa NVIDIA, Face Swap berjalan di prosesor dan akan lebih lambat.
Saya sudah ganti ke GPU tapi tidak ada perubahan.
Restart aplikasi — Perangkat Komputasi baru berubah setelah restart.
Aplikasi terus tertutup sendiri tanpa pesan.
Periksa apakah Penanganan Error diatur ke Silent, lalu kirim log ke support.
Opsi GPU tidak bisa dipilih.
Tidak ada kartu grafis NVIDIA yang terdeteksi. Mode GPU membutuhkan kartu NVIDIA RTX seri 30 atau lebih baru; selain itu gunakan Auto atau CPU. Lihat kebutuhannya di Kebutuhan sistem.
Sebagian pemeriksaan engine gagal.
Perbarui driver grafis NVIDIA, restart komputer, lalu jalankan Tes Lagi. Sampai lulus, gunakan Auto atau CPU.
Video fps tinggi patah-patah atau lambat.
Ganti Engine Pemutar Video ke VLC dan unduh pack VLC. Ingat, tombol tidak bisa tampil di atas video VLC.
Foto Face Swap pertama di sebuah sesi lambat.
Itu karena engine sedang dimuat. Gunakan Boot Hangat (GPU — restart aplikasi setelah mengubahnya) atau Tetap Dimuat (CPU), dan ambil satu foto uji sebelum tamu datang.
Sandbox atau remote tidak terbuka.
Nyalakan Aktifkan Local API dan klik Simpan Pengaturan dulu. Jika baris di bawah sakelar menampilkan Could not start, port dipakai program lain — pilih Port lain lalu simpan.
HP saya tidak bisa membuka remote.
Nyalakan Izinkan perangkat lain di jaringan dan simpan, izinkan Q-Booth di prompt firewall Windows, dan pastikan HP tersambung ke Wi-Fi yang sama dengan PC booth (bukan data seluler, bukan jaringan tamu yang memisahkan perangkat). Lalu tampilkan Kode QR lagi dan pindai.
Tombol remote redup, atau perintah ditolak.
Booth belum bisa melakukannya sekarang — sedang di halaman lain, ada dialog terbuka di layar booth, atau foto sedang diproses. Tutup dialog di booth (pembayaran, PIN, QR, pemberitahuan) lalu coba lagi.
Langkah selanjutnya
Masih butuh bantuan?
Tim kami siap membantu lewat WhatsApp. Sebutkan versi Q-Booth dan apa yang muncul di layar.