Táto funkcia má dopĺňať funkcie dotykového ovládača alebo dotykového používateľského rozhrania. Nemá ich nahradiť .

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 pohľadu kamery (posúvanie, nakláňanie a približovanie) v situáciách, keď nesmiete používať dotykový ovládač. Napríklad na operačných sálach v nemocnici.

Funkčný prehľad

Stlačením tlačidla na vstupnom zariadení USB sa spustí akcia v rámci API zariadenia Cisco. Makrá alebo externé ovládacie zariadenia od tretích strán môžu byť nastavené tak, aby detekovali tieto akcie a zodpovedajúcim spôsobom reagovali. Táto funkcia je podobná tomu, ako sa správajú tlačidlá ovládania v miestnosti. Okrem toho je možné monitorovať tieto akcie prostredníctvom webhookov alebo priamo v rámci relácie SSH.

K dispozícii nie je už existujúca knižnica akcií, z ktorých si môžete vybrať. Ste povinní definovať a stanoviť konkrétne akcie, ktoré by sa mali vyskytnúť v reakcii na udalosti. Príklad:

  • Zvýšte hlasitosť zariadenia Cisco stlačením tlačidla na zvýšenie hlasitosti.

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

Konfigurácie, udalosti a stav

Konfigurácie a stavy, ktoré sú uvedené v tomto článku, sú k dispozícii z lokálneho webového rozhrania zariadenia aj z rozhraní API. V článku Konfigurácie zariadení nájdete informácie o tom, ako získať prístup k webovému rozhraniu a používať API.

Po otvorení webového rozhrania zariadenia kliknite na Nastavenia . V časti Konfigurácie zmeňte položku Režim periférnych zariadení> InputDevice na možnosť Zapnuté. Podpora vstupných zariadení USB od iných výrobcov je predvolene vypnutá.

Stlačením a uvoľnením tlačidla sa vygeneruje udalosť Stlačené a Uvoľnené : 

 *e Používateľské rozhranie InputDevice Key Action Key: <názov kľúča> *e UserInterface InputDevice Key Action Code: <ID kľúča> *e UserInterface InputDevice Key Typ akcie: Stlačené ** koniec *e Používateľské rozhranie InputDevice Key Action Key: <názov kľúča> *e Kód akcie InputDevice Key: <ID kľúča>e Typ akcie kľúča InputDevice používateľského rozhrania: Vydaný ** koniec

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

 xFeedback Registrácia /udalosť/Používateľské rozhranie/InputDevice ** koniec

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

Ďalšie informácie

Ďalšie informácie o používaní vstupného zariadenia tretej strany nájdete v príručke prispôsobenia. Vyberte najnovšiu verziu.

Podpora spoločnosti Cisco (TAC) nepodporuje ladenie kódu tretej strany vrátane makier. Ak potrebujete pomoc s makrami a kódom tretej strany, skontrolujte zariadenia na spoluprácu v systéme Cisco RoomOS. Ď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ť kľúče vstupného zariadenia USB od iného výrobcu (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 správu funkcií, ako je pohotovostný režim, nastavenie hlasitosti a ovládanie kamerového zariadenia Cisco. Môžete vytvoriť makro, ktoré počúva relevantné udalosti a vykonáva príslušné akcie prostredníctvom API zariadenia Cisco.

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

1

Prihláste sa do zariadenia Cisco na SSH. Potrebujete lokálneho správcu .

2

Nakonfigurujte zariadenie tak, aby umožňovalo používanie diaľkového ovládača USB od iného výrobcu. 

 xConfiguration Peripherals InputDevice Mode: Zapnuté ** koniec OK

 

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

 xKonfigurácia Periférne zariadenia Režim vstupného zariadenia  *c xKonfigurácia Periférie Režim vstupného zariadenia: Zapnuté ** koniec OK
3

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

 xFeedback Registrácia /udalosť/používateľské rozhranie/inputdevice  ** koniec OK

 

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

 xZoznam  spätnej väzby/udalosť/používateľské rozhranie/vstupné zariadenie ** koniec OK
4

Stlačte a uvoľnite tlačidlo na diaľkovom ovládači, aby ste skontrolovali, č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, bude sa tlačidlo Stlačená udalosť zobrazovať , kým tlačidlo neuvoľníte. Potom sa vygeneruje udalosť Uvoľnené .

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

  *e Používateľské rozhranie InputDevice Key Action Key: KEY_ENTER *e UserInterface InputDevice Key Action Code: 28 *e UserInterface InputDevice Key Typ akcie: Stlačené ** koniec *e Používateľské rozhranie InputDevice Key Action Key: KEY_ENTER *e Používateľské rozhranie InputDevice Key Kód akcie: 28 *e UserInterface InputDevice Key Typ akcie: Uvoľnený ** koniec
5

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

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

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

 const xapi = require('xapi'); funkcia com(command, args='') { xapi.command(command; args); log(command + ' ' + JSON.stringify(args)); } function log(event) { console.log(event); } function notify(message) { xapi.command('UserInterface Message TextLine Display', { Text: message, duration: 3 }); } function cameraControl(motor, direction, cameraId='1') { com('Camera Ramp', { 'CameraId': cameraId, [motor]: direction }); } function init() { let standbyState; xapi.status.get('Standby').then((state) => {standbyState = state. Stav === 'Vypnuté' ? nepravda: pravda; }); xapi.status.on('Pohotovostný režim', stav => { standbyState = stav. Stav === 'Vypnuté' ? nepravda: pravda; }); xapi.event.on('Akcia kľúča kľúča InputDevice používateľského rozhrania', stlačte => { if (stlač. Zadajte == "Stlačené") { prepínač (stlač. Kláves) { prípad "KEY_LEFT": cameraControl('Pan', 'Left'); break; case "KEY_RIGHT": cameraControl('Pan', 'Right'); break; case "KEY_UP": cameraControl('Tilt', 'Up'); break; case "KEY_DOWN": cameraControl('Tilt', 'Down'); break; default: break; } } inak ak (stlačte. Zadajte == "Uvoľnené") { prepínač (stlač. Key) { case "KEY_LEFT": cameraControl('Pan', 'Stop'); break; case "KEY_RIGHT": cameraControl('Pan', 'Stop'); break; case "KEY_UP": cameraControl('Tilt', 'Stop'); break; case "KEY_DOWN": cameraControl('Tilt', 'Stop'); break; case 'KEY_VOLUMEUP': com('Audio Volume Increase'); break; case 'KEY_VOLUMEDOWN': com('Audio Volume Reduction'); break; case 'KEY_SLEEP': com(standbyState? "deaktivácia pohotovostného režimu": "aktivácia pohotovostného režimu"); zlomiť; predvolené: prestávka; } } }); } init();