استخدام أجهزة إدخال USB تابعة لجهات خارجية مع سلسلة Board والمكتب والغرفة

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

أمثلة على التطبيقات:

في الفصول الدراسية وأثناء المحاضرات ، يمكن استخدام جهاز تحكم عن بعد صغير لإيقاظ جهاز من وضع الاستعداد. قد يكون من الملائم أيضا استخدام جهاز تحكم عن بعد لتحديد مصدر الإدخال الذي سيتم تقديمه.
التحكم في عرض الكاميرا (التحريك والإمالة والتكبير/التصغير) في المواقف التي لا يسمح لك فيها باستخدام وحدة التحكم باللمس. على سبيل المثال ، في غرف العمليات في المستشفى.

نظرة عامة وظيفية

عندما يتم الضغط على زر على جهاز الإدخال USB، فإنه يؤدي إلى تشغيل إجراء داخل API جهاز Cisco. يمكن إعداد وحدات الماكرو أو أجهزة التحكم الخارجية من جهات خارجية لاكتشاف هذه الإجراءات والتفاعل وفقا لذلك. تشبه هذه الوظيفة الطريقة التي تتصرف بها أزرار التحكم داخل الغرفة. بالإضافة إلى ذلك ، من الممكن مراقبة هذه الإجراءات من خلال خطافات الويب أو مباشرة داخل جلسة SSH.

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

قم بزيادة مستوى صوت الجهاز Cisco عند الضغط على مفتاح رفع الصوت.
PUT جهاز Cisco في وضع الاستعداد عند الضغط على مفتاح السكون.

التكوينات والأحداث والحالة

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

عند فتح واجهة الويب الخاصة بالجهاز ، انقر فوق الإعدادات . ضمن التكوينات ، قم بتغيير وضع الأجهزة الطرفية > InputDevice إلى تشغيل. يتم تعطيل دعم أجهزة الإدخال USB التابعة لجهات خارجية افتراضيا.

يؤدي الضغط على زر وتحريره إلى إنشاء حدث "مضغوط " وحدث "تم تحريره ":

 *e UserInterface InputDevice Key Action Key: <اسم المفتاح> *e UserInterface InputDevice Key رمز الإجراء: <ID المفتاح> *e إدخال واجهة المستخدم نوع الإجراء الرئيسي: مضغوط ** نهاية *e إدخال واجهة المستخدم مفتاح إجراء الجهاز: <اسم المفتاح> * ه إدخال واجهة المستخدم رمز إجراء مفتاح الجهاز: < ID المفتاح> *ه إدخال واجهة المستخدم نوع الإجراء الرئيسي: صدر ** النهاية

للاستماع إلى الأحداث، يجب تسجيل الملاحظات من أحداث InputDevice :

 xFeedback التسجيل / الحدث / واجهة المستخدم / جهاز الإدخال ** النهاية

عندما يكتشف جهاز Cisco الجهاز الطرفي التابع لجهة خارجية، سيتم إدراجه ضمن الحالة وفي الأجهزة الطرفية > ConnectedDevice . قد يتم الإبلاغ عن جهاز الجهة الخارجية كأجهزة متعددة.

مزيد من المعلومات

يمكنك العثور على مزيد من المعلومات حول استخدام جهاز إدخال تابع لجهة خارجية في دليل التخصيص. اختر أحدث إصدار.

لا يدعم دعم Cisco (TAC) تصحيح أخطاء التعليمات البرمجية لجهة خارجية ، بما في ذلك وحدات الماكرو. يرجى التحقق من Cisco RoomOS لأجهزة التعاون إذا كنت بحاجة إلى مساعدة بشأن وحدات الماكرو والتعليمات البرمجية لجهة خارجية. راجع هذه الصفحة للحصول على مزيد من الأمثلة على وحدات الماكرو والملحقات.

مثال

في هذا المثال، نريد أن نوضح لك كيفية استخدام مفاتيح جهاز إدخال USB تابع لجهة خارجية (في هذه الحالة جهاز تحكم عن بعد) للتحكم في وظائف معينة على جهاز Cisco.

نوضح لك كيفية استخدام الأزرار الموجودة على جهاز التحكم عن بعد Bluetooth (المتصل من خلال دونجل USB) لإدارة وظائف مثل الاستعداد وضبط مستوى الصوت والتحكم في جهاز كاميرا Cisco. يمكنك تطوير ماكرو يستمع إلى الأحداث ذات الصلة وينفذ الإجراءات المقابلة من خلال API جهاز Cisco.

في المثال التالي، يجب إدخال النص المكتوب بالخط العادي. النص المكتوب بخط مائل هو الاستجابة المستلمة من جهاز Cisco.

1	قم بتسجيل الدخول إلى جهاز Cisco على SSH. تحتاج إلى مستخدم مسؤول محلي .
2	قم بتكوين الجهاز للسماح باستخدام جهاز تحكم عن بعد USB تابع لجهة خارجية. `xتكوين الأجهزة الطرفية الإدخالوضع الجهاز: تشغيل ** نهاية موافق` يمكنك التحقق مما إذا كان التكوين قيد التشغيل أو إيقاف باستخدام هذا الأمر: `xتكوين الأجهزة الطرفية الإدخالوضع الجهازc xإدخال الأجهزة الطرفية للتكوينوضع الجهاز: تشغيل * نهاية موافق`
3	سجل للحصول على تعليقات ، حتى يتم إخطارنا عند الضغط على أزرار التحكم عن بعد وتحريرها. `xFeedback التسجيل / الحدث / واجهة المستخدم / جهاز الإدخال النهاية موافق` يمكنك التحقق من التعليقات التي تم تسجيل الجهاز من أجلها باستخدام هذا الأمر: `xقائمة ردود الفعل / الحدث / واجهة المستخدم / جهاز الإدخال نهاية موافق`
4	اضغط على زر في جهاز التحكم عن بعد وحرره للتحقق من عمل تسجيل الملاحظات. ينتج عن هذا الإجراء حدثان: مضغوط ومحرر . إذا ضغطت مع الاستمرار على زر، فسترى الحدث "مضغوط" حتى تحرر الزر. ثم يتم إنشاء الحدث الذي تم إصداره . يتم إصدار هذه الأحداث عند الضغط على المفتاح Enter وتحريره: ه إدخال واجهة المستخدممفتاح عمل الجهاز: KEY_ENTER ه إدخال واجهة المستخدمرمز إجراء مفتاح الجهاز: 28 * ه إدخال واجهة المستخدمنوع إجراء مفتاح الجهاز: مضغوط ** نهاية ه إدخال واجهة المستخدممفتاح إجراء الجهاز: KEY_ENTER ه إدخال واجهة المستخدم رمز إجراء مفتاح الجهاز: 28 * ه إدخال واجهة المستخدم نوع إجراء مفتاح الجهاز: صدر ** نهاية
5	اكتب ماكرو يستمع إلى أحداث InputDevice ذات الصلة ، وينفذ الإجراءات المقترنة باستخدام API للجهاز. اجعل أزرار الاستعداد ورفع الصوت وخفض الصوت تنبض بالحياة. عندما يرى الماكرو حدثا يحتوي على KEY_VOLUMEUP أو KEY_VOLUMEDOWN أو KEY_SLEEP، فإنه يقوم بتنفيذ الأوامر ذات الصلة. قم بإنشاء وظيفة التحكم في الكاميرا لمفاتيح الأسهم. نريد الاستمرار في تحريك الكاميرا طالما تم الضغط على الزر. عند تحرير الزر، تتوقف حركة الكاميرا. عندما يرى الماكرو حدثا يحتوي على KEY_LEFT أو KEY_RIGHT أو KEY_UP أو KEY_DOWN، فإنه يقوم بتنفيذ الأوامر ذات الصلة. const xapi = require('xapi'); وظيفة com(command, args='') { xapi.command(command, args); log(command + ' ' + JSON.stringify(args)); } سجل الدالة(حدث) { console.log(حدث); } وظيفة إخطار (رسالة) { xapi.command('UserInterface message TextLine Display', { النص: رسالة, المدة: 3 }); } وظيفة cameraControl(المحرك, الاتجاه, cameraId='1') { com('Camera Ramp', { 'CameraId': cameraId', [المحرك]: الاتجاه }); } وظيفة init() { let standbyState; xapi.status.get('Standby').then((state) => {standbyState = state. الدولة === "إيقاف"؟ خطأ: صواب. }); xapi.status.on('Standby', state => { standbyState = state. الدولة === "إيقاف"؟ خطأ: صواب. }); xapi.event.on('إجراء مفتاح UserInterface InputDevice '، اضغط على => { إذا (اضغط على. اكتب == "مضغوط") { مفتاح التبديل (اضغط على. مفتاح) { الحالة "KEY_LEFT": cameraControl ('Pan', 'Left'); break; case "KEY_RIGHT": cameraControl(', 'Right'); break; case "KEY_UP": cameraControl ("Tilt', 'Up'); break; case "KEY_DOWN": cameraControl('Tilt', 'Down'); break; default: break; } } آخر إذا (اضغط على. اكتب == "تم الإصدار") { التبديل (اضغط على. مفتاح) { الحالة "KEY_LEFT": cameraControl ("عموم" ، "إيقاف") ؛ استراحة ؛ حالة "KEY_RIGHT": cameraControl ("عموم" ، "إيقاف") ؛ استراحة ؛ حالة "KEY_UP": cameraControl ("إمالة" ، "إيقاف") ؛ استراحة ؛ حالة "KEY_DOWN": cameraControl ("إمالة" ، "إيقاف") ؛ استراحة ؛ حالة "KEY_VOLUMEUP": com ("زيادة حجم الصوت") ؛ استراحة ؛ الحالة "KEY_VOLUMEDOWN": com ("انخفاض حجم الصوت") ؛ استراحة. الحالة 'KEY_SLEEP': com (حالة الاستعداد؟ "إلغاء تنشيط الاستعداد": "تنشيط الاستعداد") ؛ كسر; الافتراضي: استراحة. } } }); } init();

1	قم بتسجيل الدخول إلى جهاز Cisco على SSH. تحتاج إلى مستخدم مسؤول محلي .
2	قم بتكوين الجهاز للسماح باستخدام جهاز تحكم عن بعد USB تابع لجهة خارجية. `xتكوين الأجهزة الطرفية الإدخالوضع الجهاز: تشغيل ** نهاية موافق` يمكنك التحقق مما إذا كان التكوين قيد التشغيل أو إيقاف باستخدام هذا الأمر: `xتكوين الأجهزة الطرفية الإدخالوضع الجهازc xإدخال الأجهزة الطرفية للتكوينوضع الجهاز: تشغيل * نهاية موافق`
3	سجل للحصول على تعليقات ، حتى يتم إخطارنا عند الضغط على أزرار التحكم عن بعد وتحريرها. `xFeedback التسجيل / الحدث / واجهة المستخدم / جهاز الإدخال النهاية موافق` يمكنك التحقق من التعليقات التي تم تسجيل الجهاز من أجلها باستخدام هذا الأمر: `xقائمة ردود الفعل / الحدث / واجهة المستخدم / جهاز الإدخال نهاية موافق`
4	اضغط على زر في جهاز التحكم عن بعد وحرره للتحقق من عمل تسجيل الملاحظات. ينتج عن هذا الإجراء حدثان: مضغوط ومحرر . إذا ضغطت مع الاستمرار على زر، فسترى الحدث "مضغوط" حتى تحرر الزر. ثم يتم إنشاء الحدث الذي تم إصداره . يتم إصدار هذه الأحداث عند الضغط على المفتاح Enter وتحريره: ه إدخال واجهة المستخدممفتاح عمل الجهاز: KEY_ENTER ه إدخال واجهة المستخدمرمز إجراء مفتاح الجهاز: 28 * ه إدخال واجهة المستخدمنوع إجراء مفتاح الجهاز: مضغوط ** نهاية ه إدخال واجهة المستخدممفتاح إجراء الجهاز: KEY_ENTER ه إدخال واجهة المستخدم رمز إجراء مفتاح الجهاز: 28 * ه إدخال واجهة المستخدم نوع إجراء مفتاح الجهاز: صدر ** نهاية
5	اكتب ماكرو يستمع إلى أحداث InputDevice ذات الصلة ، وينفذ الإجراءات المقترنة باستخدام API للجهاز. اجعل أزرار الاستعداد ورفع الصوت وخفض الصوت تنبض بالحياة. عندما يرى الماكرو حدثا يحتوي على KEY_VOLUMEUP أو KEY_VOLUMEDOWN أو KEY_SLEEP، فإنه يقوم بتنفيذ الأوامر ذات الصلة. قم بإنشاء وظيفة التحكم في الكاميرا لمفاتيح الأسهم. نريد الاستمرار في تحريك الكاميرا طالما تم الضغط على الزر. عند تحرير الزر، تتوقف حركة الكاميرا. عندما يرى الماكرو حدثا يحتوي على KEY_LEFT أو KEY_RIGHT أو KEY_UP أو KEY_DOWN، فإنه يقوم بتنفيذ الأوامر ذات الصلة. const xapi = require('xapi'); وظيفة com(command, args='') { xapi.command(command, args); log(command + ' ' + JSON.stringify(args)); } سجل الدالة(حدث) { console.log(حدث); } وظيفة إخطار (رسالة) { xapi.command('UserInterface message TextLine Display', { النص: رسالة, المدة: 3 }); } وظيفة cameraControl(المحرك, الاتجاه, cameraId='1') { com('Camera Ramp', { 'CameraId': cameraId', [المحرك]: الاتجاه }); } وظيفة init() { let standbyState; xapi.status.get('Standby').then((state) => {standbyState = state. الدولة === "إيقاف"؟ خطأ: صواب. }); xapi.status.on('Standby', state => { standbyState = state. الدولة === "إيقاف"؟ خطأ: صواب. }); xapi.event.on('إجراء مفتاح UserInterface InputDevice '، اضغط على => { إذا (اضغط على. اكتب == "مضغوط") { مفتاح التبديل (اضغط على. مفتاح) { الحالة "KEY_LEFT": cameraControl ('Pan', 'Left'); break; case "KEY_RIGHT": cameraControl(', 'Right'); break; case "KEY_UP": cameraControl ("Tilt', 'Up'); break; case "KEY_DOWN": cameraControl('Tilt', 'Down'); break; default: break; } } آخر إذا (اضغط على. اكتب == "تم الإصدار") { التبديل (اضغط على. مفتاح) { الحالة "KEY_LEFT": cameraControl ("عموم" ، "إيقاف") ؛ استراحة ؛ حالة "KEY_RIGHT": cameraControl ("عموم" ، "إيقاف") ؛ استراحة ؛ حالة "KEY_UP": cameraControl ("إمالة" ، "إيقاف") ؛ استراحة ؛ حالة "KEY_DOWN": cameraControl ("إمالة" ، "إيقاف") ؛ استراحة ؛ حالة "KEY_VOLUMEUP": com ("زيادة حجم الصوت") ؛ استراحة ؛ الحالة "KEY_VOLUMEDOWN": com ("انخفاض حجم الصوت") ؛ استراحة. الحالة 'KEY_SLEEP': com (حالة الاستعداد؟ "إلغاء تنشيط الاستعداد": "تنشيط الاستعداد") ؛ كسر; الافتراضي: استراحة. } } }); } init();

Cisco AI Assistant

شكرًا على ملاحظاتك.

نظرة عامة وظيفية

التكوينات والأحداث والحالة

مزيد من المعلومات

مثال

الشركات صغيرة الحجم

المؤسسة

الأجهزة

حلول لـ

الموارد

الشركة