Controles de habitación nativos de Zoom Rooms
Le brinda la capacidad de controlar equipos con capacidad IP de terceros con la función Controles de sala, lo que hace posible que el usuario controle este equipo desde el controlador Zoom Room para que sea más conveniente para el usuario. Para que el administrador de Zoom Room pueda enviar mensajes de control de IP desde Zoom Room, se puede crear un perfil de configuración.
Requisitos previos para usar Room Controls
-
Se requiere un programa de Zoom Rooms que se ejecute en macOS, Windows o un dispositivo de Zoom Rooms con la versión 5.1 o superior
-
Un dispositivo controlado por una LAN o una WLAN que pertenece a un tercero
Cómo habilitar los controles de la habitación
La configuración deberá estar habilitada para Zoom Rooms para que pueda cargar un perfil de configuración JSON. Es posible configurar esto en cualquier nivel dentro de la jerarquía de Zoom Rooms para satisfacer sus necesidades.
-
Se puede acceder al portal web de Zoom iniciando sesión.
-
Luego, seleccione la opción Zoom Rooms en Administración de habitaciones.
-
Cuando esté viendo el nombre de Zoom Room, haga clic en Editar a la derecha.
-
Asegúrese de que Habilitar controles de habitación esté activado (azul) en Dispositivos.
-
Cree un perfil haciendo clic en el botón Crear perfil.
-
La configuración JSON de esta sala debe ingresarse aquí.
Cómo escribir un perfil de Room Controls
Empezando
Es esencial tener una buena comprensión de JSON antes de poder escribir un perfil de control de sala. Hay varios puntos importantes a tener en cuenta cuando se trata de JSON: su sistema basado en pares clave-valor y su importancia para que la sintaxis se use correctamente para el archivo que se va a crear. Le recomiendo que eche un vistazo a un curso de introducción en línea a JSON para obtener más información sobre los conceptos básicos.
En cualquier lenguaje de programación, es important a extienda un poco de cortesía a la siguiente persona que se ocupará de su archivo después de haberlo enviado. No se requiere que los controles de habitación nativos de Zoom Rooms cumplan con este requisito, sin embargo, se recomienda encarecidamente que lo hagan. Es posible utilizar el objeto ‘acerca de’ para dejar un registro del autor, la versión y cualquier otra información histórica sobre los adaptadores en lugar del objeto ‘adaptadores’. Room Controls no analiza esta información, pero permanecerá en el portal después de que se haya analizado. Esto se puede aprovechar de la manera que se muestra a continuación.
{
"about": {
"type": "Medium Conference A",
"version": "v1.2.4",
"design_ref": "\\files\MediumConfA",
"created": "Mon, 21 Oct 2020 16:35:52 GMT"
},
Adaptadores
Una vez que se han configurado los adaptadores, los Room Controls se pueden conectar a los dispositivos. Hay varias secciones en esta sección que se pueden configurar para obtener los mejores resultados. A lo largo del formato JSON anidado, cada dispositivo dentro de la jerarquía debe seguir un formato similar (este ejemplo está anidado para que pueda compararse con el siguiente):
{
"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 sección response_filter se puede encontrar en la sección ‘métodos’ de un método. Un filtro de respuesta es una baliza que identifica qué conexión escuchar en la red mediante los filtros de respuesta que se definen a continuación. Esta área no tiene funciones definidas dentro de ella. Los filtros de respuesta se discutirán en las secciones relacionadas en cuanto a cómo encajan en otras secciones del libro.
Estilos
Los elementos de su interfaz son estilizado visualmente mediante el uso de estilos. No hay mucho que ajustar, por lo que no es muy difícil descubrir cómo hacerlo.
En la interfaz del programa hay una gran variedad de iconos disponibles. Hay una amplia gama de productos disponibles en estas categorías, como acondicionadores de aire y altavoces. Además de los íconos que se enumeran a continuación, hay otros que se agregarán regularmente a la lista.
| Dispositivo | Nombre | Imagen |
|---|---|---|
| aire acondicionado | icono_aire_acondicionado | |
| televisión por cable | icon_cable_tv | |
| micrófono de techo | icono_techo_mic | |
| cortina | icono_cortina | |
| Reproductor de DVD | icono_reproductor_dvd | |
| Sistema Xbox/PS4 | icon_game_console | |
| HDMI | icono_hdmi | |
| computadora portátil | icono_laptop | |
| luz | icono_luz | |
| proyector | icono_proyector | |
| equipo de estante | icon_rack_equipment | |
| antena parabólica | icon_satellite_dish | |
| vocero | icono_altavoz | |
| altavoz | icon_speakerphone | |
| TELEVISOR | icono_tv | |
| fuerza | icono_poder | |
| arriba | icono_arriba | |
| abajo | icono_abajo | |
| frío | icono_frio | |
| caliente | icono_caliente | |
| seco | icono_seco | |
| viento | icono_viento |
Entre los principales moduladores dentro de los estilos, hay tres en particular: íconos (como discutimos anteriormente), los métodos principales y la visibilidad del estilo.
Un icono es una representación visual del sistema como un todo. Estos marcadores se pueden usar como una forma de identificar un dispositivo o como reemplazo del texto en un botón. Se puede ver en el ejemplo a continuación, que hemos definido un dispositivo llamado ‘ejemplo’ en nuestro código.
{
"adapters": (
{
"model": "ExternalControlSystem",
"ip": "tcp://(USER_IP_ADDRESS):(USER_PORT)",
"ports": (
{
"id": "example",
"name": "Example Device",
"methods": (
...
Podemos usar la ID para el dispositivo ‘ejemplo’ dentro de los estilos una vez que lo hayamos definido como un dispositivo. Nuestro dispositivo de ejemplo se puede configurar fácilmente para que tenga un icono de luz como icono principal.
"styles": (
"example.icon=icon_light",
"example.main_method=power"
)
El método principal del dispositivo también se ha definido dentro de una sola línea, que también es algo que puede tener observó. Como un resultado de principal Método, se asigna una facturación destacada al comando de referencia que definió:
Hay varios comandos enumerados en la parte superior barra, pero el comando de encendido es el principal, por lo que se muestra separado del resto de comandos en la barra superior.
Además de los dos primeros tipos de estilos, Visibilidad es el tercero Los programadores pueden crear funciones que están completamente ocultas de la interfaz del usuario mediante la función de visibilidad en Visual Basic. Guion. Tan fácil como se puede definir, se puede resumir así:
"example.power.invisible=true"
Este comando se puede ocultar completamente para el usuario de las salas si sigue el formato de “device.command.invisible=true” para que este comando esté completamente oculto para ellos.
Normas
Room Controls se basa en el concepto de reglas, que son el motor de la automatización. En esta área, es posible definir cosas que ocurren por sí solas sin ningún aporte externo. Podría, por ejemplo, usar “reunión_iniciada” y “reunión_finalizada” (eventos de Zoom de stock) para hacer que mi pantalla esté activa solo si una reunión está activa, de modo que solo pueda ver mi pantalla cuando una reunión esté activa.
"rules": {
"meeting_started": (
"display.power.on",
"camera.power.wake"
)
),
"meeting_ended": (
"display.power.off"
)
}
Al usar este ejemplo, podrá reducir el consumo de energía de su sistema en un grado significativo.
Los comandos se pueden apilar fácilmente si la cantidad de comandos para cada regla no es suficiente. A pesar del hecho de que estos eventos se disparan secuencialmente, se procesan lo suficientemente rápido como para considerarlos eventos simultáneos. He agregado “camera.power.wake” debajo del valor “display.power.on” en mi ejemplo anterior para asegurarme de que mi cámara se active cuando la pantalla se active en mi ejemplo.
Dentro de las reglas actuales, hay algunos comandos de Zoom que están disponibles en stock:
Nota: La configuración de Zoom Rooms le permite establecer el horario de funcionamiento.
Los filtros de respuesta también se pueden personalizar. Además de los eventos desencadenantes que se analizan a continuación, también puede utilizar la sección de reglas para automatizar sus propios procesos.
"rules":{
"operation_time_started":(
"light.power.on"
),
"user_customized_event1":(
"light.power.off"
)
}
El “user_customized_event1” en este ejemplo apagará la luz controlada por nuestro usuario. Para que la sala se actualice, esto podría ser impulsado por una entrada de un botón o por un sensor de movimiento que se vuelve inactivo o la sala podría incluso ser actualizada por un sistema de terceros como un sistema de reserva que envía a la sala una actualización que no los usuarios se han registrado para la reunión. En términos de cómo se puede usar esta función, su imaginación es el único límite para cómo puede utilizarla.
Respuesta filtros
Los controles de habitación nativos de Zoom Rooms incluyen filtros de respuesta: un potente nuevo función que mejora la funcionalidad de Zoom Rooms. Un filtro lee los mensajes que se devuelven desde un dispositivo definido y luego busca instantáneamente una frase que coincida con el mensaje. Hay un Evento desencadenante de reglas que se activa cada vez que se identifica la frase (o expresión) proporcionada en la conexión (descrita anteriormente).
Hay tres elementos que componen cada filtro de respuesta:
-
“nombre”: Hay una referencia a este nombre en la sección “puertos” de la sección “métodos”. Si este nombre aparece en el área de “puertos”, el filtro de respuesta abarca esa conexión
-
“filtro_regex”: los filtros de respuesta intentan hacer coincidir expresiones regulares (o expresiones regulares) en función de los caracteres que encuentran en la respuesta. “trigger_event” se activará si se produce la coincidencia
-
“acontecimiento desencadenante”: Las secciones de reglas utilizan el evento desencadenante. Se activará un evento desencadenante en las reglas cuando se active “filter_regex”
Cómo usar los controles de la habitación
El ícono Room Controls en el controlador de Zoom Rooms le brinda acceso a estas funciones adicionales.
Fuera de las horas de reunión, puede acceder a los controles de sala desde el menú principal.
Se puede acceder a los controles de sala de una reunión tocando el icono en la parte superior derecha de la ventana del controlador.
Solución de problemas
Las configuraciones personalizadas requieren solución de problemas. El sistema Room Controls tiene la flexibilidad de ser simple o complejo, según la situación. Puede resolver posibles obstáculos leyendo las secciones a continuación.
Errores de control de habitaciones
| Código de error | Descripción |
|---|---|
| No_Config_Error | El portal web no carga el perfil JSON |
| Json_Syntax_Error | Se ha encontrado un error en el perfil JSON |
| Json_Config_Error | Ocurrió un error durante la configuración del Perfil JSON |
| IP_Error | No se puede acceder a la dirección IP especificada |
| IP_Is_Public | En este momento, las direcciones IP públicas no están permitidas |
| DeviceID_Error | El ID de dispositivo de uno o más dispositivos se ha configurado incorrectamente |
| MethodID_Error | Uno o más métodos están mal definidos |
| ParamID_Error | Hay algunos parámetros que se han definido incorrectamente |
| IP2SL_Configuración_Error | El puerto serie del GC IP2SL está configurado incorrectamente |
| Error_de_dispositivo_vacío | En el perfil JSON, se llamó a una cantidad de dispositivos que no estaban definidos en el perfil |
| Desconocido | Parece que ha ocurrido un error desconocido |
Muestra archivos
Hemos compilado estos archivos de una variedad de fuentes, pero solo deben usarse como punto de referencia. Dependiendo de su aplicación, es posible que deba realizar algunas modificaciones para que funcione.
-
Genérico archivos
-
Perfil JSON de Zoom Room Control
-
Perfil JSON de control de Zoom Room con comentarios adicionales
-
Perfil JSON de iluminación genérica (relé)
-
Perfil JSON de iluminación genérica (serie)
-
-
aguacate
-
Atlántico Medio
-
Shure