Denne funktion er beregnet til at supplere funktionerne i touch-controlleren eller touch-brugergrænsefladen. Den er ikke beregnet til at erstatte dem.

Eksempler på applikationer:

  • 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 inputkilde der skal præsenteres.

  • Styring af kameravisningen (panorering, hældning og zoom) i situationer, hvor du ikke har tilladelse til at bruge touch-controlleren. For eksempel i driftslokaler i et andet rum.

Funktionsoversigt

Når der trykkes på en knap på USB-indgangsenheden, udløser den en handling i 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 styring i lokalet fungerer. Derudover er det muligt at overvåge disse handlinger via webhooks eller direkte i en SSH-session.

Et allerede eksisterende bibliotek med handlinger at vælge imellem er ikke angivet. Du skal definere og etablere de specifikke handlinger, der skal ske som reaktion på hændelserne. Eksempel:

  • Øg lydstyrken på Cisco-enheden, når der trykkes på tasten Lydstyrke op.

  • Sæt Cisco-enheden i standbytilstand, når der trykkes på slumretasten.

Konfigurationer, begivenheder og status

De konfigurationer og status, der er nævnt 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 tilgår webgrænsefladen og bruger API'en.

Når enhedens webgrænseflade er åben, skal du klikke på Indstillinger. Under Konfigurationer skal du ændre Periferienheder > Inputenhedstilstand til Til. Support til tredjeparts USB-indgangsenheder er deaktiveret som standard.

Tryk på og slip en knap genererer en trykt og en udgivet begivenhed: 

 *e UserInterface InputDevice Key Action Key:  *e UserInterface InputDevice Key Action Code:  *e UserInterface InputDevice Key Action Type: Tryk på ** end *e UserInterface InputDevice Key Action Key:  *e UserInterface InputDevice Key Action Code:  *e UserInterface InputDevice Key Action Type: Udgivet ** slut

For at lytte til begivenheder skal du tilmelde feedback fra InputEnhedsbegivenheder : 

 xFeedback-register /begivenhed/brugergrænseflade/inputDevice ** afslut

Når Cisco-enheden registrerer periferienheden fra tredjepart, vises den under Status og i Periferienheder > TilsluttetEnhed . Tredjepartsenheden kan blive rapporteret som flere enheder.

Yderligere oplysninger

Få yderligere oplysninger om brugen af en tredjepartsinputenhed i brugertilpasningsvejledningen . Vælg den seneste version.

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

Eksempel

I dette eksempel vil vi vise dig, hvordan du bruger tasterne på en USB-indgangsenhed fra tredjepart (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 administrere funktioner som standby, regulering af lydstyrken og styring af en Cisco-kameraenhed. Du kan udvikle en makro, der lytter til relevante begivenheder og udfører tilsvarende handlinger via Cisco-enhedens API.

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

1

Log ind på Cisco-enheden på SSH. Du har brug for en lokal administratorbruger .

2

Konfigurer enheden til at tillade brug af en tredjeparts USB-ekstern kontrol. 

 xConfiguration Peripheral InputDevice-tilstand: Afslut ** OK

 

Du kan kontrollere, om konfigurationen er Til eller Fra ved hjælp af denne kommando: 

 xConfiguration Peripherals InputDevice-tilstand  *c xConfiguration Peripherals InputDevice-tilstand: Til ** afslut OK
3

Tilmeld dig feedback, så vi får besked, når ekstern kontrol trykkes og frigives. 

 xFeedback Tilmeld /begivenhed/brugergrænseflade/indgangsenhed  ** afslut OK

 

Du kan kontrollere, hvilke feedbacks enheden er registreret til ved hjælp af denne kommando: 

 xFeedbackliste /begivenhed/brugergrænseflade/indgangsenhed ** afslut OK
4

Tryk på knappen og slip en knap på ekstern kontrol for at kontrollere, at feedbackregistrering fungerer.

Denne handling genererer to begivenheder: Trykket og frigivet. Hvis du trykker og holder en knap nede, ser du den trykkede begivenhed, indtil du frigiver knappen. Så genereres den frigivne begivenhed.

Disse begivenheder udstedes, når du trykker på og frigiver Enter-tasten:

  *e UserInterface InputDevice Key-handlingsnøgle: NØGLE_ENTER *e UserInterface InputDevice Key-handlingskode: 28 *e UserInterface InputDevice Key Action Type: Tryk på ** end *e UserInterface InputDevice Key Action Key: NØGLE_ENTER *e UserInterface InputDevice Key-handlingskode: 28 *e UserInterface InputDevice Key Action Type: Udgivet ** slut
5

Skriv en makro, der lytter efter de relevante InputDevice-begivenheder , og udfører de tilknyttede handlinger ved hjælp af enhedens API.

  • Bring standby-, lydstyrke- og lydstyrkeknapperne i brug. Når makroen ser en begivenhed, der indeholder KEY_VOLUMEUP, KEY_VOLUMEDOWN eller KEY_SLEEP, udfører den de relaterede kommandoer.

  • Opret en kamerastyringsfunktion til piletasterne. Vi vil gerne fortsætte med at flytte kameraet, så længe der trykkes på knappen. Når knappen er udgivet, stopper kamerabevægelsen. Når makroen ser en begivenhed, der indeholder TASTEN_VENSTRE, TAST_HØJRE, KEY_UP eller KEY_DOWN, udfører den de relaterede kommandoer. 

 const xapi = require ('xapi'); funktion com(command, args='') { xapi.command(command, args); log(command + ' ' + JSON.stringify(args)); } funktionslog(event) { console.log(event); } funktionsnotify(message) { xapi.command('UserInterface Message TextLine Display', { Text: meddelelse, varighed: 3 }); } funktion cameraControl (motor, retning, cameraId='1') { com('Camera Ramp', { 'CameraId': kameraId, [motor]: direction }); } funktion init () { let standbyState; xapi.status.get('Standby'). then ((state) => {standbyState = state.State === 'Fra' ? false : true; }); xapi.status.on('Standby', state => { standbyState = state.State === 'Fra'? false: true; }); xapi.event.on('UserInterface InputDevice Key Action', tryk => { if (press.Type == "Trykket") { switch (press.Key) { case "KEY_LEFT": cameraControl ('Pan', 'Venstre'); break; case "NØGLE_HØJRE": cameraControl ('Pan', 'Højre'); break; case "KEY_UP": cameraControl ("Tilt", "Up"); break; case "KEY_DOWN": cameraControl ("Tilt", "Ned"); break; standard: break; } } else if (press.Type == "Released") { switch (press.Key) { case "KEY_LEFT": cameraControl ('Pan', 'Stop'); break; case "KEY_RIGHT": cameraControl ("Pan", "Stop"); break; case "NØGLE_OP": cameraControl ('Tilt', 'Stop'); break; case "KEY_DOWN": cameraControl ('Tilt', 'Stop'); break; case 'KEY_VOLUMEUP': com ("Lydstyrkeforøg"); break; case "NØGLE_LYDSTYRKESÆNKNING": com ("Fald i lydstyrke"); break; case "KEY_SLEEP": com(standbytilstand? 'Standbydeaktivering': 'Standbyaktivér'); pause; standard: break; } }}); } init();