Použití vstupních zařízení USB třetích stran s Board, Desk a Room Series

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 stisknuto tlačítko na vstupním zařízení USB, spustí akci v Cisco zařízení API. 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.
PUT Cisco zařízení v pohotovostním 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ím a uvolněním tlačítka se vygeneruje 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 ** end *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ávesy InputDevice uživatelského rozhraní: Vydáno ** konec

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

 xFeedback Register /event/UserInterface/InputDevice ** end

Když Cisco zařízení rozpozná periferní zařízení jiného výrobce, bude uvedeno v částech Stav a Periferní zařízení> ConnectedDevice . 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í jiného výrobce najdete 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. Zkontrolujte prosím # Cisco RoomOS pro zařízení pro spolupráci , pokud potřebujete pomoc s makry a kódem třetích stran. 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ávesy 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) pro správu funkcí, jako je pohotovostní režim, nastavení hlasitosti a ovládání zařízení fotoaparátu 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 nutné zadat text, který je napsán normálním písmem. Text psaný kurzívou je odpověď přijatá ze zařízení Cisco.


 Periferní zařízení xConfiguration Režim vstupního zařízení: Zapnuto ** konec OK  
 xFeedback Register /event/userinterface/inputdevice  ** end OK  
  *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  
 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ávce; výchozí hodnota: přerušení; } } }); } init(); 

1	Přihlaste se k zařízení Cisco na 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. `Periferní zařízení xConfiguration Režim vstupního zařízení: Zapnuto ** konec OK` Můžete zkontrolovat, zda je konfigurace zapnuta nebo vypnuta pomocí tohoto příkazu: `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 se pro zpětnou vazbu, abychom byli upozorněni, když jsou tlačítka dálkového ovládání stisknuta a uvolněna. `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 ovládání 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 Release . Tyto události jsou vydává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é naslouchá příslušným událostem InputDevice a provádí přidružené akce pomocí API zařízení. Oživte tlačítka pro pohotovostní režim, zvýšení a snížení hlasitosti. Když makro zjistí 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 tak dlouho, dokud je tlačítko stisknuto. Po uvolnění tlačítka se pohyb kamery zastaví. Když makro zjistí 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: 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ávce; výchozí hodnota: přerušení; } } }); } init();

Cisco AI Assistant

Děkujeme za vaši zpětnou vazbu.

Funkční přehled

Konfigurace, události a stav

Další informace

Příklad

Malá firma

Podnik

Zařízení

Řešení pro

Zdroje

Společnost