Ez a funkció az érintővezérlő vagy az érintőfelhasználói felület funkcióinak kiegészítésére szolgál. Nem azt jelenti, hogy lecseréli őket.

Példák az alkalmazásokra:

  • Az osztálytermekben és az előadások során egy kis távirányító használható az eszköz készenléti állapotból történő felébresztésére. Az is kényelmes lehet, ha távirányítóval választja ki, melyik bemeneti forrást kell előadnia.

  • A kameranézet vezérlése (pásztázás, dőlés és nagyítás) olyan helyzetekben, amikor nem használhatja az érintővezérlőt. Például egy kórház műtőiben.

Funkcionális áttekintés

Amikor megnyomnak egy gombot az USB beviteli eszközön, az művelet a Cisco eszköz API-ján belül aktiválódik. Harmadik féltől származó makrók vagy külső vezérlőeszközök állíthatók be ezeknek a műveleteknek az észlelésére, és ennek megfelelően reagálhatnak. Ez a funkció hasonló a szobán belüli vezérlőgombokhoz. Ezenkívül lehetőség van ezeknek a műveleteknek a megfigyelésére webhookon keresztül vagy közvetlenül egy SSH-munkameneten belül.

Nincs megadva a kiválasztható műveletek már létező könyvtára. Meg kell határoznia és létre kell hoznia az eseményekre válaszul végrehajtandó konkrét műveleteket. Például:

  • A Hangerő fel gomb megnyomásával növelje a Cisco eszköz hangerejét.

  • Az Alvás gomb megnyomásával állítsa készenléti állapotba a Cisco eszközt.

Konfigurációk, események és állapot

Az ebben a cikkben említett konfigurációk és állapotok az eszköz helyi webinterfészén és az API-kon is elérhetők. A webinterfész eléréséről és az API használatáról az Eszközkonfigurációk című cikkből tájékozódhat.

Amikor meg van nyitva az eszköz webinterfésze, kattintson a Beállítások elemre. A Konfigurációk területen módosítsa a Perifériák > InputDevice mód Be értékre. A harmadik féltől származó USB bemeneti eszközök támogatása alapértelmezés szerint le van tiltva.

Egy gomb megnyomásával és elengedésével egy Megnyomott és egy Kiadott esemény jön létre: 

 *e UserInterface InputDevice kulcsművelet kulcsa:  *e UserInterface InputDevice kulcsművelet kódja:  *e UserInterface InputDevice kulcsművelet típusa: Megnyomva ** vége *e UserInterface InputDevice kulcsművelet kulcsa:  *e UserInterface InputDevice kulcsművelet kódja:  *e UserInterface InputDevice kulcsművelet típusa: Kiadva ** befejezve

Az események figyeléséhez regisztrálnia kell az InputDevice események visszajelzéseit: 

 xFeedback Regisztráció /event/UserInterface/InputDevice ** befejezés

Amikor a Cisco eszköz észleli a harmadik féltől származó perifériát, az az Állapot és a Perifériák > ConnectedDevice menüpontban jelenik meg. A harmadik féltől származó eszköz több eszközként is jelenthető.

További információk

A harmadik féltől származó beviteli eszközök használatáról a Testreszabási útmutatóban talál további információt. Válassza ki a legújabb verziót.

A Cisco-támogatás (TAC) nem támogatja a harmadik féltől származó kódok, köztük a makrók hibakeresését. Ha segítségre van szüksége a makrókkal és a harmadik féltől származó kóddal kapcsolatban, kérjük, tekintse meg a Cisco RoomOS együttműködési eszközökhöz című dokumentumot. Tekintse meg ezt az oldalt a makrókra és mellékekre vonatkozó további példákért.

Példa

Ebben a példában azt szeretnénk bemutatni, hogyan kell használni egy harmadik fél gyártótól származó USB beviteli eszköz (ebben az esetben egy távirányító) gombjait bizonyos funkciók vezérlésére egy Cisco eszközön.

Megmutatjuk, hogyan kell használni a (USB-hardverkulccsal csatlakoztatott) Bluetooth távirányító gombjait az olyan funkciók kezeléséhez, mint a készenlét, a hangerő beállítása és a Cisco kameraeszköz vezérlése. Olyan makrót fejleszthet ki, amely figyeli a releváns eseményeket, és a Cisco eszköz API-ján keresztül megfelelő műveleteket hajt végre.

A következő példában meg kell adnia a normál betűtípussal írt szöveget. A dőlt betűs szöveg a Cisco eszköztől kapott válasz.

1

Jelentkezzen be a Cisco eszközbe SSH-n. Szüksége lesz egy helyi rendszergazdai felhasználóra.

2

Konfigurálja úgy az eszközt, hogy engedélyezze egy harmadik féltől származó USB-távirányító használatát. 

 xConfiguration Peripherals InputDevice mód: ** befejezés OK

 

A következő paranccsal ellenőrizheti, hogy a konfiguráció Be vagy Ki van-e kapcsolva: 

 xConfiguration Peripherals InputDevice Mode  *c xConfiguration Peripherals InputDevice Mode: ** befejezés OK
3

Regisztráljon visszajelzésre, hogy értesítést kapjunk a távirányító gombjainak megnyomásakor és elengedéséről. 

 xVisszajelzés Regisztráció /event/userinterface/inputdevice  ** vége OK

 

A következő paranccsal ellenőrizheti, hogy az eszköz mely visszajelzésekre van regisztrálva: 

 xVisszajelzési lista /event/felhasználói felület/inputdevice ** OK vége
4

Nyomja meg és engedjen fel egy gombot a távirányítón annak ellenőrzéséhez, hogy a visszajelzés regisztrációja működik-e.

Ez a művelet két eseményt hoz létre: Megnyomva és Felengedve. Ha lenyomva tart egy gombot, a Lenyomva hagyott esemény jelenik meg, amíg fel nem oldja a gombot. Ezután létrejön a Kiadott esemény.

Ezek az események az Enter billentyű lenyomásakor és felengedésekor jelennek meg:

  *e Felhasználói felület InputDevice kulcsműveletkulcsa: KEY_ENTER *e UserInterface InputDevice Key Action Code: 28 *e UserInterface InputDevice kulcsművelet típusa: ** vége *e UserInterface InputDevice Key Action Key: KEY_ENTER *e UserInterface InputDevice Key Action Code: 28 *e UserInterface InputDevice kulcsművelet típusa: Kiadva ** befejezve
5

Írjon egy makrót, amely figyeli a releváns InputDevice eseményeket, és végrehajtja a társított műveleteket az eszköz API-jával.

  • Keltse életre a készenlétet, a hangerőt és a hangerő-csökkentő gombokat. Amikor a makró olyan eseményt lát, amely a KEY_VOLUMEUP, a KEY_VOLUMEDOWN vagy a KEY_SLEEP értéket tartalmazza, végrehajtja a kapcsolódó parancsokat.

  • Hozzon létre egy kameravezérlő funkciót a nyílbillentyűkhöz. Addig szeretnénk mozgatni a kamerát, amíg a gombot megnyomjuk. A gomb felengedésekor a kamera mozgása leáll. Amikor a makró olyan eseményt lát, amely a KEY_LEFT, KEY_RIGHT, KEY_UP vagy KEY_DOWN parancsot tartalmazza, végrehajtja a kapcsolódó parancsokat. 

 const xapi = require('xapi'); function com(parancs, args='') { xapi.command(parancs, args); log(parancs + ' ' + JSON.stringify(args)); } function log(event) { console.log(event); } function notify(message) { xapi.command('UserInterface Message TextLine Display', { Text: üzenet, időtartam: 3 }); } kameravezérlés funkció (motor, irány, cameraId='1') { com('Camera Ramp', { 'CameraId': cameraId, [motor]: irány }); } function init() { let standbyState; xapi.status.get('Standby').then((state) => {standbyState = state.State === 'Ki' ? false : true; }); xapi.status.on('Készenlét', state => { standbyState = state.State === 'Ki' ? false : true; }); xapi.event.on('UserInterface InputDevice Key Action', nyomja meg => { if (nyomja.Type == "Lenyomva") { switch (nyomja.Key) { case "KEY_LEFT": cameraControl ('Pásztázás', 'Balra'); break; case "JOBB_KULCS": cameraControl ('Pásztázás', 'Jobb'); break; case "KEY_UP": cameraControl ('Tilt', 'Fel'); break; case "KEY_DOWN": cameraControl ('Tilt', 'Lefelé'); break; alapértelmezett: break; } } else if (press.Type == "Kiadva") { switch (press.Key) { case "KEY_LEFT": cameraControl ('Pásztázás', 'Stop'); break; case "JOBB_KULCS": cameraControl ('Pan', 'Stop'); break; case "KEY_UP": cameraControl ('Tilt', 'Stop'); break; case "KEY_DOWN": cameraControl ('Tilt', 'Stop'); break; case 'KEY_VOLUME EUP': com ('Hangerő növelése'); break; case 'KEY VOLUMEDOWN_KEY VOLUMEDOWN': com ('Hangerő-csökkentés'); break; case 'KEY_SLEEP': com(standbyState ? 'Készenlét deaktiválása': 'Készenléti Aktiválás'); break; alapértelmezett: break; } }}); } init();