تطبيق Kramer K-Agent

مقدمة

مرحبًا بك في K-Agent، برنامج إدارة لوحات اللمس من الجيل التالي من Kramer لـ Kramer Control & Session Manger والذي يوفر إمكانيات إدارة عن بعد محسنة للوحات اللمس من سلسلة KT-20x.

ما هو K-Agent؟
K-Agent هو تطبيق برمجي قوي يمكّن من:

• إدارة ومراقبة الجهاز اللوحي عن بعد
• آلي URL التشغيل في وضع ملء الشاشة
• إدارة سياسة العرض والتحكم في الطاقة
• قفل الجهاز الآمن والتحكم في الوصول
• الإدارة عن بعد القائمة على واجهة برمجة التطبيقات

الميزات الرئيسية
الإدارة المحسنة

• ping ومراقبة الصحة
• بعيد URL إطلاق
• إمكانيات إعادة تشغيل الجهاز
• التحكم في الوصول الآمن القائم على رقم التعريف الشخصي (PIN)

إدارة العرض المتقدمة

• عناصر تحكم قابلة للتكوين في السطوع والتعتيم
• إعدادات مهلة العرض التلقائية
• دعم وضع ملء الشاشة الغامر

اتصال مرن

• دعم واجهة برمجة التطبيقات HTTP و HTTPS
• التكامل مع أنظمة Kramer Control Brain
• دعم تكوينات واجهة متعددة

الميزات الخاصة بالجهاز (لوحات اللمس KT-20x)

• التحكم في الشريط الجانبي LED وتخصيص اللون
• إدارة السطوع المحسنة
• إعدادات العرض المتقدمة

ابدء

متطلبات النظام

تكوين الشبكة

• يجب أن يكون K-Agent قابلاً للوصول على المنفذين 9803 (HTTP) أو 9804 (HTTPS)
• يجب أن يكون K-Agent قادرًا على الوصول إلى أنظمة Brain على المنفذين 8000-8049 أو 9000-9049 (HTTPS)
• أنظمة Brain المدعومة: KC-VirtualBrain-1، 5، 25، أو 50

الأجهزة المتوافقة

• لوحات اللمس من سلسلة KT-20x مع برنامج K-Agent المثبت
• الاتصال بالشبكة (إيثرنت أو واي فاي)

تم التثبيتview

• يأتي برنامج K-Agent مثبتًا مسبقًا على لوحات اللمس المتوافقة من سلسلة KT-20x. للاطلاع على إجراءات تركيب الأجهزة وإعداد الشبكة، يُرجى مراجعة دليل جهاز لوحة اللمس الخاص بك.
• يجب تشغيل K-Agent يدويًا أثناء التنشيط الأول لتمكين وظيفة التشغيل التلقائي.

انتهى العميل Kview

واجهة التطبيق
عند وصولك إلى K-Agent لأول مرة، سترى واجهة الإعدادات الرئيسية مع ثلاث مناطق تكوين أساسية:

هيكل لوحة الإعدادات

• اللوحة اليسرى: خيارات التكوين
• تبديل وضع ملء الشاشة
• تبديل سياسة العرض
• تبديل قفل الجهاز اللوحي
• معلومات الإصدار (أسفل اليسار)
• اللوحة اليمنى: تفاصيل التكوين
• الإعدادات الحساسة للسياق استنادًا إلى الخيار المحدد
• URL حقول التكوين
• إعدادات السياسة والأمان

الملاحة والوصول

الوصول إلى إعدادات K-Agent

1. اسحب لأعلى من منتصف أسفل الشاشة
   يتطلب تطبيق iPad إشارة بإصبعين من اليمين إلى اليسار ولا يدعم الرمز البريدي
2. أدخل رمز PIN (الافتراضي: 9428)
3. الوصول إلى لوحات الإعدادات وخيارات التكوين

الخروج من الإعدادات
اضغط على "تطبيق" لحفظ التغييرات والعودة إلى وضع ملء الشاشة
يتم حفظ الإعدادات تلقائيًا

الإعداد والتكوين الأولي

الإعداد لأول مرة
بعد تثبيت لوحة اللمس، اتبع الخطوات التالية للتكوين الأولي:

1. الخطوة 1: تشغيل K-Agent
   1. حدد موقع رمز K-Agent على الشاشة الرئيسية للوحة اللمس الخاصة بك
   2. اضغط لبدء تشغيل التطبيق
   3. ستظهر واجهة الإعدادات للتكوين لأول مرة
2. الخطوة 2: تكوين الوصول إلى الشبكة
   تأكد من أن لوحة اللمس لديك قادرة على التواصل مع نظام Brain الخاص بك:
   • التحقق من اتصال الشبكة
   • تأكد من أن إعدادات جدار الحماية تسمح بالمنافذ المطلوبة
   • اختبار الاتصال بعنوان IP الخاص بنظام Brain الخاص بك
3. الخطوة 3: الإعداد URL إعدادات

اختر إحدى الطرق الثلاث لتكوين واجهتك URL:

1. الطريقة 1: التصفح والتحديد (مستحسن)
   1. في إعدادات وضع ملء الشاشة، انقر فوق "استعراض وتحديد" URL”
   2. أدخل عنوان IP الخاص بدماغك والمنفذ
   3.  اختر من الواجهات المتاحة
   4. تطبيق التكوين
2. الطريقة 2: تكوين واجهة برمجة التطبيقات (الموصى بها لمُتكاملي النظام)
   • استخدام مكالمات API للتكوين عن بعد URLs
   • راجع قسم مرجع واجهة برمجة التطبيقات للحصول على التفاصيل
3. الطريقة 3: الإدخال اليدوي (غير مستحسن)
   • اكتب يدويًا النص الكامل URL في حقل التكوين
   • تأكد من صحة بناء الجملة والتنسيق

تكوين واجهة المستخدم

وضع ملء الشاشة
وضع ملء الشاشة هو الوضع التشغيلي الأساسي لـ K-Agent، حيث يوفر عرضًا غامرًا للواجهة

خيارات التكوين

شاشة كاملة للجهاز اللوحي URL

• الواجهة الأساسية URL للعرض المستمر
• يدعم واجهات Kramer Control Brain وقوالب Session Manager Tablet
• الوضع الغامر متاح (يضيف معلمة "&immersive=true")
• URL تنسيق Example: http://192.168.88.149:8000/?interface=43c286c8-ee1e-452f-b123-23afee72af1b&page=606cd9e0-9499-4d1f-8cf8-12441bee8c56

عنوان التحكم الثانوي

• عنوان IP الثانوي الاختياري للدماغ
• يستخدم لأنظمة التحكم الاحتياطية في حالة فشل الدماغ

المتطلبات الأساسية
قبل تكوين عنوان التحكم الثانوي، يجب عليك:

• إنشاء مساحة مرجعية
  • قم بالوصول إلى مشروعك في المدير
  • انتقل إلى إدارة المساحة
  • إنشاء مساحة مرجعية جديدة استنادًا إلى المساحة الرئيسية الموجودة لديك
  • تأكد من تكرار جميع تكوينات الواجهة
• توفير الدماغ الثانوي
  • نشر مساحة المرجع على نظام النسخ الاحتياطي الخاص بك
  • التحقق من إمكانية الوصول إلى الشبكة لنظام الدماغ الثانوي
  • تأكد من الحفاظ على نفس الواجهة ومعرفات الصفحة في كلا المساحتين
• متطلبات الشبكة
  • يجب أن يكون كلا نظامي الدماغ قابلين للوصول من لوحة اللمس
  • تنطبق متطلبات المنفذ القياسي (8000-8049 أو 9000-9049)
  • يجب أن يدعم توجيه الشبكة سيناريوهات الفشل
• سلوك الفشل
  • يكتشف K-Agent تلقائيًا عدم توفر الدماغ الأساسي
  • الانتقال إلى نظام الدماغ الثانوي
  • يتم الحفاظ على حالة الواجهة والوظيفة أثناء التبديل إذا تم استخدام حالات الجهاز لتغييرات واجهة المستخدم
  • مطلوب العودة اليدوية إلى الواجهة الأساسية عند توفرها
• تكوين Exampليه
  • التكوين الأساسي (ملء الشاشة للجهاز اللوحي) URL)  http://192.168.88.253:8000/?interface=43c286c8-ee1e-452f-b123-23afee72af1b&page=606cd9e0-9499-4d1f-8cf8-12441bee8c56
  • التكوين الثانوي (عنوان التحكم الثانوي) 192.168.88.254:8000
  • النتيجة أثناء الفشل
  • يقوم النظام بإنشاء الفشل تلقائيًا URL: http://192.168.88.254:8000/?interface=43c286c8-ee1e-452f-b123-23afee72af1b&page=606cd9e0-9499-4d1f-8cf8-12441bee8c56

نافذة منبثقة للجهاز اللوحي URL

• ثانوي URL لواجهات التراكب
• يمكن تشغيلها عن طريق مكالمات API أو أزرار الواجهة
• يدعم الوضع الغامر
• يقوم بعرض صفحة "المنبثقة" باستخدام 80% من لوحة اللمس
• يرجى الاطلاع على قسم تفاصيل واجهة برمجة التطبيقات

الوضع الغامر
يوفر الوضع الغامر تجربة شاشة كاملة حقيقية من خلال إزالة إطار اختيار الواجهة:

• يضيف تلقائيًا "&immersive=true" إلى URLs
• إخفاء عناصر التنقل في المتصفح
• يوصى به لعمليات النشر الإنتاجية
• لا يمكن للمستخدمين الخروج إلا عن طريق إدخال رقم التعريف الشخصي (PIN)

تصفح وحدد URL ميزة
تبسط ميزة التصفح والتحديد URL إعدادات:

استخدام التصفح والتحديد

1. الوصول إلى الميزة
   • في إعدادات وضع ملء الشاشة
   • انقر فوق "استعراض" وحدد URL”
2. الاتصال بالدماغ
   • أدخل عنوان IP الخاص بـ Brain والمنفذ في المتصفح المضمن
   • Exampلو: 192.168.88.253:8000
     
3. حدد الواجهة
   • تصفح الواجهات المتاحة
   • انقر على الواجهة المطلوبة
   • انقر فوق "تطبيق" لتأكيد الاختيار
4. التكوين التلقائي
   • URL يتم ملء حقل الإعدادات تلقائيًا
   • يتم تحميل الواجهة في وضع ملء الشاشة

الإعدادات المتقدمة

سياسة العرض
توفر سياسة العرض إدارة شاملة للطاقة والتحكم في العرض.

خيارات التكوين
تعيين مستوى السطوع الافتراضي

• بيرسنtagأقصى سطوع (0-100%)
• يتم تطبيقه عند إعادة تنشيط العرض
• التحكم بالمنزلق لسهولة التعديل

مهلة العرض (المؤقت)

• التعتيم: دقائق من عدم النشاط قبل التعتيم إلى 20% من السطوع
• إيقاف تشغيل الشاشة: دقائق من عدم النشاط قبل إيقاف تشغيل الشاشة
• يجب أن تكون مدة إيقاف تشغيل الشاشة أطول من مهلة التعتيم

الميزات المحسنة لـ KT-20x
بالنسبة للوحات اللمس KT-20x، تتوفر عناصر تحكم إضافية في العرض عبر واجهة برمجة التطبيقات (API):

• التحكم في لون الشريط الجانبي LED
• إدارة السطوع المتقدمة
• سياسات العرض الموسعة

قفل الجهاز اللوحي
يوفر قفل الجهاز اللوحي ميزات الأمان والتحكم في الوصول

تكوين الأمان
رقم التعريف الشخصي (PIN) لفتح قفل الشاشة

• رقم التعريف الشخصي الافتراضي: 9428
• قابلة للتكوين إلى أي قيمة عددية
• مطلوب للوصول إلى الإعدادات أو الخروج من وضع ملء الشاشة

سلوك النافذة المنبثقة لرقم التعريف الشخصي (PIN)

• يتم تشغيله عندما يقوم المستخدم بالتمرير لأعلى من المنتصف إلى الأسفل
• اتجاهات التمرير المتاحة:
  • من الأسفل إلى الأعلى
  • من الأعلى إلى الأسفل

قفل يو اس بي

• ميزة تعطيل منفذ USB الاختياري
• يمنع الوصول غير المصرح به لجهاز USB

عملية إدخال رقم التعريف الشخصي (PIN)

عند الوصول إلى الإعدادات:

1. يقوم المستخدم بالتمرير لأعلى من المنتصف إلى الأسفل (إيماءة iPad 2 للإصبعين من اليمين إلى اليسار - لا يدعم رمز PIN)
2. يظهر مربع حوار إدخال رقم التعريف الشخصي (PIN)
3. أدخل رقم التعريف الشخصي الصحيح باستخدام لوحة المفاتيح التي تظهر على الشاشة
4. تم منح الوصول إلى واجهة الإعدادات

وظيفة الإيقاف المؤقت والاستئناف
يوفر K-Agent إمكانيات الإيقاف المؤقت والاستئناف التشغيلي:

وقفة العملية

• يتم تنشيطه عند إدخال رقم التعريف الشخصي (PIN) والوصول إلى الإعدادات
• تم تعليق واجهة المستخدم الحالية
• تعود الشاشة إلى واجهة الإعدادات
• تم الحفاظ على حالة الجلسة

استئناف التشغيل

• يتم إعادة تحميل واجهة المستخدم تلقائيًا عند الخروج من الإعدادات
• تمت استعادة جميع حالات الواجهة
• يستمر حتى إدخال رقم التعريف الشخصي التالي

 

مرجع واجهة برمجة التطبيقات

يوفر K-Agent إمكانية الوصول الشامل إلى واجهة برمجة التطبيقات (API) للإدارة عن بعد والتكامل.

1. نقاط نهاية واجهة برمجة التطبيقات (API)view
   • تستخدم كافة مكالمات API التنسيق التالي:
   • HTTP: http:// :9803/
   • HTTPS: https:// :9804/
2. واجهات برمجة التطبيقات الخاصة بالصحة والحالة
   • فحص الصحة
   • نقطة النهاية: /health/ الطريقة: GET الاستجابة: {“status”:”Up”} الوصف: تحقق من تشغيل K-Agent واستجابته
   • Exampلو: https://192.168.88.73:9804/health/
3. URL واجهات برمجة التطبيقات للإدارة
   • يطلق URL (غير غامرة)
   • نقطة النهاية: /launchurl?<URL> الطريقة: GET الوصف: التشغيل URL في وضع المتصفح القياسي
   • Exampلو: https://192.168.88.73:9804/launchurl?http://192.168.88.253:8000/?interface=e84f5fb8-c5a3-4675-9006-d79d3e6cfe59&page=5913c07a-9a41-4fac-9870-e87b1ef719df
   • إطلاق كرامر URL (الوضع الغامر)
   • نقطة النهاية: /launchkramerurl?<URL> الطريقة: GET الوصف: التشغيل URL في وضع الغمر على كامل الشاشة
   • Exampلو: https://192.168.88.73:9804/launchkramerurl?http://192.168.88.253:8000/?interface=e84f5fb8-c5a3-4675-9006-d79d3e6cfe59&page=5913c07a-9a41-4fac-9870-e87b1ef719df&immersive=true
   • إيقاف مؤقت/استئناف تلقائيURL
   • نقطة النهاية للإيقاف المؤقت: /pauselaunchautourl/ نقطة نهاية الاستئناف: /resumelaunchautourl/ الطريقة: GET الوصف: إيقاف مؤقت أو استئناف URL التشغيل التلقائي
   • Exampليه: https://192.168.88.73:9804/pauselaunchautourl/ https://192.168.88.73:9804/resumelaunchautourl/
   • إعادة ضبط URL
   • نقطة النهاية: /إعادة تعيينurl الطريقة: GET الوصف: مسح تلقائي-URL الإعدادات وإعادة تعيين كلمة المرور إلى الافتراضي
   • Exampلو: https://192.168.88.73:9804/reseturl
4. واجهات برمجة تطبيقات إدارة النوافذ المنبثقة
   • فتح النافذة المنبثقة URL
   • نقطة النهاية: /popupurl الطريقة: GET الوصف: فتح النافذة المنبثقة بالملفات المحفوظة URL
   • Exampلو: https://192.168.88.73:9804/popupurl
   • فتح النافذة المنبثقة باستخدام المؤقت
   • نقطة النهاية: /popupurl؟الوقت= الطريقة: GET الوصف: فتح النافذة المنبثقة لمدة محددة
   • يمكنك أيضًا إغلاق النافذة المنبثقة عن طريق ضبط الوقت على 0
   • Exampلو: https://192.168.88.73:9804/popupurl؟الوقت=5
   • افتح النافذة المنبثقة باستخدام URL
   • نقطة النهاية: /popupurl?url=<URL> الطريقة: GET الوصف: فتح النافذة المنبثقة بمعلومات محددة URL (عندما لا URL أنقذ)
   • Exampلو: https://192.168.88.73:9804/popupurl?url= http://google.com
   • افتح النافذة المنبثقة باستخدام URL &مؤقت
   • نقطة النهاية: /popupurl?url=<URL>&الوقت= الطريقة: GET الوصف: فتح النافذة المنبثقة بمعلومات محددة URL (عندما لا URL (تم الحفظ) لمدة محددة
   • Exampلو: https://192.168.88.73:9804/popupurl?url= http://google.com&time=20
5. واجهات برمجة تطبيقات التحكم في العرض (لوحات اللمس KT-20x)
   • تمكين/تعطيل التحكم في العرض
   • تمكين: /displaysettingon/ تعطيل: /displaysettingoff/ الطريقة: GET الوصف: تمكين أو تعطيل عناصر التحكم في سياسة العرض
   • Exampليه: https://192.168.88.73:9804/displaysettingon/ https://192.168.88.73:9804/displaysettingoff/
   • تكوين العرض
   • ضبط وقت إيقاف العرض: /setdisplayofftimevalue= ضبط سطوع الشاشة: /setdisplaybrightnessvalue= ضبط وقت تعتيم العرض: /setdisplaydimtime=
     Examples: https://192.168.88.73:9804/setdisplayofftimevalue=30 https://192.168.88.73:9804/setdisplaybrightnessvalue=75 https://192.168.88.73:9804/setdisplaydimtime=15
6. واجهات برمجة تطبيقات التحكم في LED (لوحات اللمس KT-20x)
   • تغيير لون ضوء LED
   • نقطة النهاية: /ledlightcolor=value(rgb1,rgb2,rgb3) الطريقة: GET الوصف: تعيين لون الشريط الجانبي LED باستخدام قيم RGB (0-255)
   • Exampلو: https://192.168.88.73:9804/ledlightcolor=value(105,23,65)
   • ملاحظة: يجب أن تكون قيم RGB بين 0-255
   • التحقق من وضع ملء الشاشة URL إعدادات
   • استخدم "استعراض وحدد" URL"للتحقق من اتصال الدماغ"
   • دليل الاختبار URL الدخول في حالة فشل الكشف التلقائي

استكشاف أخطاء سياسة العرض وإصلاحها

1. التحقق من تمكين سياسة العرض
2. تحقق من تكوين قيم مهلة الانتظار بشكل صحيح
3. اختبار عناصر التحكم في السطوع عبر واجهة برمجة التطبيقات
4. تأكيد استجابة الشاشة لإيماءات التنبيه اليدوية

الهجرة من تطبيق Kramer Control

زيادةview
تم إيقاف تطبيق Kramer Control واستبداله بـ K-Agent. يُرجى من جميع المستخدمين الانتقال إلى K-Agent للحصول على دعم مستمر ووظائف مُحسّنة.

عملية الهجرة

نقل التكوين

1. تحديد الحالي URLس: ملاحظة واجهة تطبيق Kramer Control الحالية URLs
2. تحديث K-Agent: الإدخال URLs باستخدام طرق تكوين K-Agent
3. وظيفة الاختبار: التحقق من تحميل جميع الواجهات بشكل صحيح
4. إزالة التطبيق القديم: إلغاء تثبيت تطبيق Kramer Control القديم

الاختلافات الرئيسية

فوائد الهجرة

وظائف محسّنة

• واجهة برمجة تطبيقات شاملة للإدارة عن بعد
• سياسات العرض والطاقة المتقدمة
• تحسين الأمن والتحكم في الوصول

تكامل أفضل

• اتصال سلس لنظام الدماغ
• أدوات اختيار الواجهة المحسنة
• تحسين معالجة الأخطاء والتشخيص

الدعم المستقبلي

• التطوير النشط والتحديثات
• خريطة طريق الميزات المحسنة
• استمرار التوافق مع إصدارات Brain الجديدة

زائدة

مرجع الإعدادات الافتراضية

ملخص متطلبات الميناء

URL تنسيق Exampليه

• واجهة واحدة: http://192.168.1.100:8000/
• Multi-Interface with IDs: http://192.168.1.100:8000/?interface=43c286c8-ee1e-452f-b123-23afee72af1b&page=606cd9e0-9499-4d1f-8cf8-12441bee8c56
• Immersive Mode: http://192.168.1.100:8000/?interface=43c286c8-ee1e-452f-b123-23afee72af1b&page=606cd9e0-9499-4d1f-8cf8-12441bee8c56&immersive=true
• للحصول على أحدث المعلومات حول منتجاتنا وقائمة موزعي كرامر، تفضل بزيارة موقعنا webالموقع الذي يمكن العثور فيه على تحديثات دليل المستخدم هذا.
• نحن نرحب بأسئلتكم وتعليقاتكم وردود أفعالكم.
• تعد المصطلحات HDMI وواجهة الوسائط المتعددة عالية الدقة HDMI وشعار HDMI علامات تجارية أو علامات تجارية مسجلة لشركة HDMI Licensing Administrator, Inc.
• جميع أسماء العلامات التجارية وأسماء المنتجات والعلامات التجارية هي ملك لأصحابها المعنيين.

المستندات / الموارد

تطبيق Kramer K-Agent [بي دي اف] دليل المستخدم تطبيق K-Agent، تطبيق

مراجع

• دليل المستخدم