Zooma rum Inbyggda rumskontroller
Den ger dig möjligheten att styra IP-kompatibel utrustning från tredje part med funktionen Rumskontroll, vilket gör det möjligt för användaren att styra denna utrustning från Zoom Room Controller för att göra det bekvämare för användaren. För att Zoom Room-administratören ska kunna skicka IP-kontrollmeddelanden från Zoom Room kan en konfigurationsprofil skapas.
Förutsättningar för att använda rumskontroller
-
Ett Zoom Rooms-program som körs på macOS, Windows eller en Zoom Rooms-apparat med version 5.1 eller senare krävs
-
En enhet som kontrolleras av ett LAN eller ett WLAN som tillhör en tredje part
Hur man aktiverar rumskontroller
Inställningen måste vara aktiverad för Zoom Rooms för att du ska kunna ladda upp en JSON-konfigurationsprofil. Det är möjligt att konfigurera detta på vilken nivå som helst inom Zoom Rooms-hierarkin för att möta dina behov.
-
Zooms webbportal kan nås genom att logga in.
-
Välj sedan alternativet Zooma rum under Rumshantering.
-
När du tittar på Zoom Room-namnet klickar du på Redigera till höger om det.
-
Se till att Aktivera rumskontroller är aktiverat (blått) under Enheter.
-
Skapa en profil genom att klicka på knappen Skapa profil.
-
Detta rums JSON-konfiguration ska anges här.
Hur man skriver en profil för rumskontroller
Komma igång
Det är viktigt att ha en god förståelse för JSON innan du kan skriva en rumskontrollprofil. Det finns flera viktiga punkter att vara medveten om när det kommer till JSON: dess nyckel-värde parbaserade system, och dess betydelse för att syntaxen ska användas korrekt för att filen ska skapas. Jag rekommenderar att du tar en titt på en onlineintroduktionskurs till JSON för mer information om grunderna.
I vilket programmeringsspråk som helst är det important till visa lite artighet till nästa person som kommer att hantera din fil efter att du har skickat den. Zoomrum Inbyggda rumskontroller krävs inte för att uppfylla detta krav, men det rekommenderas starkt att de gör det. Det är möjligt att använda “om”-objektet för att lämna ett register över författare, version och all annan historisk information om adaptrarna i stället för “adapters”-objektet. Room Controls analyserar inte denna information, men den kommer att finnas kvar i portalen efter att den har analyserats. Detta kan utnyttjas på det sätt som visas nedan.
{
"about": {
"type": "Medium Conference A",
"version": "v1.2.4",
"design_ref": "\\files\MediumConfA",
"created": "Mon, 21 Oct 2020 16:35:52 GMT"
},
Adaptrar
När adaptrarna har ställts in kan rumskontroller anslutas till enheter. Det finns flera avsnitt i det här avsnittet som kan konfigureras för att få bästa resultat. Under hela det kapslade JSON-formatet bör varje enhet i hierarkin följa ett liknande format (det här exemplet är kapslat så att det kan jämföras med det nedan):
{
"adapters": (
{
"model": "iTachIP2SL",
"ip": "(IP_ADDRESS)",
"uuid": "GlobalCache_(UNIT_MAC_ADDRESS)",
"ports": (
{
"id": "sl_sharp_tv",
"name": "Sharp Display",
"settings": {
"baud_rate": "38400",
"flow_control": "FLOW_NONE",
"parity": "PARITY_NO"
},
"methods": (
{
"id": "power",
"name": "Power",
"command": "POWR000%\\x0D",
"params": (
{
"id": "displayOn",
"name": "On",
"value": "0001"
},
{
"id": "displayOff",
"name": "Off",
"value": "0000"
}
),
"type": "actions"
},
...
Sektionen response_filter kan hittas under sektionen ‘metoder’ för en metod. Ett svarsfilter är en beacon som identifierar vilken anslutning man ska lyssna efter på nätverket av svarsfiltren som definieras nedan. Det här området har inga funktioner definierade inom sig. Svarsfilter kommer att diskuteras i de relaterade avsnitten om hur de passar in i andra avsnitt av boken.
Stilar
Dina gränssnittselement är stylad visuellt genom användning av stilar. Det finns inte mycket att justera, så det är inte särskilt svårt att lista ut hur man gör det.
I programmets gränssnitt finns en mängd olika ikoner tillgängliga. Det finns ett brett utbud av produkter tillgängliga i dessa kategorier, såsom luftkonditionering och högtalartelefoner. Utöver ikonerna nedan, finns det andra som kommer att läggas till regelbundet i listan.
| Enhet | namn | Bild |
|---|---|---|
| luftkonditionering | icon_airconditioner | |
| kabel tv | icon_cable_tv | |
| takmikrofon | icon_ceiling_mic | |
| ridå | icon_gardin | |
| DVD-spelare | icon_dvd_player | |
| Xbox/PS4-system | icon_game_console | |
| HDMI | icon_hdmi | |
| bärbar dator | icon_laptop | |
| ljus | icon_light | |
| projektor | icon_projector | |
| rack utrustning | icon_rack_equipment | |
| parabolantenn | icon_satellite_dish | |
| högtalare | icon_speaker | |
| högtalartelefon | icon_speakerphone | |
| TV | icon_tv | |
| kraft | icon_power | |
| upp | icon_up | |
| ner | icon_down | |
| kall | icon_cold | |
| varm | icon_hot | |
| torr | icon_dry | |
| vind | icon_wind |
Bland de primära modulatorerna inom stilar finns det särskilt tre: ikoner (som vi diskuterade ovan), huvudmetoderna och stilens synlighet.
En ikon är en visuell representation av systemet som helhet. Dessa markörer kan användas antingen som ett sätt att identifiera en enhet eller som en ersättning för texten på en knapp. Det kan ses från exemplet nedan att vi har definierat en enhet som heter ‘exempel’ i vår kod.
{
"adapters": (
{
"model": "ExternalControlSystem",
"ip": "tcp://(USER_IP_ADDRESS):(USER_PORT)",
"ports": (
{
"id": "example",
"name": "Example Device",
"methods": (
...
Vi kan använda ID:t för enhetens “exempel” inom stilarna när vi har definierat det som en enhet. Vår exempelenhet kan enkelt ställas in så att den har en ljusikon som huvudikon.
"styles": (
"example.icon=icon_light",
"example.main_method=power"
)
Enhetens huvudmetod har också definierats inom en enda rad, vilket också är något du kan ha lade märke till. Som ett resultat av Main Metod, en framträdande fakturering tilldelas det refererade kommandot som du definierade:
Det finns flera kommandon listade i den övre delen bar, men Power-kommandot är det viktigaste, så det visas separat från de andra kommandona i den övre raden.
Förutom de två första typerna av stilar, Synlighet är den tredje. Programmerare kan skapa funktioner som är dolda från användarens gränssnitt helt genom att använda synlighetsfunktionen i Visual Basic Manus. Lika lätt som det kan definieras, kan det sammanfattas så här:
"example.power.invisible=true"
Detta kommando kan döljas helt för rumsanvändaren om du följer formatet “device.command.invisible=true” för att få detta kommando helt dolt för dem.
Regler
Room Controls bygger på konceptet regler, som är motorn för automatisering. Inom detta område är det möjligt att definiera saker som uppstår på egen hand utan någon extern input. Jag skulle till exempel kunna använda “meeting_started” och “meeting_ended” (stock Zoom-händelser) för att göra min skärm aktiv endast om ett möte är aktivt, så att jag bara kunde se min skärm när ett möte är aktivt.
"rules": {
"meeting_started": (
"display.power.on",
"camera.power.wake"
)
),
"meeting_ended": (
"display.power.off"
)
}
Genom att använda det här exemplet kommer du att kunna minska ditt systems strömförbrukning i betydande grad.
Kommandona kan enkelt staplas om antalet kommandon för varje regel inte räcker. Trots att dessa händelser utlöses sekventiellt, bearbetas de tillräckligt snabbt för att vi kommer att betrakta dem som samtidiga händelser. Jag har lagt till “camera.power.wake” under värdet “display.power.on” i mitt exempel ovan för att se till att min kamera skulle aktiveras när skärmen vaknade i mitt exempel.
Inom dagens regler finns det några zoomkommandon som finns i lager:
Notera: Zoomrumsinställningar låter dig ställa in drifttimmar.
Svarsfiltren kan också anpassas. Utöver triggerhändelserna som diskuteras nedan kan du också använda reglersektionen för att automatisera dina egna processer.
"rules":{
"operation_time_started":(
"light.power.on"
),
"user_customized_event1":(
"light.power.off"
)
}
“user_customized_event1” i det här exemplet kommer att släcka ljuset som styrs av vår användare. För att rummet ska kunna uppdateras kan detta drivas av en inmatning från en knapp eller av att en rörelsesensor blir inaktiv eller rummet kan till och med uppdateras av ett tredjepartssystem som ett bokningssystem som skickar en uppdatering till rummet som inte användare har checkat in för mötet. När det gäller hur den här funktionen kan användas är din fantasi den enda gränsen för hur du kan använda den.
Svar Filter
Zooma rum Inbyggda rumskontroller inkluderar svarsfilter – en kraftfull ny funktion som förbättrar funktionaliteten i Zoom Rooms. Ett filter läser meddelanden som skickas tillbaka från en definierad enhet och söker sedan direkt efter en fras som matchar meddelandet. Det finns en regelutlösande händelse som utlöses närhelst frasen (eller uttrycket) som tillhandahålls på anslutningen identifieras (beskrivs ovan).
Det finns tre element som utgör varje svarsfilter:
-
“namn”: Det finns en referens till detta namn i avsnittet “portar” i avsnittet “metoder”. Om detta namn visas i “portar”-området, spänner svarsfiltret över den anslutningen
-
“filter_regex”: Svarsfilter försöker matcha regex (eller reguljära uttryck) baserat på de tecken de hittar i svaret. “trigger_event” kommer att aktiveras om matchningen inträffar
-
“trigger_event”: Regelsektioner använder triggerhändelsen. En triggerhändelse i regler kommer att utlösas när “filter_regex” är aktiverat
Hur man använder rumskontroller
Rumskontrollikonen på Zoom Rooms kontroll ger dig tillgång till dessa ytterligare funktioner.
Under icke mötestider kan du komma åt rumskontroller från huvudmenyn.
Ett mötes rumskontroller kan nås genom att trycka på ikonen i kontrollfönstrets övre högra hörn.
Felsökning
Anpassade konfigurationer kräver felsökning. Room Controls-systemet har flexibiliteten att vara enkelt eller komplext, beroende på situationen. Du kan lösa eventuella vägspärrar genom att läsa avsnitten nedan.
Rumskontrollfel
| Felkod | Beskrivning |
|---|---|
| No_Config_Error | Webbportalen laddar inte JSON-profilen |
| Json_Syntax_Error | Ett fel har hittats i JSON-profilen |
| Json_Config_Error | Ett fel uppstod under konfigurationen av JSON-profilen |
| IP_Error | Den angivna IP-adressen går inte att nå |
| IP_Is_Public | För närvarande är offentliga IP-adresser inte tillåtna |
| DeviceID_Error | Enhets-ID för en eller flera enheter har ställts in felaktigt |
| MethodID_Error | En metod eller mer är felaktigt definierad |
| ParamID_Error | Det finns några parametrar som har definierats felaktigt |
| IP2SL_Settings_Error | Serieporten på GC IP2SL är felaktigt konfigurerad |
| Empty_Device_Error | I JSON-profilen anropades ett antal enheter som inte var definierade i profilen |
| Okänd | Det verkar som om ett okänt fel har inträffat |
Prov Filer
Vi har sammanställt dessa filer från en mängd olika källor, men de bör endast användas som referens. Beroende på din applikation kan du behöva göra några ändringar för att få det att fungera.
-
Generisk Filer
-
Zoom Room Control JSON-profil
-
Zooma Rumskontroll JSON-profil med ytterligare kommentarer
-
Generic Lighting JSON-profil (relä)
-
Generic Lighting JSON-profil (seriell)
-
-
Avocor
-
Mellersta Atlanten
-
Shure