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.

11 menit baca Diperbarui 8 Nov 2026 Tonton videonya (2:13)

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.

Catatan

Jika tab Lanjutan tidak terlihat, aktifkan Tampilkan semua pengaturan di kiri bawah jendela Pengaturan Aplikasi.

Tab Lanjutan dengan Mesin Render Live View, Engine Pemutar Video, Penanganan Error, dan Engine Komputasi
Tab Lanjutan (di versi terbaru, Jalankan Event Otomatis, Mulai ulang otomatis saat event, dan Simpan versi asli muncul di atas dan di antara opsi-opsi ini).

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.

  1. Aktifkan Jalankan Event Otomatis saat Aplikasi Dibuka.
  2. Pilih Event yang dijalankan.
  3. 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.

Tips

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.
Penting

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

PilihanKapan dipakai
GPU (default)Memakai kartu grafis untuk menampilkan preview kamera. Halus dan ringan bagi prosesor.
CPUPakai 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

PilihanKelebihanKekurangan
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.
VLCMemutar 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.

Penting

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

PilihanFungsi
Auto (default)Memakai kartu grafis bila bisa, jika tidak memakai prosesor. Disarankan untuk kebanyakan perangkat.
CPUSelalu memakai prosesor. Berjalan di komputer apa pun, tetapi Face Swap dan Face Restore lebih lambat.
GPUSelalu 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.

  1. Pastikan koneksi internet stabil — paketnya besar (sekitar 2,4 GB). Lakukan di studio, bukan di lokasi event.
  2. Klik Unduh Paket GPU dan tunggu sampai selesai diunduh dan dipasang.
  3. Atur Perangkat Komputasi ke GPU (atau biarkan Auto).
  4. 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:

PerangkatPilihanEfek
GPUOtomatisQ-Booth memilih mode terbaik untuk kartu Anda. Disarankan.
Boot HangatBerpindah template tanpa jeda, tetapi menahan sekitar 3 GB memori grafis sepanjang sesi.
Boot DinginTidak 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 DimuatDisarankan. Dimuat sekali pada foto pertama lalu tetap siap; memakai sekitar 2,5 GB memori sampai aplikasi ditutup.
Bebaskan Tiap FotoMembebaskan 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.

Penting

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.

Bagian Local API di tab Lanjutan: Aktifkan Local API, Port 8730, Kata sandi dengan tombol Kata sandi baru, Izinkan perangkat lain di jaringan, Sandbox dan Remote control dengan tombol Buka dan Kode QR
Bagian Local API di bawah tab Lanjutan (kata sandi diburamkan di gambar ini; gambar dari aplikasi berbahasa Inggris).
  • 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.

  1. Nyalakan Aktifkan Local API dan Izinkan perangkat lain di jaringan, lalu klik Simpan Pengaturan. Jika Windows menanyakan firewall, klik Allow.
  2. Di samping Remote control, klik Kode QR.
  3. Pindai kodenya dengan HP yang tersambung ke Wi-Fi yang sama dengan PC booth. HP langsung membuka remote, sudah tersambung.
Jendela kode QR remote control dengan alamat remote dan catatan bahwa kode berisi kata sandi
Jendela kode QR. Kode ini berisi kata sandi, jadi jangan dibagikan (kode di gambar ini hanya contoh).
Remote control di HP: lampu Online, panel status, Event dengan Start event dan Stop event, Session dengan Start session dan Home, Template dengan Pick, Camera dengan Retake, Shoot dan Process, Result dengan Print dan QR Share
Remote di HP, saat event berjalan dan booth di halaman Kamera.

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.
Tips

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.

Penting

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.

Chat via WhatsApp