Tato funkce má doplňovat funkce dotykového ovladače nebo dotykového uživatelského rozhraní. Není určen k tomu, aby je nahradil .

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é ovládání. Může být také vhodné použít dálkové ovládání k výběru vstupního zdroje, který chcete prezentovat.

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

Funkční přehled

Když je tlačítko stisknuto na vstupním zařízení USB, spustí se akce v rámci API zařízení Cisco. Makra nebo externí ovládací zařízení třetích stran mohou být nastavena tak, aby tyto akce detekovala a odpovídajícím způsobem reagovala. Tato funkce je podobná tomu, jak se chovají tlačítka ovládání v místnosti. Kromě toho je možné tyto akce monitorovat prostřednictvím webhooků nebo přímo v rámci relace SSH.

K dispozici není již existující knihovna akcí, ze kterých si můžete vybrat. Musíte definovat a stanovit konkrétní akce, ke kterým by mělo dojít v reakci na události. Příklad:

  • Zvyšte hlasitost zařízení Cisco po stisknutí tlačítka pro zvýšení hlasitosti.

  • Přepněte zařízení Cisco do pohotovostního režimu po stisknutí tlačítka spánku.

Konfigurace, události a stav

Konfigurace a stav, na které se odkazuje v tomto článku, jsou k dispozici z místního webového rozhraní zařízení i rozhraní API. Přečtěte si článek Konfigurace zařízení, kde najdete informace o tom, jak přistupovat k webovému rozhraní a používat API.

Po otevření webového rozhraní zařízení klikněte na Nastavení . V části Konfigurace změňte Režim Periferní zařízení> InputDevice na Zapnuto . Podpora vstupních zařízení USB třetích stran je ve výchozím nastavení zakázána.

Stisknutí a uvolnění tlačítka generuje událost Stisknuto a Uvolněno: 

 *e Klíč akce klávesy UserInterface InputDevice: <název klíče> *e Kód akce klávesy InputDevice uživatelského rozhraní: <ID klíče> *e Typ akce klávesy UserInterface InputDevice: Stisknuto ** konec *e Klávesa akce InputDevice uživatelského rozhraní: <název klíče> *e Kód akce klávesy InputDevice uživatelského rozhraní: <ID klíče> *e Typ akce klíče InputDevice uživatelského rozhraní: Vydáno ** konec

Aby bylo možné naslouchat událostem, je třeba zaregistrovat zpětnou vazbu z událostí VstupníZařízení: 

 xFeedback Register /event/UserInterface/InputDevice ** end

Když zařízení Cisco rozpozná periferní zařízení jiného výrobce, bude uvedeno v částech Stav a Periferní zařízení> PřipojenéZařízení . Zařízení jiného výrobce může být nahlášeno jako více zařízení.

Další informace

Další informace o použití vstupního zařízení třetí strany najdete v příručce Přizpůsobení. 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, zkontrolujte systém Cisco RoomOS pro zařízení pro spolupráci. Na této stránce najdete další příklady maker a rozšíření.

Příklad

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

Ukážeme vám, jak používat tlačítka na dálkovém ovladači Bluetooth (připojeném přes hardwarový klíč USB) ke správě funkcí, jako je pohotovostní režim, nastavení hlasitosti a ovládání kamerového zařízení Cisco. Můžete vytvořit makro, které naslouchá relevantním událostem a provádí odpovídající akce prostřednictvím API zařízení Cisco.

V následujícím příkladu je třeba 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 na SSH. Potřebujete místního uživatele správce.

2

Nakonfigurujte zařízení tak, aby umožňovalo použití dálkového ovladače USB třetí strany. 

 Periferní zařízení xConfiguration Režim vstupního zařízení: Zapnuto ** konec OK

 

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

 Periferní zařízení xConfiguration Režim   vstupního zařízení*c xPeriferní zařízení konfigurace Režim vstupního zařízení: Zapnuto ** konec OK
3

Zaregistrujte zařízení pro zpětnou vazbu, abychom byli informováni o stisknutí a uvolnění tlačítek dálkového ovladače. 

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

 

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

 xFeedback list /event/userinterface/inputdevice ** end 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 vytvoří dvě události: Stisknutoa Uvolněno. Pokud stisknete a podržíte tlačítko, zobrazí se událost Stisknuto, dokud tlačítko neuvolníte. Poté se vygeneruje událost Uvolněno.

Tyto události jsou zaznamenány při stisknutí a uvolnění klávesy Enter:

  *e Klíč akce klávesy InputDevice uživatelského rozhraní: KEY_ENTER *e Kód akce klávesy InputDevice uživatelského rozhraní: 28 *e Typ akce klávesy InputDevice uživatelského rozhraní: Stisknutý ** konec *e Klávesa akce InputDevice uživatelského rozhraní: KEY_ENTER *e Kód akce klávesy InputDevice uživatelského rozhraní: 28 *e Typ akce klávesy InputDevice uživatelského rozhraní: Uvolněno ** konec
5

Napište makro, které bude naslouchat příslušným událostem InputDevice a provede související akce pomocí rozhraní API zařízení.

  • Probuďte k životu 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 příslušné příkazy.

  • Vytvoření funkce ovládání kamery pro klávesy se šipkami. Chceme, aby se kamera pohybovala tak dlouho, dokud je stisknuto tlačítko. Po uvolnění tlačítka se pohyb kamery zastaví. Když makro vidí událost obsahující KEY_LEFT, KEY_RIGHT, KEY_UP nebo KEY_DOWN, provede příslušné 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: 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 === 'Vypnuto' ? false: pravda; }); xapi.status.on('Pohotovostní režim', state => { standbyState = state. Stav === 'Vypnuto' ? false: pravda; }); xapi.event.on('UserInterface InputDevice Key Action', stiskněte => { if (stiskněte klávesu Type == "Pressed") { switch (press. Key) { case "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; } } jinak, pokud (stiskněte tlačítko. Type == "Uvolněno") { switch (stiskněte klávesu . 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"); přestávka; případ "KEY_SLEEP": com (standbyState? "deaktivace v pohotovostním režimu": "aktivace v pohotovostním režimu"); přestávka; výchozí hodnota: přerušení; } } }); } init();