Tato funkce je určena k doplnění funkcí dotykového ovladače nebo dotykového uživatelského rozhraní. Nemá je nahradit .

Příklady aplikací:

  • V učebnách a během přednášek lze k probuzení zařízení z pohotovostního režimu použít malý dálkový ovladač. Může být také vhodné použít dálkový ovladač k výběru vstupního zdroje, který se má zobrazit.

  • Ovládání zobrazení kamery (otáčení, naklápění a zoom) v situacích, kdy není dovoleno používat dotykový ovladač. Například na operačních sálech v nemocnici.

Přehled funkcí

Po stisknutí tlačítka na vstupním zařízení USB se spustí akce v rámci rozhraní API zařízení Cisco. Makra nebo externí řídicí zařízení třetích stran lze nastavit tak, aby tyto akce detekovaly a odpovídajícím způsobem reagovaly. Tato funkce je podobná chování tlačítek v místnosti. Kromě toho je možné tyto akce monitorovat prostřednictvím webhooků nebo přímo v relaci SSH.

Již existující knihovna akcí, ze které chcete vybrat, není k dispozici. Je od vás vyžadováno definování a vytvoření konkrétních akcí, které by měly následovat v reakci na události. Například:

  • Zvýšit hlasitost zařízení Cisco při stisknutí tlačítka Zvýšení hlasitosti.

  • Přepnutí zařízení Cisco do pohotovostního režimu po stisknutí tlačítka Spánek.

Konfigurace, události a stav

Konfigurace a stav uvedené v tomto článku jsou dostupné jak v místním webovém rozhraní zařízení, tak v rozhraních API. Informace o přístupu k webovému rozhraní a používání rozhraní API naleznete v článku Konfigurace zařízení .

Po otevření webového rozhraní zařízení klikněte na Nastavení. V části Konfigurace změňte možnost Periferie > Režim vstupního zařízení na Zapnuto. Podpora vstupních zařízení USB jiných výrobců je ve výchozím nastavení zakázána.

Stisknutím a uvolněním tlačítka se vygeneruje událost Pressed a Release: 

 *e UserInterface InputDevice Key Action Key:  *e UserInterface InputDevice Key Action Code:  *e UserInterface InputDevice Key Action Type: Stisknuto ** end *e UserInterface InputDevice Key Action Key:  *e UserInterface InputDevice Key Action Code:  *e UserInterface InputDevice Key Action Type: Vydáno ** konec

Chcete-li naslouchat událostem, musíte zaregistrovat zpětnou vazbu z událostí InputDevice : 

 Registrace xFeedback /event/UserInterface/InputDevice ** ukončit

Když zařízení Cisco detekuje periferní zařízení třetí strany, bude uvedeno v části Stav a v části Periferní zařízení > PřipojenéZařízení. Zařízení třetí strany může být nahlášeno jako několik zařízení.

Další informace

Další informace o použití vstupního zařízení jiného výrobce naleznete v Příručce uživatelských úprav . Vyberte nejnovější verzi.

Podpora Cisco (TAC) nepodporuje ladění kódu třetích stran, včetně maker. Pokud potřebujete pomoc s makry a kódem třetích stran, podívejte se do systému Cisco RoomOS pro zařízení pro spolupráci . Na této stránce najdete další příklady maker a linek.

Příklad

V tomto příkladu vám chceme ukázat, jak používat klávesy vstupního zařízení USB třetí strany (v tomto případě dálkového ovladače) k ovládání určitých funkcí zařízení Cisco.

Ukážeme vám, jak pomocí tlačítek na dálkovém ovladači Bluetooth (připojeného pomocí hardwarového klíče USB) spravovat funkce, jako je pohotovostní režim, nastavení hlasitosti a ovládání kamery Cisco. Můžete vytvořit makro, které naslouchá příslušným událostem a provádí odpovídající akce prostřednictvím rozhraní API zařízení Cisco.

V následujícím příkladu musíte zadat text, který je napsán normálním písmem. Text psaný kurzívou je odpověď přijatá ze zařízení Cisco.

1

Přihlaste se k zařízení Cisco pomocí SSH. Potřebujete místního správce .

2

Nakonfigurujte zařízení tak, aby umožňovalo použití dálkového ovládání USB jiného výrobce. 

 Režim vstupního zařízení periferních zařízení xConfiguration: V ** konec (OK)

 

Pomocí tohoto příkazu můžete zkontrolovat, zda je konfigurace zapnutá nebo vypnutá: 

 xConfiguration Peripherals InputDevice Mode  *c xConfiguration Peripherals InputDevice Mode: V ** konec v pořádku
3

Zaregistrujte se pro zpětnou vazbu, abychom byli upozorněni, když jsou stisknuta a uvolněna tlačítka dálkového ovládání. 

 Registrace xFeedback /event/userinterface/inputdevice  ** ukončit OK

 

Pomocí tohoto příkazu můžete zkontrolovat, pro které zpětné vazby je zařízení zaregistrováno: 

 Seznam zpětné vazby /event/userinterface/inputdevice ** ukončit OK
4

Stisknutím a uvolněním tlačítka na dálkovém ovladači zkontrolujte, zda registrace zpětné vazby funguje.

Tato akce generuje dvě události: Stisknuto a Uvolněno. Pokud stisknete a podržíte tlačítko, zobrazí se událost Stisknuto , dokud tlačítko neuvolníte. Poté se vygeneruje událost Released .

Tyto události se vydávají při stisknutí a uvolnění klávesy Enter:

  *e Klíč akce klíče UserInterface InputDevice: KLÍČ_ZADEJTE *E Kód akce klíče UserInterface InputDevice: 28 *e Typ akce klíče UserInterface InputDevice: Stisknuto ** end *e Key Action Key UserInterface InputDevice: KLÍČ_ZADEJTE *E Kód akce klíče UserInterface InputDevice: 28 *e Typ akce klíče UserInterface InputDevice: Vydáno ** konec
5

Napište makro, které naslouchá příslušným událostem InputDevice a provádí přidružené akce pomocí rozhraní API zařízení.

  • Oživte tlačítka pohotovostního režimu, zvýšení a snížení hlasitosti. Když makro uvidí událost obsahující KEY_VOLUMEUP, KEY_VOLUMEDOWN nebo KEY_SLEEP, provede související příkazy.

  • Vytvořte funkci ovládání kamery pro klávesy se šipkami. Chceme pokračovat v pohybu fotoaparátu, dokud je stisknuto tlačítko. Po uvolnění tlačítka se pohyb kamery zastaví. Když makro uvidí událost obsahující KEY_LEFT, KEY_RIGHT, KEY_UP nebo KEY_DOWN, provede související příkazy. 

 const xapi = require('xapi'); function 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: zpráva, doba trvání: 3 }); } funkce cameraControl (motor, směr, cameraId='1') { com ('Camera Ramp', { 'CameraId': ID kamery, [motor]: direction }); } function init() { let standbyState; xapi.status.get('Standby').then((state) => {standbyState = state.State === 'Vypnuto' ? false : true; }); xapi.status.on ('Standby', state => { standbyState = state.State === 'Vypnuto' ? false : true; }); xapi.event.on('UserInterface InputDevice Key Action', press => { if (press.Type == "Stisknuto") { switch (press.Key) { case "KEY_LEFT": cameraControl („Pan“, „Levý“); přestávka; případ „KEY_RIGHT“: cameraControl ('Pan', 'Vpravo'); přestávka; případ „KEY_UP“: cameraControl („Tilt“, „Up“); break; případ „KEY_DOWN“: cameraControl ('Tilt', 'Dolů'); break; výchozí: break; } } else if (press.Type == „Uvolněno“) { switch (press.Key) { case „KEY_LEFT“: cameraControl ('Pan', 'Stop'); přestávka; případ „KEY_RIGHT“: cameraControl ('Pan', 'Stop'); přestávka; případ „KEY_UP“: cameraControl („Tilt“, „Stop“); přestávka; případ „KEY_DOWN“: cameraControl („Tilt“, „Stop“); break; případ „KEY_VOLUMEUP“: com ('Zvýšení hlasitosti zvuku'); break; případ 'KEY_VOLUMEDOWN': com ('Snížení hlasitosti zvuku'); break; případ 'KEY_SPÁNEK': com (standbyState? „Deaktivovat pohotovostní režim“: „Aktivovat pohotovostní režim“); break; default: break; } } }); } init();