Dokumentasi

Panduan ini ditulis dari versi aplikasi saat ini. Bagian bertanda Beta sudah bisa dipakai tetapi belum teruji luas di lapangan.

Mulai cepat

Unduh dan pasang SpacynBooth-Setup.exe (lihat Instalasi).
Buka aplikasi, ikuti panduan awal (bahasa, PIN operator, uji mesin, cek perangkat).
Hubungkan kamera: webcam, atau scan QR dari HP.
Tekan Mulai acara di konsol dan serahkan layar ke tamu.

Tanpa akun pun booth jalan dalam mode uji coba (14 hari atau 100 sesi). Akun Google dipakai untuk saldo, pembaruan, dan QRIS.

Instalasi

Syarat: Windows 10 atau 11 (64-bit), webcam atau HP sebagai kamera. Printer dan lampu opsional.

Jalankan installer. Bila muncul Windows protected your PC, klik More info lalu Run anyway. Aplikasi belum bertanda tangan digital; bandingkan SHA-256 berkas dengan yang tertera di halaman unduh.
Pilih folder dan centang pintasan. Jalankan sebagai Administrator bila ingin aturan Firewall dibuat otomatis; bila tidak, izinkan saat Windows bertanya, untuk jaringan Private.
Antivirus kadang menandai people_sidecar.exe (pendeteksi orang, dibuat dengan PyInstaller). Tambahkan folder Spacyn Booth ke pengecualian bila perlu.

Data pengguna (pengaturan, foto, riwayat) ada di %APPDATA%\Godot\app_userdata\Spacyn Booth dan tidak tersentuh pembaruan. copot.bat menghapus aplikasi, dan kembalikan.bat memulihkan versi sebelumnya.

Aktivasi dan lisensi

Di konsol: Sesi → Lisensi dan akun → Hubungkan ke akun Spacyn. Booth menampilkan kode dan QR; buka halaman aktivasi, masuk dengan Google, setujui Syarat Penggunaan, lalu masukkan kode. Lisensi tersimpan di server, diperpanjang otomatis, dan bisa dicabut bila mesin hilang. 100 sesi pertama gratis.

Mesin yang sudah terdaftar di satu akun tidak bisa didaftarkan ke akun lain. Jam komputer tidak boleh dimundurkan; booth mendeteksinya.

Panduan pertama kali

Langkah awal: bahasa layar tamu dan nama acara, PIN operator (wajib diganti; PIN seperti 1234 atau 0000 ditolak), uji mesin otomatis yang memilih profil performa, dan cek perangkat. Semuanya bisa diubah lagi di konsol. Masuk ke konsol dari layar tamu dengan menekan lama sudut kanan-bawah lalu memasukkan PIN.

Onboarding partner dari nol

Urutan ini membawamu dari belum punya apa-apa sampai booth siap dipakai di acara. Kerjakan berurutan; tiap langkah menyebut di mana pengaturannya.

A. Siapkan peralatan

Kebutuhan	Minimal	Disarankan
Komputer booth	Windows 10/11 64-bit, 4 inti, RAM 8 GB, layar sentuh atau monitor + mouse	6 inti ke atas, GPU terpisah, layar sentuh 21 inci ke atas, SSD
Kamera	Webcam USB 1080p atau HP sebagai kamera	Mirrorless/DSLR dengan utilitas webcam, plus 1 sampai 3 HP sebagai sudut tambahan
Jaringan	Satu Wi-Fi yang sama untuk komputer dan HP	Router kecil milik sendiri (hindari client isolation Wi-Fi venue)
Printer (opsional)	Printer foto 4x6 yang terpasang di Windows	Dua printer agar ada cadangan; stok kertas sesuai perkiraan sesi
Pencahayaan	Lampu ruangan yang merata	Lampu depan lembut; lampu LED WLED atau DMX untuk efek (opsional)
Listrik	Stop kontak dekat booth	UPS kecil agar sesi tidak putus saat listrik berkedip

B. Daftar dan pasang

Buka halaman Unduh, unduh installer, lalu jalankan. Pesan SmartScreen: More info → Run anyway.
Buka halaman Dasbor host, masuk dengan Google, setujui Syarat Penggunaan. 100 sesi gratis langsung masuk saldo.
Di aplikasi: Sesi → Lisensi dan akun → Hubungkan, scan QR, setujui di HP. Status berubah jadi berlisensi.

C. Panduan awal di aplikasi

Pilih bahasa layar tamu dan isi nama acara (tampil di bingkai, galeri, dan layar sapa).
Ganti PIN operator (4 sampai 8 angka; 1234 dan 0000 ditolak). Catat PIN ini.
Biarkan uji mesin otomatis memilih profil performa. Bila komputer pas-pasan, pilih profil Rendah.
Cek perangkat: kamera, printer, ffmpeg, penyimpanan, jaringan. Perbaiki yang berwarna merah sebelum lanjut.

D. Atur booth

Venue: letakkan kamera, titik berdiri, dan lampu di denah. Simpan sebagai preset lokasi supaya bisa dipanggil lagi.
Tampilan dan Game → Tema dan karakter: pilih tema dan karakter bawaan. Ingin tema khusus? Lihat Tema khusus.
Template frame: pilih bingkai yang dipakai tiap paket, atau unggah template PNG sendiri.
Mode permainan: nyalakan gaya yang ditawarkan ke tamu (bebas, ikuti pose, acak, tantangan).
Sesi → Cetak dan kertas: pilih printer, ukuran kertas, jumlah salinan, cetak otomatis.
Sesi → Pembayaran: gratis, voucher, staf, atau QRIS. Atur harga per paket (kosong berarti pakai harga dasar).
Sesi → Tamu dan berbagi: galeri HP, buku tamu, formulir kontak, retensi foto.

E. Uji sebelum acara

Tekan Lihat tamu dan lakukan satu sesi penuh: sapa, karakter, paket, gaya, jepret, pilih, edit, selesai.
Scan QR galeri dengan HP lain; pastikan foto terbuka dan bisa diunduh.
Cetak satu lembar (matikan mode demo) dan cek warna serta potongan.
Bila memakai QRIS, uji satu transaksi kecil.

F. Hari acara

Tiba lebih awal, pasang, nyalakan, jalankan Cek kesehatan di Dashboard.
Tekan Mulai acara. Scan QR operator di Dashboard supaya kamu memantau dari HP (Operator dari HP).
Selama acara: pantau kertas, antrean cetak, dan peringatan di HP operator.
Selesai: Akhiri acara, ekspor laporan, cadangkan foto bila perlu.

Kamera

Webcam

Terdeteksi otomatis lewat ffmpeg. Pilih kamera di Dashboard atau Venue.

DSLR atau mirrorless

Pakai sebagai webcam lewat utilitas bawaan merek (mis. EOS Webcam Utility). Booth melihatnya seperti webcam biasa.

HP sebagai kamera

Scan QR dari konsol atau dari layar tamu (+ Sudut kamera dari HP-mu). Tidak perlu aplikasi. Maksimal tiga kamera tambahan dari tamu.

Deteksi orang dan wajah

Kamera hanya menghitung orang dan mendeteksi wajah untuk stiker dan saran pose. Model berjalan offline di komputer booth.

HP dan jaringan

HP dan komputer booth harus satu jaringan. Pilihan paling andal: router kecil milik sendiri atau hotspot. Wi-Fi venue sering memakai client isolation yang memblokir HP dari komputer booth.

Dashboard → Jaringan HP → Pindai dan rekomendasi mengecek jaringan dan menyarankan susunan terbaik.
Mode Publik memakai tunnel Cloudflare (alamat acak tiap nyala) bila HP tidak bisa satu jaringan.
Sertifikat HTTPS bersifat self-signed: HP akan meminta kamu menerima peringatan sekali.

Printer

Semua printer yang terpasang di Windows muncul otomatis. Atur kertas per printer, sisa lembar, dan strategi: seimbang atau cadangan. Cetakan yang macet atau gagal dibatalkan dan diulang di printer lain. Status kertas habis dari printer jaringan sering tidak terbaca, jadi isi sisa lembar manual.

Mode demo dan profil uji tidak mencetak sungguhan.

Paket dan frame

Paket: strip (2 atau 3 foto), strip kembar, polaroid, dan kotak 4. Frame: 24 bawaan dan editor frame untuk template PNG milikmu. Tamu bisa memilih frame bila lebih dari satu aktif. Tanda powered by spacyn tampil kecil dan memberi cashback; boleh dimatikan.

Pose dan game

131 formasi untuk 1 sampai 5 orang. Mode: bebas gaya, ikuti pose, acak (roulette), dan tantangan berskor dari kerangka tubuh (butuh HP yang mengirim kerangka). Paket acara memilih kumpulan pose; properti (topi, kacamata, papan) aktif lewat centang operator.

Stiker dan edit

Stiker menempel ke wajah bila wajah terdeteksi. Hapus latar memakai model offline; benda yang dipegang kadang ikut terpotong. Paket acara stiker dinyalakan di Sesi → Foto dan stiker.

Edit bareng dari HP

Peran	Bisa
Pemain utama	Semua kontrol, mengunci edit bareng
Kamera tambahan	Hanya mengirim gambar (maks 3)
Editor	Stiker, frame, filter, susun slot. Tidak bisa mulai, selesai, atau ulangi

Operator dari HP

Dashboard menampilkan QR Operator di HP. Masukkan PIN operator. Tab: Ringkasan, Layar (live view), Sesi (cetak ulang, bagikan, hapus), Kontrol (paket, voucher, pembayaran), Perangkat. Peringatan kertas, PIN bawaan, dan disk berbunyi dan bergetar saat halaman terbuka. Setelah lima PIN salah, akses terkunci satu menit.

Pembayaran dan saldo

Saldo prabayar: top up di halaman dasbor host; biaya per sesi selesai dipotong otomatis. 100 sesi pertama gratis.
Tamu membayar QRIS: Beta QR dinamis per sesi; uang masuk ke akun Xendit milik host. Pembayaran yang lunas tetapi tidak terpakai masuk daftar perlu refund.
Alternatif: voucher, tunai dengan konfirmasi staf, atau gratis.

Privasi tamu

Foto tersimpan di komputer booth. Layar tamu menampilkan pemberitahuan singkat; galeri HP punya tombol Hapus foto sesi ini. Retensi otomatis diatur di Sesi → Penyimpanan. Lihat Kebijakan Privasi.

Tema khusus dan template marketplace

Kami bisa membuat tema khusus untuk acara atau brand-mu: warna, font, bingkai, stiker, latar, dan karakter pendamping. Ada dua jalan:

Dari aplikasi: Tampilan dan Game → Tema dan karakter → Minta tema khusus. Isi nama acara, tanggal, konsep, palet warna, dan lampirkan gambar acuan (maksimal 4). Permintaan langsung terkirim ke tim Spacyn dan kami membalas lewat email akunmu.
Lewat email: partner@spacyn.id, sertakan hal yang sama.

Tema jadi dipasang lewat pembaruan. Segera Marketplace template akan menjual tema, bingkai, paket stiker, dan karakter; koleksi awal dari tim Spacyn dan tema pesanan. Daftar tunggu: partner@spacyn.id.

Pemecahan masalah

Gejala	Coba
HP tidak bisa membuka halaman kamera	Pastikan satu jaringan dan Firewall mengizinkan jaringan Private; jalankan Pindai dan rekomendasi.
Hapus latar atau stiker tidak jalan	Cek `people_sidecar.exe` tidak diblokir antivirus; profil performa Rendah mematikan hapus latar.
Cetak tidak keluar	Cek antrean Windows dan sisa lembar; coba Bersihkan antrean di tab Perangkat HP operator.
Layar tidak benar-benar penuh (taskbar atau bingkai jendela terlihat)	Tekan `F11`, atau Sesi → Mesin dan keamanan → Layar dan grafis → Layar penuh.
Layar terlihat terpotong	Sesi → Mesin dan keamanan → Layar dan grafis: pilih Layar penuh dan atur ukuran tampilan konsol.
Lisensi menunjukkan demo	Hubungkan akun lagi dan tekan Check-in sekarang; periksa jam komputer.

Masih buntu? Di Dashboard ada tombol Paket diagnostik (tanpa foto tamu) yang bisa dikirim ke kami.