Táto funkcia je určená na doplnenie funkcií dotykového ovládača alebo dotykového používateľského rozhrania. Nie je určený na to, aby ich nahradil .

Príklady aplikácií:

  • V učebniach a počas prednášok je možné použiť malé diaľkové ovládanie na prebudenie zariadenia z pohotovostného režimu. môže byť tiež vhodné použiť diaľkové ovládanie na výber vstupného zdroja, ktorý sa má prezentovať.

  • Ovládanie zobrazenia kamery (posun, naklonenie a priblíženie) v situáciách, keď nemáte povolené používať dotykový ovládač. Napríklad na operačných sálach v nemocnici.

Funkčný prehľad

Po stlačení tlačidla na vstupnom zariadení USB sa spustí akcia v rámci rozhrania API zariadenia Cisco. Makrá alebo externé ovládacie zariadenia od tretích strán je možné nastaviť tak, aby rozpoznali tieto akcie a podľa nich reagovali. Táto funkcia je podobná správaniu tlačidiel ovládania v miestnosti. Okrem toho je možné tieto akcie monitorovať prostredníctvom webhookov alebo priamo v rámci relácie SSH.

Nie je k dispozícii už existujúca knižnica akcií na výber. Musíte definovať a stanoviť konkrétne akcie, ktoré by sa mali uskutočniť v reakcii na udalosti. Napríklad:

  • Zvýšte hlasitosť zariadenia Cisco po stlačení klávesu na zvýšenie hlasitosti.

  • Po stlačení klávesu Sleep uveďte zariadenie Cisco do pohotovostného režimu.

Konfigurácie, udalosti a stav

Konfigurácie a stav, ktoré sú uvedené v tomto článku, sú dostupné z lokálneho webového rozhrania zariadenia aj z rozhraní API. Informácie o tom, ako získať prístup k webovému rozhraniu a používať rozhranie API, nájdete v článku o konfiguráciách zariadení .

Po otvorení webového rozhrania zariadenia kliknite na položku Nastavenia . V časti Konfigurácie zmeňte položku Periférne zariadenia > Režim vstupného zariadenia na hodnotu Zapnuté. Podpora vstupných zariadení USB tretích strán je predvolene vypnutá.

Stlačením a uvoľnením tlačidla sa vygenerujú udalosti Stlačené a Uvoľnené : 

 *e Kľúč akcie vstupného zariadenia používateľského rozhrania:  *e kód akcie kľúča vstupného zariadenia používateľského rozhrania:  *e Typ akcie kľúča vstupného zariadenia používateľského rozhrania: Stlačený ** koniec *e Akčný kľúč vstupného zariadenia používateľského rozhrania:  *e Kód akcie vstupného zariadenia používateľského rozhrania:  *e Typ akcie kľúča vstupného zariadenia používateľského rozhrania: Vydané ** koniec

Ak chcete počúvať udalosti, musíte zaregistrovať spätnú väzbu z udalostí InputDevice : 

 xFeedback Register /event/UserInterface/InputDevice ** koniec

Keď zariadenie Cisco zistí periférne zariadenie tretej strany, bude uvedené v časti Stav a v časti Periférne zariadenia > Pripojené zariadenie. Zariadenie tretej strany môže byť nahlásené ako viacero zariadení.

Ďalšie informácie

Viac informácií o používaní vstupného zariadenia tretej strany nájdete v sprievodcovi prispôsobením. Vyberte najnovšiu verziu.

Podpora Cisco (TAC) nepodporuje ladenie kódu tretích strán vrátane makier. Ak potrebujete pomoc s makrami a kódom tretích strán, pozrite si Cisco RoomOS for Collaboration Devices . Ďalšie príklady makier a rozšírení nájdete na tejto stránke .

Príklad

V tomto príklade vám chceme ukázať, ako používať klávesy vstupného USB zariadenia tretej strany (v tomto prípade diaľkového ovládača) na ovládanie určitých funkcií na zariadení Cisco.

Ukážeme vám, ako používať tlačidlá na diaľkovom ovládači Bluetooth (pripojenom cez USB kľúč) na spravovanie funkcií, ako je pohotovostný režim, nastavenie hlasitosti a ovládanie zariadenia fotoaparátu Cisco. Môžete vytvoriť makro, ktoré počúva relevantné udalosti a vykonáva zodpovedajúce akcie prostredníctvom rozhrania API zariadenia Cisco.

V nasledujúcom príklade musíte zadať text, ktorý je napísaný normálnym písmom. Text v kurzíve je odpoveď prijatá zo zariadenia Cisco.

1

Prihláste sa do zariadenia Cisco na SSH. Potrebujete miestneho používateľa správcu .

2

Nakonfigurujte zariadenie tak, aby umožňovalo používanie diaľkového ovládača USB tretej strany. 

 xConfiguration Peripherals InputDevice Mode: Na ** koniec OK

 

Pomocou tohto príkazu môžete skontrolovať, či je konfigurácia zapnutá alebo vypnutá: 

 xConfiguration Peripherals InputDevice Mode  *c xConfiguration Peripherals InputDevice Mode: Na ** koniec OK
3

Zaregistrujte sa a získajte spätnú väzbu, aby sme boli upozornení na stlačenie a uvoľnenie tlačidiel diaľkového ovládača. 

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

 

Pomocou tohto príkazu môžete skontrolovať, pre ktoré spätné väzby je zariadenie zaregistrované: 

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

Stlačením a uvoľnením tlačidla na diaľkovom ovládači skontrolujte, či registrácia spätnej väzby funguje.

Táto akcia generuje dve udalosti: Stlačené a Uvoľnené. Ak stlačíte a podržíte tlačidlo, uvidíte udalosť Stlačené , kým tlačidlo neuvoľníte. Potom sa vygeneruje udalosť Vydané .

Tieto udalosti sa vydávajú pri stlačení a uvoľnení klávesu Enter:

  *e Akčný kľúč pre vstupné zariadenie používateľského rozhrania: KEY_ENTER *e Kód akcie pre vstup používateľského rozhrania: 28 *e Typ akcie kľúča vstupného zariadenia používateľského rozhrania: Stlačené ** koniec *e Akčný kláves vstupného zariadenia používateľského rozhrania: KEY_ENTER *e Kód akcie pre vstup používateľského rozhrania: 28 *e Typ akcie kľúča vstupného zariadenia používateľského rozhrania: Vydané ** koniec
5

Napíšte makro, ktoré počúva relevantné udalosti InputDevice a vykonáva súvisiace akcie pomocou rozhrania API zariadenia.

  • Oživte tlačidlá pohotovostného režimu, zvýšenia a zníženia hlasitosti. Keď makro uvidí udalosť obsahujúcu KEY_VOLUMEUP, KEY_VOLUMEDOWN alebo KEY_SLEEP, vykoná súvisiace príkazy.

  • Vytvorte funkciu ovládania kamery pre klávesy so šípkami. Chceme pokračovať v pohybe fotoaparátu, kým je tlačidlo stlačené. Po uvoľnení tlačidla sa pohyb kamery zastaví. Keď makro uvidí udalosť obsahujúcu KEY_LEFT, KEY_RIGHT, KEY_UP alebo KEY_DOWN, vykoná súvisiace príkazy. 

 const xapi = vyžadovať('xapi'); funkcia com(príkaz, argumenty='') { xapi.command(príkaz, argumenty); log(príkaz + ' ' + JSON.stringify(args)); } log funkcie(udalosť) { console.log(udalosť); } function notify (správa) { xapi.command('UserInterface Message TextLine Display', { Text: správa, trvanie: 3 }); } funkcia cameraControl(motor, smer, cameraId='1') { com('Camera Ramp', { 'CameraId': cameraId, [motor]: smer }); } funkcia init() { nech standbyState; xapi.status.get('Standby').then((state) => {standbyState = state.State === 'Vypnuté' ? false : pravda; }); xapi.status.on('Standby', state => { standbyState = state.State === 'Off' ? false : pravda; }); xapi.event.on('UserInterface InputDevice Key Action', stlačte => { if (stlačte.Type == "Stlačený") { prepínač (stlačte.Kláves) { veľkosť písmen "KEY_LEFT" : cameraControl('Pan', 'Left'); prestávka; prípad "KEY_RIGHT": cameraControl('Pan', 'Vpravo'); prestávka; prípad "KEY_UP": cameraControl('Naklonenie', 'Nahor'); prestávka; prípad "KEY_DOWN": cameraControl('Naklonenie', 'Nadol'); prestávka; predvolene: prestávka; } } else if (stlačte. Typ == "Uvoľnené") { prepnite (stlačte kláves) { veľkosť písmen "KEY_LEFT": cameraControl('Pan', 'Stop'); prestávka; prípad "KEY_RIGHT": cameraControl('Pan', 'Stop'); prestávka; prípad "KEY_UP": cameraControl('Naklonenie', 'Zastaviť'); prestávka; prípad "KEY_DOWN": cameraControl('Naklonenie', 'Zastaviť'); prestávka; prípad „KEY_VOLUMEUP“: com('Zvýšenie hlasitosti zvuku'); prestávka; prípad „KEY_VOLUMEDOWN“: com('Zníženie hlasitosti'); prestávka; prípad 'KEY_SLEEP': com(standbyState ? 'Standby Deactivate' : 'Aktivovať pohotovostný režim'); prestávka; predvolene: prestávka; } } }); } init();