Zoom Rooms Comandi stanza nativi
Fornisce la possibilità di controllare apparecchiature di terze parti compatibili con IP con la funzione Controlli stanza, consentendo all’utente di controllare questa apparecchiatura dallo Zoom Room Controller per renderlo più conveniente per l’utente. Affinché l’amministratore della Zoom Room possa inviare messaggi di controllo IP dalla Zoom Room, è possibile creare un profilo di configurazione.
Prerequisiti per l’utilizzo dei controlli della stanza
-
È richiesto un programma Zoom Rooms in esecuzione su macOS, Windows o un’appliance Zoom Rooms con versione 5.1 o successiva
-
Un dispositivo controllato da una LAN o una WLAN che appartiene a terzi
Come abilitare i controlli della stanza
L’impostazione dovrà essere abilitata per Zoom Rooms per poter caricare un profilo di configurazione JSON. È possibile configurarlo a qualsiasi livello all’interno della gerarchia di Zoom Rooms per soddisfare le tue esigenze.
-
È possibile accedere al portale Web di Zoom effettuando l’accesso.
-
Quindi seleziona l’opzione Zoom Rooms in Room Management.
-
Quando visualizzi il nome della Zoom Room, fai clic su Modifica a destra di esso.
-
Assicurati che Abilita controlli stanza sia attivato (blu) in Dispositivi.
-
Crea un profilo facendo clic sul pulsante Crea profilo.
-
La configurazione JSON di questa stanza deve essere inserita qui.
Come scrivere un profilo Room Controls
Iniziare
È essenziale avere una buona conoscenza di JSON prima di poter scrivere un profilo di controllo della stanza. Ci sono diversi punti importanti da tenere presente quando si tratta di JSON: il suo sistema basato sulla coppia chiave-valore e la sua importanza per la sintassi da utilizzare correttamente per il file da creare. Ti consiglio di dare un’occhiata a un corso introduttivo online a JSON per ulteriori informazioni sulle basi.
In qualsiasi linguaggio di programmazione, è importante a estendi un po’ di cortesia alla prossima persona che si occuperà del tuo file dopo averlo inviato. Zoom Rooms I controlli nativi delle stanze non sono tenuti a soddisfare questo requisito, tuttavia si consiglia vivamente di soddisfarli. È possibile utilizzare l’oggetto ‘about’ per lasciare un record di autore, versione e qualsiasi altra informazione storica sugli adattatori al posto dell’oggetto ‘adapters’. Room Controls non analizza queste informazioni, ma rimarranno nel portale dopo essere state analizzate. Questo può essere sfruttato nel modo mostrato di seguito.
{
"about": {
"type": "Medium Conference A",
"version": "v1.2.4",
"design_ref": "\\files\MediumConfA",
"created": "Mon, 21 Oct 2020 16:35:52 GMT"
},
Adattatori
Una volta configurati gli adattatori, i Room Control possono essere collegati ai dispositivi. Ci sono diverse sezioni in questa sezione che possono essere configurate per ottenere i migliori risultati. In tutto il formato JSON nidificato, ogni dispositivo all’interno della gerarchia dovrebbe seguire un formato simile (questo esempio è nidificato in modo che possa essere confrontato con quello seguente):
{
"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"
},
...
La sezione response_filter può essere trovata nella sezione ‘methods’ di un metodo. Un filtro di risposta è un beacon che identifica quale connessione ascoltare sulla rete tramite i filtri di risposta definiti di seguito. Quest’area non ha alcuna funzione definita al suo interno. I filtri di risposta saranno discussi all’interno delle sezioni correlate su come si inseriscono in altre sezioni del libro.
Stili
I tuoi elementi di interfaccia sono disegnato visivamente attraverso l’uso degli stili. Non c’è molto da regolare, quindi non è molto difficile capire come farlo.
Nell’interfaccia del programma è disponibile un’ampia varietà di icone. C’è una vasta gamma di prodotti disponibili in queste categorie, come condizionatori d’aria e vivavoce. Oltre alle icone elencate di seguito, ce ne sono altre che verranno aggiunte regolarmente all’elenco.
| Dispositivo | Nome | Immagine |
|---|---|---|
| condizionatore | icon_air_conditioner | |
| tv via cavo | icon_cable_tv | |
| microfono da soffitto | icon_ceiling_mic | |
| tenda | icona_tenda | |
| Lettore DVD | icon_dvd_player | |
| Sistema Xbox/PS4 | icon_game_console | |
| HDMI | icona_hdmi | |
| computer portatile | icon_laptop | |
| leggero | icon_light | |
| proiettore | icon_projector | |
| attrezzatura a cremagliera | icon_rack_equipment | |
| antenna parabolica | icon_satellite_dish | |
| altoparlante | icona_altoparlante | |
| vivavoce | icon_speakerphone | |
| tv | icon_tv | |
| energia | icon_power | |
| su | icon_up | |
| giù | icon_down | |
| Freddo | icon_cold | |
| caldo | icon_hot | |
| Asciutto | icon_dry | |
| vento | icona_vento |
Tra i principali modulatori all’interno degli stili, ce ne sono tre in particolare: le icone (come discusso sopra), i metodi principali e la visibilità dello stile.
Un’icona è una rappresentazione visiva del sistema nel suo complesso. Questi marcatori possono essere utilizzati sia per identificare un dispositivo sia per sostituire il testo su un pulsante. Si può vedere dall’esempio seguente che abbiamo definito un dispositivo chiamato ‘example’ nel nostro codice.
{
"adapters": (
{
"model": "ExternalControlSystem",
"ip": "tcp://(USER_IP_ADDRESS):(USER_PORT)",
"ports": (
{
"id": "example",
"name": "Example Device",
"methods": (
...
Possiamo usare l’ID per il dispositivo ‘example’ all’interno degli stili dopo averlo definito come dispositivo. Il nostro dispositivo di esempio può essere facilmente impostato per avere un’icona luminosa come icona principale.
"styles": (
"example.icon=icon_light",
"example.main_method=power"
)
Anche il metodo principale del dispositivo è stato definito all’interno di una singola riga, che è anche qualcosa che potresti avere si accorse. COME un risultato di Principale Metodo, una fatturazione prominente viene assegnata al comando di riferimento che hai definito:
Ci sono diversi comandi elencati in alto barra, ma il comando power è quello principale, quindi viene visualizzato separatamente dagli altri comandi nella barra superiore.
Oltre ai primi due tipi di stili, Visibilità è il terzo. I programmatori possono creare funzioni che sono completamente nascoste dall’interfaccia utente utilizzando la funzionalità di visibilità in Visual Basic Sceneggiatura. Per quanto semplice possa essere definito, può essere riassunto in questo modo:
"example.power.invisible=true"
Questo comando può essere completamente nascosto all’utente delle stanze se si segue il formato “device.command.invisible=true” per nascondere completamente questo comando.
Regole
Room Controls si basa sul concetto di regole, che sono il motore dell’automazione. In quest’area è possibile definire cose che accadono da sole senza alcun input esterno. Potrei, ad esempio, utilizzare “meeting_started” e “meeting_ended” (eventi Zoom stock) per rendere attivo il mio display solo se è attivo un meeting, in modo da poter vedere il mio display solo quando è attivo un meeting.
"rules": {
"meeting_started": (
"display.power.on",
"camera.power.wake"
)
),
"meeting_ended": (
"display.power.off"
)
}
Utilizzando questo esempio, sarai in grado di ridurre il consumo energetico del tuo sistema in misura significativa.
I comandi possono essere facilmente impilati se il numero di comandi per ogni regola non è sufficiente. Nonostante il fatto che questi eventi si attivino in sequenza, vengono elaborati abbastanza rapidamente da considerarli eventi simultanei. Ho aggiunto “camera.power.wake” sotto il valore “display.power.on” nel mio esempio sopra per assicurarmi che la mia fotocamera fosse attivata quando il display si è svegliato nel mio esempio.
All’interno delle regole odierne, ci sono alcuni comandi Zoom disponibili in magazzino:
Nota: le impostazioni di Zoom Rooms consentono di impostare le ore di funzionamento.
Anche i filtri di risposta possono essere personalizzati. Oltre agli eventi trigger discussi di seguito, puoi anche utilizzare la sezione delle regole per automatizzare i tuoi processi.
"rules":{
"operation_time_started":(
"light.power.on"
),
"user_customized_event1":(
"light.power.off"
)
}
Il “user_customized_event1” in questo esempio spegnerà la luce controllata dal nostro utente. Affinché la stanza venga aggiornata, questo potrebbe essere guidato da un input da un pulsante o da un sensore di movimento che diventa inattivo o la stanza potrebbe anche essere aggiornata da un sistema di terze parti come un sistema di prenotazione che invia alla stanza un aggiornamento che non gli utenti hanno effettuato il check-in per la riunione. In termini di come questa funzione può essere utilizzata, la tua immaginazione è l’unico limite a come puoi utilizzarla.
Risposta Filtri
Zoom Rooms I controlli nativi delle stanze includono i filtri di risposta: un potente nuovo caratteristica che migliora la funzionalità di Zoom Rooms. Un filtro legge i messaggi che vengono rispediti da un dispositivo definito, quindi cerca istantaneamente una frase che corrisponda al messaggio. Esiste un evento di attivazione delle regole che viene attivato ogni volta che viene identificata la frase (o l’espressione) fornita sulla connessione (descritta sopra).
Ci sono tre elementi che compongono ogni filtro di risposta:
-
“nome”: C’è un riferimento a questo nome nella sezione “porte” della sezione “metodi”. Se questo nome viene visualizzato nell’area “porte”, il filtro di risposta si estende su quella connessione
-
“filtro_regex”: I filtri di risposta tentano di abbinare regex (o espressioni regolari) in base ai caratteri che trovano nella risposta. “trigger_event” verrà attivato se si verifica la corrispondenza
-
“evento scatenante”: le sezioni delle regole utilizzano l’evento di attivazione. Un evento di attivazione nelle regole verrà attivato quando viene attivato “filter_regex”.
Come utilizzare i controlli della stanza
L’icona Controlli stanza sul controller di Zoom Rooms ti dà accesso a queste funzionalità aggiuntive.
Durante gli orari in cui non ci sono riunioni, puoi accedere a Controlli stanza dal menu principale.
È possibile accedere ai controlli della stanza di una riunione toccando l’icona in alto a destra nella finestra del controller.
Risoluzione dei problemi
Le configurazioni personalizzate richiedono la risoluzione dei problemi. Il sistema Room Controls ha la flessibilità di essere semplice o complesso, a seconda della situazione. Puoi risolvere eventuali blocchi stradali leggendo le sezioni seguenti.
Errori di controllo della stanza
| Codice di errore | Descrizione |
|---|---|
| No_Config_Error | Il portale Web non carica il profilo JSON |
| Json_Syntax_Error | È stato rilevato un errore nel profilo JSON |
| Json_Config_Error | Si è verificato un errore durante la configurazione del profilo JSON |
| Errore_IP | L’indirizzo IP specificato non è raggiungibile |
| IP_Is_Public | Al momento, gli indirizzi IP pubblici non sono consentiti |
| ID dispositivo_Errore | L’ID dispositivo di uno o più dispositivi è stato impostato in modo errato |
| ID_metodo_errore | Uno o più metodi sono definiti in modo errato |
| ParamID_Error | Ci sono alcuni parametri che sono stati definiti in modo errato |
| IP2SL_Impostazioni_Errore | La porta seriale sul GC IP2SL non è configurata correttamente |
| Errore_dispositivo_vuoto | Nel profilo JSON, è stato chiamato un numero di dispositivi che non erano definiti nel profilo |
| Sconosciuto | Sembra che si sia verificato un errore sconosciuto |
Campione File
Abbiamo compilato questi file da una varietà di fonti, ma dovrebbero essere usati solo come punto di riferimento. A seconda dell’applicazione, potrebbe essere necessario apportare alcune modifiche per farlo funzionare.
-
Generico File
-
Zoom Room Control Profilo JSON
-
Zoom Room controlla il profilo JSON con commenti aggiuntivi
-
Profilo JSON di illuminazione generico (relè)
-
Profilo JSON di illuminazione generico (seriale)
-
-
Avocor
-
Medio Atlantico
-
sicuro