HandyCafe Docs
owner cashier it-admin

Klien Legasi

HandyCafe boleh mengurus pemasangan klien V3 dan V4 bersama klien moden pada pelayan yang sama. Klien legasi muncul dalam Panel Pentadbir sebagai jenis kad tersendiri, dengan set tindakan yang lebih kecil mengikut apa yang disokong oleh protokol asal.

Sebelum anda boleh melihat klien legasi dalam Panel Pentadbir, aktifkan sokongan masa jalan di bawah Tetapan > Klien Legasi.

Cara Klien Legasi Muncul

Klien legasi bersambung ke pelayan melalui protokol multicast UDP asal. Mereka tidak menggunakan mDNS seperti klien moden. Sebaliknya, pelayan mengesan mereka dengan dua cara:

Laluan Pengesanan Pencetus
Log masuk TCP Klien menghantar LoginRequest pada port arahan TCP. Pelayan merekodkan peer dan menghantar acara connected.
Ping UDP Klien menyiarkan bingkai Ping pada kumpulan multicast. Pelayan menerimanya, mengemas kini rekod peer dan menghantar acara online.

Status per-MAC disimpan dalam stor klien legasi bersama IP, nama hos, pengguna yang log masuk, versi klien, pemasa sesi dan cap masa kali terakhir dilihat. Setiap bingkai masuk menetapkan semula pemasa ketidakaktifan. Jika pemasa tamat tanpa trafik (lalai 10 saat), klien ditandakan luar talian. Rekod itu kekal dalam pangkalan data supaya sejarah tidak hilang.

Kad Klien Legasi

Setiap klien legasi dipaparkan sebagai kad yang berbeza daripada kad klien moden. Pengepala menunjukkan nama paparan (nama hos apabila tersedia, MAC jika tidak), lencana dalam talian atau luar talian dengan warna, dan label status.

Warna dan Label Status

Status Warna Maksud
Dalam Talian Hijau Sesi aktif sedang berjalan.
Melahu Sian Klien bersambung dan menunggu. Tiada sesi aktif.
Dijeda Amber Sesi dijeda. Pengebilan dihentikan.
Sibuk Ungu Klien sedang memproses permintaan.
Pembayaran Rose Klien berada dalam aliran pembayaran.
Pentadbir Indigo Klien berada dalam mod pentadbir atau penyelenggaraan.
Luar Talian Kelabu Tiada trafik terkini. Tindakan dilumpuhkan sehingga klien kembali dalam talian.
Bermasa Biru Langit Sesi terhad masa sedang berjalan dengan tarikh akhir.

Jam Sesi

Apabila sesi aktif, kad memaparkan blok jam:

  • Masa mula.
  • Masa tamat (untuk sesi terhad masa).
  • Minit yang digunakan.
  • Minit baki dengan kira detik langsung.
  • Kos terkumpul.

Maklumat Identiti

Kad sentiasa memaparkan:

  • Alamat MAC.
  • Alamat IP.
  • Versi klien (contohnya "3.4.01").
  • Pengguna yang log masuk, jika ada.

Bar Alat Tindakan

Apabila klien berada dalam talian, bar alat tindakan di bawah maklumat identiti menawarkan operasi yang tersedia.

Kawalan Sesi

Butang Kelihatan Apabila Tingkah Laku
Log masuk Status ialah melahu Membuka dialog Device Login. Pilih minit dan kaedah pembayaran. Pelayan menghantar arahan Login dengan nilai yang dipilih. Sesi bermula pada klien.
Log keluar Status ialah dalam talian, bermasa, dijeda, sibuk atau pembayaran Jika sesi ialah pascabayar, dialog pembayaran mengumpul jumlah dan kaedah. Satu transaksi ditulis ke lejar. Pelayan menghantar arahan Logout. Sesi ditutup pada klien.

Tambah Masa

Membuka pemilih minit. Menerima nilai positif (lanjut) atau negatif (tolak). Magnitud maksimum ialah 10,000 minit ke mana-mana arah. Berfungsi untuk sesi prabayar dan pascabayar.

Jika anda mengkonfigurasikan nilai minit pratetap dalam tetapan harga, kad juga memaparkan baris butang pratetap. Ketik pratetap untuk menggunakan nilai itu tanpa membuka pemilih.

Tangkapan Skrin

Meminta tangkapan skrin langsung daripada klien legasi melalui port pemindahan fail. Alirannya ialah:

  1. Pelayan menghantar arahan permintaan tangkapan skrin.
  2. Klien membuka pendengar TCP jangka pendek pada port sementara.
  3. Pelayan bersambung, menghantar pengepala pemindahan fail 9 bait dan menunggu.
  4. Klien menangkap skrin, mengekodnya sebagai BMP termampat, dan menstrimkannya kembali.
  5. Pelayan menyahmampat BMP dan menyimpannya dalam folder legacy_screenshots di bawah direktori data HandyCafe anda.
  6. Pemapar tangkapan skrin dibuka dengan imej baharu.

Jika klien tidak memberi respons dalam masa tamat (lalai 30 saat untuk bersambung, 20 saat untuk data), permintaan gagal dan toast ralat muncul. Anda boleh cuba semula serta-merta.

Tindakan Kuasa

Tindakan Pengesahan Kesan
Log keluar Windows Tiada Melog keluar pengguna Windows pada mesin klien. Sesi Windows tamat tetapi komputer kekal hidup.
But semula Ya Menghantar arahan but semula. Mesin klien dimulakan semula.
Matikan Ya Menghantar arahan matikan. Mesin klien dimatikan.

But semula dan Matikan memaparkan dialog pengesahan untuk mengelakkan tindakan kuasa yang tidak sengaja.

Operasi Tidak Disokong

Klien legasi tidak menyokong semua ciri yang tersedia pada klien HandyCafe moden. Jurang utama:

  • Tiada pelarasan jeda pertengahan sesi. Perubahan masa yang dihantar semasa sesi dijeda akan beratur tetapi klien mungkin mengabaikannya. Sambung semula sesi dahulu, gunakan perubahan, kemudian jeda semula jika perlu.
  • Tiada mod pentadbir melalui arahan pelayan. Status pentadbir dalaman klien tidak boleh diubah dari pelayan. Mod pentadbir hanya dikawal pada mesin klien itu sendiri.
  • Tiada pendaftaran lesen dari pelayan. Pelayan mencerminkan bait lesen yang dilihatnya dalam bingkai klien tetapi tidak boleh menolak lesen baharu ke klien. Daftarkan klien secara tempatan.
  • Tiada integrasi dompet ahli untuk sesi yang dimulakan pada klien legasi. Pembayaran direkodkan sebagai baris transactions biasa dengan transaction_type=sessions dan MAC klien. Aliran dompet moden tidak terpakai.
  • Tiada desktop jauh. Ciri desktop jauh menggunakan laluan penstriman UDP yang tidak terdapat dalam klien legasi.
  • Tiada tolakan penyegerakan fail. Sync Explorer menolak fail hanya melalui protokol moden.

Untuk fungsi penuh, migrasikan kepada klien HandyCafe moden jika boleh.

Tingkah Laku Luar Talian

Apabila tamat masa ketidakaktifan, kad menjadi malap, lencana status bertukar kelabu, dan setiap butang tindakan dilumpuhkan. Rekod klien kekal dalam stor supaya sejarah, MAC, nama hos dan data kali terakhir dilihat dipelihara. Apabila klien kembali dalam talian (ping UDP baharu atau log masuk TCP), kad akan hidup semula dan tindakan menjadi tersedia semula.

Rekod ini tidak dipadam secara automatik. Untuk menghapuskan klien lama secara kekal, suntingnya dari pangkalan data pentadbir atau padam melalui alat pentadbir yang berkaitan.

Petua

  • Kekalkan tamat masa ketidakaktifan pada 10 saat melainkan anda tahu klien legasi anda menghantar suar lebih perlahan daripada itu. Tamat masa yang lebih pendek akan menandakan klien sihat sebagai luar talian semasa gangguan rangkaian singkat.
  • Jika klien legasi kelihatan dalam talian tetapi tidak memberi respons kepada arahan, sahkan Protocol Variant dalam Tetapan. Ketidakpadanan antara varian pelayan (STE berbanding Standard) dan binaan klien menyebabkan arahan digugurkan secara senyap.
  • Tangkapan skrin daripada klien legasi ialah BMP termampat, yang lebih besar daripada tangkapan PNG moden. Simpan folder legacy_screenshots pada pemacu yang mempunyai ruang kosong mencukupi jika anda mengambil banyak tangkapan.
  • Gunakan Tambah Masa dengan butang pratetap semasa peralihan syif. Satu ketikan memanjangkan sesi dengan kenaikan yang telah ditetapkan, yang lebih pantas daripada menaip minit secara manual.
  • Keluarkan klien legasi secara beransur-ansur. Migrasikan satu kumpulan pada satu masa, sahkan klien baharu berfungsi secara identik dalam Panel Pentadbir, dan hanya kemudian tamatkan yang lama.