HandyCafe Docs
owner it-admin

Cara Mengonfigurasi Desktop Klien

Panduan ini memandu Anda melalui proses membangun menu aplikasi yang dilihat pelanggan di PC mereka, menerapkan tema visual, menyiapkan layar idle, dan mempublikasikan pengumuman. Setiap perubahan yang Anda buat di server langsung dikirimkan ke klien yang terhubung melalui TCP.

Cara Membangun Menu Aplikasi

Menu aplikasi adalah antarmuka yang digunakan pelanggan selama sesi berlangsung. Menu ini diorganisasikan ke dalam kategori, masing-masing berisi satu atau lebih aplikasi. Anda mengelola seluruh katalog dari server.

Yang Anda butuhkan

  • HandyCafe Server yang berjalan dengan setidaknya satu klien yang terhubung.
  • Aplikasi yang sudah terinstal di PC klien (untuk jenis Game dan App).
  • Gambar ikon (PNG, JPG, atau WebP) yang siap diunggah. Ukuran yang disarankan adalah 128x128 piksel.

Langkah-langkah

  1. Buka aplikasi HandyCafe Server dan navigasikan ke Settings di sidebar kiri.
  2. Pilih tab Clients di bagian atas, lalu beralih ke sub-tab Content.
  3. Di panel Categories di sebelah kiri, klik tombol Add Category.
  4. Masukkan nama kategori seperti "Games" atau "Browsers" dan konfirmasi. Kategori baru akan muncul di daftar.
  5. Pilih kategori yang baru saja Anda buat. Di panel kanan, klik Add App.
  6. Isi detail aplikasi. Masukkan Name (misalnya "Counter-Strike 2"), Description opsional, dan atur field Kind ke jenis yang sesuai: Game, Browser, Link, File, atau App.
  7. Di field Executable Path, masukkan jalur lengkap ke aplikasi di PC klien. Contohnya: C:\Program Files\Steam\steamapps\common\CS2\cs2.exe. Untuk jenis Link, masukkan URL sebagai gantinya.
  8. Unggah ikon dengan mengklik area ikon. Anda dapat menempelkan URL untuk mengambil gambar dari web atau menelusuri file lokal di mesin Anda. Ikon akan tampil di grid aplikasi klien.
  9. Opsional, unggah Poster Image untuk tampilan kartu yang lebih kaya. Ini adalah gambar besar yang ditampilkan pada mode tampilan poster-first. Anda juga dapat mengaktifkan tombol Hero Carousel untuk menampilkan aplikasi ini di banner berputar di bagian atas desktop klien.
  10. Seret item di daftar kategori atau daftar aplikasi untuk mengatur urutannya. Aktifkan sakelar visibilitas di samping aplikasi mana pun untuk menyembunyikannya tanpa menghapus. Klik Save setelah selesai.

Hasil yang diharapkan

Semua desktop klien yang terhubung diperbarui dalam hitungan detik. Kategori dan aplikasi baru muncul di grid aplikasi klien. Pelanggan dapat meluncurkan aplikasi dengan mengklik kartu mereka.

Kesalahan umum

  • Memasukkan jalur yang tidak ada di PC klien. Kartu aplikasi akan muncul tetapi peluncuran akan gagal. Selalu verifikasi jalur executable di mesin klien yang sebenarnya.
  • Lupa menyimpan setelah melakukan perubahan. Perubahan yang belum disimpan tidak dikirimkan ke klien.
  • Menggunakan gambar berukuran besar tanpa kompresi. Meskipun resolusi apa pun dapat digunakan, gambar yang lebih besar dari 512x512 memperlambat sinkronisasi tanpa manfaat visual pada ukuran kartu.

Cara Mengatur Tema Desktop

Tema mengontrol tampilan keseluruhan desktop klien selama sesi aktif. Anda memilih tema warna, preset tata letak, kepadatan kartu, dan pengaturan latar belakang.

Yang Anda butuhkan

  • HandyCafe Server yang berjalan.
  • Untuk latar belakang gambar atau video: file media dalam format PNG, JPG, WebP, MP4, atau WebM.

Langkah-langkah

  1. Navigasikan ke Settings > Clients > Appearance tab.
  2. Di bawah Theme, pilih salah satu tema warna yang tersedia: Neon Arena (estetika gaming biru-ungu), Crimson Pulse (nada merah-gelap), atau Emerald Depth (palet hijau-teal). Pratinjau diperbarui saat Anda membuat pilihan.
  3. Di bawah Layout Preset, pilih cara konten disusun di layar. Pilihannya adalah Split Classic (kategori di kiri, aplikasi di kanan), Hero Wide Top (carousel hero besar di atas, aplikasi di bawah), Catalog Wide Bottom (hero ringkas, grid aplikasi lebih lebar), atau Compact Focus (chrome minimal, ruang aplikasi maksimal).
  4. Atur Card Density untuk mengontrol berapa banyak aplikasi yang muat di layar sekaligus. Large menampilkan kartu yang lebih besar dengan lebih banyak detail. Medium menyeimbangkan ukuran dan kuantitas. Compact memasukkan aplikasi paling banyak per baris.
  5. Konfigurasikan Background. Pilih jenisnya: Solid (pilih warna), Gradient (pilih dua warna), Image (unggah file), atau Video (unggah MP4/WebM). Untuk jenis Image dan Video, sesuaikan slider Overlay Opacity untuk menggelapkan latar belakang di balik kartu, dan slider Blur untuk memperlembutnya.
  6. Klik Save. Tema langsung dikirimkan ke semua klien yang terhubung.

Hasil yang diharapkan

Desktop klien diperbarui dengan pengaturan visual baru. Tema, tata letak, ukuran kartu, dan latar belakang semuanya diperbarui tanpa perlu klien melakukan restart.

Kesalahan umum

  • Menggunakan latar belakang video dengan ukuran file yang sangat besar. Pertahankan video di bawah 20 MB untuk sinkronisasi yang cepat. Video yang lebih panjang atau beresolusi lebih tinggi menyebabkan waktu muat yang terlihat di PC klien.
  • Menetapkan opasitas overlay terlalu rendah pada gambar latar belakang yang sibuk. Teks dan label kartu menjadi sulit dibaca. Overlay 40-60% cocok untuk sebagian besar gambar.

Cara Mengonfigurasi Layar Idle

Layar idle adalah apa yang dilihat pelanggan ketika sebuah PC tidak digunakan. Layar ini dapat menampilkan slideshow gambar atau video, jam, dan nama kafe Anda.

Yang Anda butuhkan

  • File gambar (PNG, JPG, WebP, atau GIF) atau file video (MP4, WebM) untuk slideshow.
  • HandyCafe Server yang berjalan.

Langkah-langkah

  1. Navigasikan ke Settings > Clients > Idle Screen tab.
  2. Aktifkan Enable Slideshow ke posisi on.
  3. Klik Add Media untuk mengunggah gambar atau video. Anda dapat menambahkan beberapa item. Format yang didukung adalah PNG, JPG, WebP, GIF, MP4, dan WebM.
  4. Atur Duration untuk setiap item dalam detik. Ini mengontrol berapa lama setiap slide terlihat sebelum beralih. Nilai antara 8 dan 15 detik cocok untuk sebagian besar pengaturan.
  5. Pilih efek Transition: Fade (crossfade opasitas halus), Slide (geser horizontal), atau Zoom (efek perbesar).
  6. Aktifkan tombol Clock Overlay untuk menampilkan jam digital di layar idle. Gunakan pemilih warna untuk mengatur warna teks jam agar kontras maksimal terhadap konten slideshow Anda.
  7. Aktifkan tombol Cafe Name untuk menampilkan nama bisnis Anda di layar idle. Nama diambil dari pengaturan server umum Anda.
  8. Klik Save. Konfigurasi layar idle dikirimkan ke semua klien yang terhubung.

Hasil yang diharapkan

PC klien yang tidak dalam sesi aktif menampilkan slideshow dengan transisi yang dikonfigurasi, overlay jam, dan nama kafe. Slideshow berputar terus-menerus.

Kesalahan umum

  • Menambahkan terlalu banyak gambar beresolusi tinggi tanpa mempertimbangkan waktu sinkronisasi. Setiap file media harus ditransfer ke setiap klien. Pertahankan total ukuran slideshow yang wajar.
  • Menetapkan durasi terlalu singkat (di bawah 3 detik). Transisi cepat dapat terasa mengejutkan dan mempersulit membaca teks apa pun di slide.
  • Tidak menguji warna jam terhadap semua gambar slideshow. Jam berwarna putih tidak terlihat pada slide putih yang cerah. Pilih warna yang cocok di seluruh set slideshow Anda.

Cara Membuat Pengumuman

Pengumuman muncul di desktop klien dan dapat mempromosikan acara, berbagi berita, atau menampilkan iklan. Sistem secara otomatis melacak tayangan dan klik.

Yang Anda butuhkan

  • HandyCafe Server yang berjalan dengan setidaknya satu klien yang terhubung.
  • Gambar banner (disarankan 1200x400 piksel atau lebih lebar) jika Anda menginginkan pengumuman visual.

Langkah-langkah

  1. Navigasikan ke Settings > Clients > Content tab.
  2. Gulir ke bagian Announcements di bawah kategori aplikasi.
  3. Klik Add Announcement.
  4. Masukkan Title dan Text untuk pengumuman. Jika menautkan ke halaman eksternal, masukkan URL Link.
  5. Atur field Type. Pilih Announcement untuk berita umum, Event untuk promosi terbatas waktu dengan field formulir interaktif, atau Text untuk pesan hanya teks yang sederhana.
  6. Atur Category untuk mengklasifikasikan pengumuman: Link, Game, Announcement, atau Ad. Ini menentukan di mana pengumuman muncul dalam tata letak klien.
  7. Unggah Banner Image dengan mengklik area gambar dan memilih file. Banner ditampilkan di bilah pengumuman di desktop klien. Klik Save.

Hasil yang diharapkan

Pengumuman muncul di desktop klien yang terhubung di bilah pengumuman. Saat pelanggan melihat dan berinteraksi dengannya, server melacak Impression Count (berapa kali ditampilkan) dan Click Count (berapa kali pelanggan mengkliknya).

Kesalahan umum

  • Membuat pengumuman tanpa gambar banner. Pengumuman hanya teks tanpa gambar mudah diabaikan oleh pelanggan di bilah pengumuman.
  • Lupa menetapkan kedaluwarsa atau menghapus pengumuman yang sudah usang. Promosi lama yang tetap aktif menciptakan pengalaman pelanggan yang buruk.
  • Menggunakan teks yang sangat panjang di badan pengumuman. Area tampilan sangat ringkas. Pertahankan teks yang singkat dan letakkan detail di balik tautan.