Brug af tredjeparts USB-inputenheder med Board-, skrivebords- og lokaleserier

Denne funktion er beregnet til at supplere funktionerne i touch-controlleren eller touch-brugergrænsefladen. Det er ikke meningen, at det skal erstatte dem.

Eksempler på ansøgninger:

I klasseværelser og under forelæsninger kan en lille fjernbetjening bruges til at vække en enhed fra standbytilstand. Det kan også være praktisk at bruge en fjernbetjening til at vælge, hvilken indgangskilde der skal vises.
Styring af kameravisningen (panorering, vipning og zoom) i situationer, hvor du ikke har tilladelse til at bruge touch-controlleren. For eksempel i operationsstuer på et hospital.

Funktionelt overblik

Når der trykkes på en knap på USB-inputenheden, udløser det en handling inden for Cisco-enhedens API. Makroer eller eksterne kontrolenheder fra tredjeparter kan konfigureres til at registrere disse handlinger og reagere i overensstemmelse hermed. Denne funktionalitet svarer til, hvordan knapper til kontrol på værelset opfører sig. Derudover er det muligt at overvåge disse handlinger via webhooks eller direkte i en SSH-session.

Der findes ikke et allerede eksisterende bibliotek med handlinger, du kan vælge imellem. Du er forpligtet til at definere og etablere de specifikke handlinger, der skal forekomme som reaktion på begivenhederne. For eksempel:

Forøg lydstyrken på Cisco enheden, når der trykkes på lydstyrke op-tasten.
PUT Cisco enheden i standbytilstand, når der trykkes på dvaletasten.

Konfigurationer, hændelser og status

De konfigurationer og den status, der henvises til i denne artikel, er tilgængelige både fra enhedens lokale webgrænseflade og API'erne. Læs artiklen Enhedskonfigurationer for at få oplysninger om, hvordan du får adgang til webgrænsefladen og bruger API.

Når enhedens webgrænseflade åbnes, skal du klikke på Indstillinger . Under Konfigurationer skal du ændre tilstanden Periferiudstyr> inputenhed til Til. Understøttelsen af tredjeparts USB-inputenheder er deaktiveret som standard.

Når du trykker på og slipper en knap, genereres hændelsen Trykket og Frigivet :

 *e UserInterface InputDevice Key Action Key: <navnet på tasten> *e UserInterface InputDevice Key Action Code: <ID af tasten> *e UserInterface InputDevice Key Action Type: Trykket ** end *e UserInterface InputDevice Key Action Key: <navnet på tasten> *e UserInterface InputDevice Key Action Code: <ID af nøglen> *e UserInterface InputDevice Key Action Type: Udgivet ** slut

Hvis du vil lytte efter hændelser, skal du registrere feedback fra InputDevice-hændelserne :

 xFeedback Register /event/UserInterface/InputDevice ** end

Når Cisco-enheden registrerer tredjeparts eksterne enheder, vises den under Status og i Peripherals > ConnectedDevice . Tredjepartsenheden kan blive rapporteret som flere enheder.

Yderligere oplysninger

Du kan finde flere oplysninger om brugen af en inputenhed fra tredjepart i tilpasningsvejledningen . Vælg den nyeste version.

Cisco support (TAC) understøtter ikke fejlfinding af tredjepartskode, herunder makroer. Se Cisco RoomOS til samarbejdsenheder , hvis du har brug for hjælp til makroer og tredjepartskode. Se flere eksempler på makroer og udvidelser på denne side .

Eksempel

I dette eksempel vil vi vise dig, hvordan du bruger tasterne på en tredjeparts USB-inputenhed (i dette tilfælde en fjernbetjening) til at styre visse funktioner på en Cisco-enhed.

Vi viser dig, hvordan du bruger knapperne på en Bluetooth fjernbetjening (tilsluttet via en USB dongle) til at styre funktioner som standby, lydstyrkejustering og styring af en Cisco kameraenhed. Du kan udvikle en makro, der lytter til relevante hændelser og udfører tilsvarende handlinger via Cisco-enhedens API.

I følgende eksempel skal du indtaste den tekst, der er skrevet med normal skrifttype. Teksten i kursiv er svaret modtaget fra Cisco-enheden.


 xConfiguration Peripherals InputDevice Mode: Til ** slut OK  
 xFeedback Register /event/userinterface/inputdevice  ** end OK  
  *e UserInterface InputDevice Key Action Key: KEY_ENTER *e UserInterface InputDevice Key Action Code: 28 *e UserInterface InputDevice Key Action Type: Trykket ** end *e UserInterface InputDevice Key Action Key: KEY_ENTER *e UserInterface InputDevice Key Action Code: 28 *e UserInterface InputDevice Key Action Type: Frigivet ** end  
 const xapi = kræver ('xapi'); funktion 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. Tilstand === 'Fra'? falsk: sandt; }); xapi.status.on('Standby', tilstand => { standbyState = tilstand. Tilstand === 'Fra'? falsk: sandt; }); xapi.event.on('UserInterface InputDevice Key Action', tryk på => { if (tryk på. Type == "Presset") { kontakt (tryk. Tast) { case "KEY_LEFT": cameraControl('Panor', 'Left'); break; case "KEY_RIGHT": cameraControl ('Panor', 'Right'); break; case "KEY_UP": cameraControl ('Tilt', 'Up'); break; case "KEY_DOWN": cameraControl ('Tilt', 'Down'); pause; standard: break; } } ellers hvis (tryk. Type == "Frigivet") { switch (tryk på. Tast) { case "KEY_LEFT": cameraControl ('Panor', 'Stop'); pause; case "KEY_RIGHT": cameraControl ('Panor', 'Stop'); pause; case "KEY_UP": cameraControl ('Tilt', 'Stop'); pause; case "KEY_DOWN": cameraControl ('Tilt', 'Stop'); pause; case 'KEY_VOLUMEUP': com('Audio Volume Increase'); pause; case 'KEY_VOLUMEDOWN': com('Audio Volume Reduction'); pause; case 'KEY_SLEEP': com(standbyState? »Standby-deaktivering«: »Standbyaktivering«); Bryde; Standard: pause; } } }); } init(); 

1	Log ind på Cisco enheden på SSH. Du skal bruge en lokal administratorbruger .
2	Konfigurer enheden til at tillade brug af en tredjeparts USB fjernbetjening. `xConfiguration Peripherals InputDevice Mode: Til ** slut OK` Du kan kontrollere, om konfigurationen er Til eller Fra, ved hjælp af denne kommando: `xConfiguration Peripherals InputDevice Mode c xConfiguration Peripherals InputDevice Mode: On * end OK`
3	Tilmeld dig feedback, så vi får besked, når der trykkes på fjernbetjeningens knapper og slippes. `xFeedback Register /event/userinterface/inputdevice end OK` Du kan kontrollere, hvilke tilbagemeldinger enheden er registreret til ved hjælp af denne kommando: `xFeedback-liste /hændelse/brugergrænseflade/inputenhed slut OK`
4	Tryk og slip en knap på fjernbetjeningen for at kontrollere, at feedbackregistrering fungerer. Denne handling genererer to hændelser: Trykket og Frigivet. Hvis du trykker på en tast og holder den nede, vises hændelsen Tryk på, indtil du slipper knappen. Derefter genereres hændelsen Frigivet . Disse hændelser udstedes, når du trykker på og slipper Enter-tasten: `e UserInterface InputDevice Key Action Key: KEY_ENTER e UserInterface InputDevice Key Action Code: 28 e UserInterface InputDevice Key Action Type: Trykket * end e UserInterface InputDevice Key Action Key: KEY_ENTER e UserInterface InputDevice Key Action Code: 28 e UserInterface InputDevice Key Action Type: Frigivet * end`
5	Skriv en makro, der lytter efter de relevante inputenhedshændelser og udfører de tilknyttede handlinger ved hjælp af enhedens API. Gør knapperne standby, lydstyrke op og lydstyrke ned levende. Når makroen ser en hændelse, der indeholder KEY_VOLUMEUP, KEY_VOLUMEDOWN eller KEY_SLEEP, udfører den de relaterede kommandoer. Opret en kamerakontrolfunktion til piletasterne. Vi vil fortsætte med at flytte kameraet, så længe der trykkes på knappen. Når knappen slippes, stopper kamerabevægelsen. Når makroen ser en hændelse, der indeholder KEY_LEFT, KEY_RIGHT, KEY_UP eller KEY_DOWN, udfører den de relaterede kommandoer. const xapi = kræver ('xapi'); funktion 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. Tilstand === 'Fra'? falsk: sandt; }); xapi.status.on('Standby', tilstand => { standbyState = tilstand. Tilstand === 'Fra'? falsk: sandt; }); xapi.event.on('UserInterface InputDevice Key Action', tryk på => { if (tryk på. Type == "Presset") { kontakt (tryk. Tast) { case "KEY_LEFT": cameraControl('Panor', 'Left'); break; case "KEY_RIGHT": cameraControl ('Panor', 'Right'); break; case "KEY_UP": cameraControl ('Tilt', 'Up'); break; case "KEY_DOWN": cameraControl ('Tilt', 'Down'); pause; standard: break; } } ellers hvis (tryk. Type == "Frigivet") { switch (tryk på. Tast) { case "KEY_LEFT": cameraControl ('Panor', 'Stop'); pause; case "KEY_RIGHT": cameraControl ('Panor', 'Stop'); pause; case "KEY_UP": cameraControl ('Tilt', 'Stop'); pause; case "KEY_DOWN": cameraControl ('Tilt', 'Stop'); pause; case 'KEY_VOLUMEUP': com('Audio Volume Increase'); pause; case 'KEY_VOLUMEDOWN': com('Audio Volume Reduction'); pause; case 'KEY_SLEEP': com(standbyState? »Standby-deaktivering«: »Standbyaktivering«); Bryde; Standard: pause; } } }); } init();

Cisco AI Assistant

Tak for din feedback.

Funktionelt overblik

Konfigurationer, hændelser og status

Yderligere oplysninger

Eksempel

Små virksomheder

Virksomhed

Enheder

Løsninger til

Ressourcer

Virksomhed