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

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

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

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

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

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

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

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

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

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

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

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

לחיצה על לחצן ושחרורו יוצרים אירוע 'לחוץ' ו'משוחרר ': 

 *e UserInterface Inputמפתח פעולת מקש מכשיר: <שם המפתח> *e UserInterface Inputקוד פעולה של מקש מכשיר: <מזהה המפתח> *e UserInterface Inputסוג פעולת מקש מכשיר: לחוץ ** סוף *e ממשק משתמש קלטמקש פעולת מקש מכשיר: <שם המפתח> *e UserInterface Inputקוד פעולה של מפתח מכשיר: <מזהה המפתח> *e UserInterface Inputסוג פעולת מפתח מכשיר: שוחרר ** סוף

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

 xFeedback Register /event/UserInterface/InputDevice ** end

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

מידע נוסף

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

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

דוגמה

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

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

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

1

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

2

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

 xConfiguration ציוד היקפי Inputמצב התקן: מופעל ** סוף אישור

 

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

 xConfiguration ציוד היקפי Inputמצב   מכשיר*c xConfiguration ציוד היקפי Inputמצב התקן: מופעל ** סוף אישור
3

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

 xFeedback Register /event/userinterface/inputdevice  ** end OK

 

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

 xFeedback list /event/userinterface/inputdevice ** end OK
4

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

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

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

  *e UserInterface Inputמקש פעולת מקש התקן: KEY_ENTER *e UserInterface InputDevice Key קוד פעולה: 28 *e UserInterface InputDevice Key סוג פעולה: לחוץ ** end *e UserInterface Inputמקש פעולת מקש התקן: KEY_ENTER *e UserInterface InputDevice Key קוד פעולה: 28 *e UserInterface InputDevice Key Action Type: שוחרר ** סוף
5

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

  • עורר לחיים את לחצני ההמתנה, הגברת עוצמת הקול והנמכת עוצמת הקול. כאשר המאקרו רואה אירוע המכיל KEY_VOLUMEUP, KEY_VOLUMEDOWN או KEY_SLEEP, הוא מבצע את הפקודות הקשורות.

  • צור פונקציית בקרת מצלמה עבור מקשי החצים. אנחנו רוצים להמשיך להזיז את המצלמה כל עוד לוחצים על הכפתור. כאשר הלחצן משתחרר, תנועת המצלמה נעצרת. כאשר המאקרו רואה אירוע המכיל KEY_LEFT, KEY_RIGHT, KEY_UP או KEY_DOWN, הוא מבצע את הפקודות הקשורות. 

 const xapi = דרישה('xapi'); הפונקציה com(command, args='') { xapi.command(command, args); log(command + ' + JSON.stringify(args)); } הפונקציה log(event) { console.log(event); } function notify(message) { xapi.command('UserInterface Message TextLine Display', { טקסט: הודעה, משך: 3 }); } פונקציה cameraControl(מנוע, כיוון, cameraId='1') { com('מצלמה רמפה', { '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 Action', הקש => { if (press. הקלד == "Pressed") { switch (press. מפתח) { מקרה "KEY_LEFT": cameraControl ('פאן', 'שמאל'); הפסקה; מקרה "KEY_RIGHT": cameraControl ('פאן', 'ימין'); הפסקה; מקרה "KEY_UP": cameraControl ('הטיה', 'למעלה'); הפסקה; מקרה "KEY_DOWN": cameraControl ('הטיה', 'מטה'); הפסקה; ברירת מחדל: הפסקה; } } אחרת אם (לחץ. הקלד == "שוחרר") { בורר (לחץ. מפתח) { מקרה "KEY_LEFT": cameraControl ('פאן', 'עצור'); הפסקה; מקרה "KEY_RIGHT": cameraControl ('פאן', 'עצור'); הפסקה; מקרה "KEY_UP": cameraControl ('הטיה', 'עצור'); הפסקה; מקרה "KEY_DOWN": cameraControl ('הטיה', 'עצור'); הפסקה; מקרה 'KEY_VOLUMEUP': com('הגברת עוצמת השמע '); הפסקה; מקרה 'KEY_VOLUMEDOWN': com('הפחתת עוצמת שמע '); הפסקה; מקרה 'KEY_SLEEP': com(מצב המתנה? 'השבתת המתנה': 'הפעלת המתנה'); הפסקה; ברירת מחדל: הפסקה; } } }); } init();