HandyCafe Docs
owner cashier it-admin

العملاء القدامى

يمكن لـ HandyCafe إدارة تثبيتات العملاء V3 و V4 القدامى بجانب العملاء الحديثين على نفس الخادم. يظهر العملاء القدامى في لوحة الإدارة كنوع بطاقة خاص بهم، مع مجموعة إجراءات محدودة تتوافق مع ما يدعمه البروتوكول الأصلي.

قبل أن تتمكن من رؤية العملاء القدامى في لوحة الإدارة، قم بتمكين دعم وقت التشغيل تحت الإعدادات > العملاء القدامى.

كيف يظهر العملاء القدامى

يتصل العملاء القدامى بالخادم عبر بروتوكول UDP متعدد الإرسال الأصلي. لا يستخدمون mDNS مثل العملاء الحديثين. بدلاً من ذلك، يكتشفهم الخادم بطريقتين:

مسار الاكتشاف الزناد
تسجيل الدخول عبر TCP يرسل العميل طلب تسجيل دخول على منفذ أوامر TCP. يسجل الخادم النظير ويصدر حدث اتصال.
Ping عبر UDP يبث العميل إطار Ping على المجموعة متعددة الإرسال. يستقبله الخادم، يحدث سجل النظير، ويصدر حدث اتصال.

يتم الاحتفاظ بحالة كل عنوان MAC في مخزن العميل القديم مع عنوان IP، واسم المضيف، والمستخدم المسجل الدخول، وإصدار العميل، ومؤقتات الجلسة، وطابع زمني لآخر ظهور. كل إطار وارد يعيد ضبط مؤقت عدم النشاط. إذا تم تشغيل المؤقت بدون حركة (الافتراضي 10 ثواني)، يتم وضع علامة على العميل كغير متصل. يبقى السجل في قاعدة البيانات حتى لا تضيع السجل التاريخي.

بطاقة العميل القديم

يتم عرض كل عميل قديم كبطاقة مميزة عن بطاقات العملاء الحديثين. يظهر العنوان اسم العرض (اسم المضيف عند توفره، MAC عند عدم توفره)، وشارة متصلة أو غير متصلة مع اللون، وملصق الحالة.

ألوان وملصقات الحالة

الحالة اللون المعنى
متصل أخضر جلسة نشطة قيد التشغيل.
خامل سماوي العميل متصل وينتظر. لا توجد جلسة نشطة.
متوقف مؤقتًا كهرماني الجلسة متوقفة مؤقتًا. الفوترة متوقفة.
مشغول بنفسجي العميل يعالج طلبًا.
دفع وردي العميل في عملية دفع.
إدارة نيلي العميل في وضع الإدارة أو الصيانة.
غير متصل رمادي لا توجد حركة حديثة. الإجراءات معطلة حتى يعود العميل إلى الاتصال.
محدد بوقت سماوي فاتح جلسة محددة بوقت قيد التشغيل مع موعد نهائي.

ساعة الجلسة

عندما تكون الجلسة نشطة، تعرض البطاقة كتلة ساعة:

  • وقت البدء.
  • وقت الانتهاء (للجلسات المحددة بوقت).
  • الدقائق المستخدمة.
  • الدقائق المتبقية مع عد تنازلي مباشر.
  • التكلفة المتراكمة.

معلومات الهوية

تظهر البطاقة دائمًا:

  • عنوان MAC.
  • عنوان IP.
  • إصدار العميل (على سبيل المثال "3.4.01").
  • المستخدم المسجل الدخول إن وجد.

شريط الأدوات

عندما يكون العميل متصلاً، يوفر شريط الأدوات أسفل معلومات الهوية العمليات المتاحة.

التحكم في الجلسة

الزر مرئي عندما السلوك
تسجيل الدخول الحالة خامل يفتح حوار تسجيل الدخول للجهاز. حدد الدقائق وطريقة الدفع. يرسل الخادم أمر تسجيل الدخول بالقيم المختارة. تبدأ الجلسة على العميل.
تسجيل الخروج الحالة متصل، محدد بوقت، متوقف مؤقتًا، مشغول، أو دفع إذا كانت الجلسة مدفوعة لاحقًا، يجمع حوار الدفع المبلغ والطريقة. يتم كتابة معاملة في السجل. يرسل الخادم أمر تسجيل الخروج. تنتهي الجلسة على العميل.

إضافة وقت

يفتح منتقي الدقائق. يقبل القيم الإيجابية (تمديد) أو القيم السلبية (خصم). الحد الأقصى هو 10,000 دقيقة في أي اتجاه. يعمل لكل من الجلسات المدفوعة مسبقًا والمدفوعة لاحقًا.

إذا قمت بتكوين قيم دقائق مسبقة في إعدادات التسعير الخاصة بك، تعرض البطاقة أيضًا صفًا من الأزرار المسبقة. اضغط على زر مسبق لتطبيق القيمة دون فتح المنتقي.

لقطة الشاشة

يطلب لقطة شاشة حية من العميل القديم عبر منفذ نقل الملفات. التدفق هو:

  1. يرسل الخادم أمر طلب لقطة الشاشة.
  2. يفتح العميل مستمع TCP قصير العمر على منفذ مؤقت.
  3. يتصل الخادم، يرسل رأس نقل ملف 9 بايت، وينتظر.
  4. يلتقط العميل الشاشة، يرمزها كـ BMP مضغوط، ويبثها مرة أخرى.
  5. يقوم الخادم بفك ضغط BMP ويخزنها في مجلد legacy_screenshots ضمن دليل بيانات HandyCafe الخاص بك.
  6. يفتح عارض لقطة الشاشة مع الصورة الجديدة.

إذا لم يستجب العميل خلال المهلة (الافتراضي 30 ثانية للاتصال، 20 ثانية للبيانات)، يفشل الطلب وتظهر رسالة خطأ. يمكنك المحاولة مرة أخرى فورًا.

إجراءات الطاقة

الإجراء التأكيد التأثير
تسجيل الخروج لا يوجد يسجل خروج المستخدم من Windows على جهاز العميل. تنتهي جلسة Windows لكن الكمبيوتر يبقى قيد التشغيل.
إعادة التشغيل نعم يرسل أمر إعادة التشغيل. يعيد تشغيل جهاز العميل.
إيقاف التشغيل نعم يرسل أمر إيقاف التشغيل. يغلق جهاز العميل.

تظهر حوارات التأكيد لإعادة التشغيل وإيقاف التشغيل لمنع إجراءات الطاقة العرضية.

العمليات غير المدعومة

لا تدعم العملاء القدامى كل الميزات المتوفرة على عملاء HandyCafe الحديثين. الفجوات الرئيسية:

  • لا توجد تعديلات أثناء التوقف المؤقت للجلسة. التغييرات الزمنية المقدمة أثناء توقف الجلسة مؤقتًا يتم وضعها في قائمة الانتظار لكن العميل قد يتجاهلها. استأنف الجلسة أولاً، طبق التغيير، ثم أوقفها مؤقتًا مرة أخرى إذا لزم الأمر.
  • لا يوجد وضع إدارة عبر أمر الخادم. لا يمكن تبديل حالة الإدارة الداخلية للعميل من الخادم. يتم التحكم في وضع الإدارة فقط على جهاز العميل نفسه.
  • لا يوجد تسجيل ترخيص من الخادم. يعكس الخادم بايتات الترخيص التي يراها في إطارات العميل لكنه لا يمكنه دفع ترخيص جديد إلى العميل. سجل العميل محليًا.
  • لا يوجد تكامل محفظة الأعضاء للجلسات التي تبدأ على العملاء القدامى. يتم تسجيل المدفوعات كصفوف transactions عادية مع transaction_type=sessions و MAC العميل. لا تنطبق تدفقات المحفظة الحديثة.
  • لا يوجد سطح مكتب بعيد. يستخدم ميزة سطح المكتب البعيد مسار بث UDP غير موجود في العملاء القدامى.
  • لا يوجد دفع مزامنة الملفات. يدفع مستكشف المزامنة الملفات عبر البروتوكول الحديث فقط.

للحصول على الوظائف الكاملة، قم بالترقية إلى عملاء HandyCafe الحديثين عند الإمكان.

سلوك عدم الاتصال

عندما تنتهي مهلة عدم النشاط، تخفت البطاقة، تتحول شارة الحالة إلى اللون الرمادي، ويتم تعطيل كل زر إجراء. يبقى سجل العميل في المخزن حتى يتم الحفاظ على السجل التاريخي، وMAC، واسم المضيف، وبيانات آخر ظهور. عندما يعود العميل إلى الاتصال (Ping جديد عبر UDP أو تسجيل دخول عبر TCP)، تنشط البطاقة وتصبح الإجراءات متاحة مرة أخرى.

لا يتم إزالة السجل تلقائيًا. لإزالة عميل قديم بشكل دائم، قم بتحريره من قاعدة بيانات الإدارة أو حذفه من خلال الأداة الإدارية ذات الصلة.

نصائح

  • احتفظ بمهلة عدم النشاط عند 10 ثوانٍ ما لم تكن تعرف أن العملاء القدامى لديك يرسلون إشارات أبطأ من ذلك. تؤدي مهلة أقصر إلى وضع علامة غير صحيحة على العملاء الأصحاء كغير متصلين أثناء انقطاعات الشبكة القصيرة.
  • إذا ظهر عميل قديم على الإنترنت لكنه لا يستجيب للأوامر، تحقق من متغير البروتوكول في الإعدادات. يؤدي عدم التطابق بين متغير الخادم (STE مقابل Standard) وبناء العميل إلى إسقاط الأوامر بصمت.
  • لقطات الشاشة من العملاء القدامى هي BMP مضغوطة، وهي أكبر من لقطات PNG الحديثة. احتفظ بمجلد legacy_screenshots على محرك يحتوي على مساحة خالية كافية إذا كنت تلتقط العديد من اللقطات.
  • استخدم إضافة الوقت مع الأزرار المسبقة أثناء انتقالات النوبات. يؤدي النقر الواحد إلى تمديد الجلسة بزيادة محددة مسبقًا، وهو أسرع من كتابة الدقائق يدويًا.
  • قم بإيقاف العملاء القدامى تدريجيًا. قم بالترقية دفعة واحدة في كل مرة، وتأكد من أن العملاء الجدد يعملون بشكل متطابق في لوحة الإدارة، ثم قم بإيقاف العملاء القدامى فقط بعد ذلك.