תכונה זו נועדה להשלים את הפונקציונליות של בקר המגע או של ממשק משתמש המגע. הוא לא אמור להחליף אותם.

דוגמאות ליישומים:

  • בכיתות ובהרצאות, ניתן להשתמש בשלט רחוק קטן כדי להעיר מכשיר ממצב המתנה. זה עשוי גם להיות נוח להשתמש בשלט רחוק כדי לבחור איזה מקור קלט להציג.

  • שליטה בתצוגת המצלמה (pan, הטיה וזום) במצבים שבהם אינך מורשה להשתמש בבקר המגע. לדוגמה, בחדרי ניתוח בבית חולים.

סקירה פונקציונלית

כאשר לחצן נלחץ במכשיר הקלט USB, הוא מפעיל פעולה בתוך ה-API של מכשיר Cisco. ניתן להגדיר פקודות מאקרו או מכשירי בקרה חיצוניים מצד שלישי כדי לזהות פעולות אלה ולהגיב בהתאם. פונקציונליות זו דומה לאופן הפעולה של לחצני הבקרה בתוך החדר. בנוסף, ניתן לנטר פעולות אלה באמצעות וובהוק או ישירות בתוך מפגש SSH.

ספרייה קיימת של פעולות לבחירה אינה מסופקת. אתה נדרש להגדיר ולקבוע את הפעולות הספציפיות שאמורות להתרחש בתגובה לאירועים. לדוגמה:

  • הגבר את עוצמת הקול של מכשיר Cisco כאשר מקש עוצמת הקול למעלה נלחץ.

  • העבר את מכשיר Cisco למצב המתנה כאשר מקש שינה נלחץ.

תצורות, אירועים ומצב

התצורות והמצב המוזכרים במאמר זה, זמינים הן מממשק האינטרנט המקומי של המכשיר והן ממשקי ה-API. קרא את מאמר תצורות המכשיר לקבלת מידע על אופן הגישה לממשק האינטרנט והשימוש ב-API.

כאשר ממשק האינטרנט של המכשיר נפתח, לחץ על הגדרות. תחת תצורות, שנה את ציוד היקפי > מצב InputDevice למופעל. התמיכה בהתקני קלט USB של צד שלישי מושבתת כברירת מחדל.

לחיצה ושחרור של לחצן יוצרת אירוע לחיצה ושחרור : 

 *e UserInterface InputDevice מפתח פעולה:  *e קוד פעולה של מפתח UserInterface InputDevice:  *e סוג פעולה של מפתח UserInterface InputDevice: לחץ על ** end *e UserInterface InputDevice Key פעולה:  *e UserInterface InputDevice Key פעולה:  *e UserInterface InputDevice Key פעולה: פורסם ** סיום

כדי להאזין לאירועים, עליך לרשום משוב מאירועי InputDevice : 

 רישום xFeedback /אירוע/UserInterface/InputDevice ** סיום

כאשר מכשיר Cisco יזהה את ההיקפי של צד שלישי, הוא יופיע תחת מצב וב- ציוד היקפי > ConnectedDevice . ייתכן שמכשיר הצד השלישי ידווח כמכשירים מרובים.

מידע נוסף

מצא מידע נוסף על השימוש במכשיר קלט של צד שלישי ב מדריך התאמה אישית . בחר את הגרסה האחרונה.

התמיכה של Cisco ‏(TAC) אינה תומכת באיתור באגים של קוד צד שלישי, כולל פקודות מאקרו. בדוק את Cisco RoomOS עבור מכשירי שיתוף פעולה אם אתה זקוק לעזרה עם פקודות מאקרו וקוד צד שלישי. בדוק דף זה לקבלת דוגמאות נוספות של פקודות מאקרו ושלוחות.

דוגמה

בדוגמה זו, אנו רוצים להראות לך כיצד להשתמש במפתחות של התקן קלט USB של צד שלישי (במקרה זה שלט רחוק) כדי לשלוט בפונקציות מסוימות במכשיר Cisco.

אנו מראים לך כיצד להשתמש בלחצנים בשלט רחוק של Bluetooth (המחובר באמצעות דונגל USB) כדי לנהל פונקציות כגון מצב המתנה, כוונון עוצמת קול ושליטה במכשיר המצלמה של Cisco. באפשרותך לפתח מאקרו המאזין לאירועים רלוונטיים ומבצע פעולות תואמות באמצעות ה-API של מכשיר Cisco.

בדוגמה הבאה, עליך להזין את הטקסט הכתוב בגופן רגיל. הטקסט בכתב נטוי הוא התגובה המתקבלת ממכשיר Cisco.

1

היכנס למכשיר Cisco ב-SSH. אתה זקוק למשתמש מנהל מערכת מקומי.

2

קבע את תצורת המכשיר כדי לאפשר שימוש בשלט רחוק של USB של צד שלישי. 

 מצב InputDevice היקפי xConfiguration: ב-** סיים אישור

 

באפשרותך לבדוק אם התצורה מופעלת או כבויה באמצעות פקודה זו: 

 xConfiguration Peripherals InputDevice מצב  *c xConfiguration Peripherals InputDevice מצב: ב-** סיים אישור
3

הירשם לקבלת משוב, כך שנודיע לנו כאשר לחצני השליטה מרחוק נלחץ ושחרור. 

 רישום xFeedback /אירוע/userinterface/inputdevice  ** סיים אישור

 

באפשרותך לבדוק אילו משובים המכשיר רשום לשימוש בפקודה זו:

רשימת 
 xFeedback/אירוע/userinterface/inputdevice ** סיים אישור
4

לחץ על לחצן בשלט הרחוק ושחרר כדי לבדוק שרישום המשוב פועל.

פעולה זו יוצרת שני אירועים: לחץושחרר. אם תלחץ ותחזיק לחצן, תראה את האירוע לחץ עד שתשחרר את הלחצן. לאחר מכן נוצר האירוע פורסם .

אירועים אלה מונפקים בעת לחיצה ושחרור על מקש Enter:

  *e מפתח פעולה של UserInterface InputDevice: קוד פעולה של מפתח_ENTER *e של UserInterface InputDevice: סוג פעולה של מקש InputDevice 28 *e: לחץ על מקש פעולה ** end *e של UserInterface InputDevice: קוד פעולה של מפתח_ENTER *e של UserInterface InputDevice: סוג פעולה של מקש InputDevice 28 *e: פורסם ** סיום
5

כתוב מאקרו המאזין לאירועי InputDevice הרלוונטיים, ומבצע את הפעולות המשויכות באמצעות ה-API של המכשיר.

  • הבא לחיים את הלחצנים במצב המתנה, עוצמת הקול למעלה ולמטה. כאשר המאקרו רואה אירוע המכיל את KEY_VOLUME UP‏, KEY_VOLUME DOWN או KEY_SLEEP, הוא מבצע את הפקודות הקשורות.

  • צור פונקציית בקרת מצלמה עבור מקשי החצים. אנחנו רוצים להמשיך להזיז את המצלמה כל עוד הלחצן נלחץ. כאשר הלחצן משוחרר, תנועת המצלמה נפסקת. כאשר המאקרו רואה אירוע המכיל את המקש_שמאלה, מקש_ימינה, מקש_למעלה או מקש_למטה, הוא מבצע את הפקודות הקשורות. 

 const xapi = require('xapi'); function com(command, args='') { xapi.command(command, args); log(command + ' ' + JSON.stringify(args)); } log(event) { console.log(event); } notify(message) { xapi.command('UserInterface Message TextLine Display', { טקסט: הודעה, משך זמן: 3 }); } function cameraControl(מנוע, כיוון, cameraId='1') { com('Camera Ramp', { 'CameraId': cameraId, [מנוע]: direction }); } function init() { let standbyState; xapi.status.get('Standby').then((state) => {standbyState === 'Off' ? false : true; }); xapi.status.on('Standby', state => { standbyState === 'כבוי' ? false : true; }); xapi.event.on('פעולת מקש UserInterface InputDevice', הקש => { אם (press.Type == "Pressed") { switch (press.Key) { case "KEY_LEFT": cameraControl ('Pan', 'שמאל'); שבר; רישיות "מקש_ימין": cameraControl ('Pan', 'Right'); שבר; "KEY_UP": (Tilt, 'למעלה'); שבר; רישיות; "KEY_DOWN": cameraControl ('הטיה', 'למטה'); שבר; ברירת מחדל: break; } } else if (press.Type == "שוחרר") { switch (press.Key) { case "KEY_LEFT": cameraControl ('Pan', 'עצור'); שבר; רישיות "מקש_ימינה": cameraControl ('Pan', 'עצור'); הפסקה; "KEY_UP": CameraControl ('הטיה', 'עצור'); שבר; רישיות_KEY DOWN: cameraControl ('הטיה', 'עצור'); שבר; רישיות 'עוצמת קול של מפתח_': com ("הגדלת עוצמת קול של שמע"); שבר; רישיות "KEY_VOLUME": (com ('הפחתת עוצמת קול של שמע'); שבר; רישיות_שינה של מפתח: com(standbyState? 'ביטול הפעלה במצב המתנה': 'הפעלה במצב המתנה'); הפסקה; ברירת מחדל: לשבור; } }}); } init();