Zoom Rooms Controles Nativos da Sala

Zoom Rooms Controles Nativos da Sala

Ele fornece a capacidade de controlar equipamentos de terceiros compatíveis com IP com o recurso Controles de sala, possibilitando ao usuário controlar esse equipamento a partir do Controlador de sala de zoom para torná-lo mais conveniente para o usuário. Para que o administrador da Zoom Room possa enviar mensagens de controle de IP da Zoom Room, um perfil de configuração pode ser criado.

Pré-requisitos para usar os Controles de sala

  • É necessário um programa Zoom Rooms em execução no macOS, Windows ou um dispositivo Zoom Rooms executando a versão 5.1 ou superior

  • Um dispositivo controlado por uma LAN ou WLAN que pertence a terceiros

Como habilitar os controles de sala

A configuração precisará ser habilitada para Zoom Rooms para que você possa carregar um perfil de configuração JSON. É possível configurá-lo em qualquer nível dentro da hierarquia do Zoom Rooms para atender às suas necessidades.

  1. O portal da Web do Zoom pode ser acessado fazendo login.

  2. Em seguida, selecione a opção Zoom Rooms em Room Management.

  3. Ao visualizar o nome da sala de zoom, clique em Editar à direita.

  4. Certifique-se de que Ativar controles de sala esteja ativado (azul) em Dispositivos.

  5. Crie um perfil clicando no botão Criar perfil.

  6. A configuração JSON desta sala deve ser inserida aqui.

Como escrever um perfil de Controles de sala

Começando

É essencial ter um bom entendimento do JSON antes de escrever um perfil de controle de sala. Existem vários pontos importantes a serem observados quando se trata de JSON: seu sistema baseado em pares chave-valor e sua importância para que a sintaxe seja usada corretamente para o arquivo a ser criado. Eu recomendo que você dê uma olhada em um curso de introdução online ao JSON para obter mais informações sobre o básico.

Em qualquer linguagem de programação, é important para Estenda alguma cortesia para a próxima pessoa que lidará com seu arquivo depois de enviá-lo. Controles de sala nativos de salas de zoom não são necessários para atender a esse requisito, no entanto, é altamente recomendável que o façam. É possível usar o objeto ‘sobre’ para deixar um registro de autor, versão e qualquer outra informação histórica sobre os adaptadores no lugar do objeto ‘adaptadores’. O Room Controls não analisa essas informações, mas elas permanecerão no portal depois de analisadas. Isso pode ser aproveitado da maneira mostrada abaixo.

{
"about": {
"type": "Medium Conference A",
"version": "v1.2.4",
"design_ref": "\\files\MediumConfA",
"created": "Mon, 21 Oct 2020 16:35:52 GMT"
},

Adaptadores

Depois que os adaptadores forem configurados, os controles de sala podem ser conectados aos dispositivos. Existem várias seções nesta seção que podem ser configuradas para obter os melhores resultados. Ao longo do formato JSON aninhado, todos os dispositivos dentro da hierarquia devem seguir um formato semelhante (este exemplo é aninhado para que possa ser comparado ao abaixo):

{
"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" 
                                },
...

A seção response_filter pode ser encontrada na seção ‘métodos’ de um método. Um Filtro de Resposta é um sinalizador que identifica qual conexão escutar na rede pelos Filtros de Resposta definidos abaixo. Esta área não possui nenhuma função definida dentro dela. Os filtros de resposta serão discutidos nas seções relacionadas sobre como eles se encaixam em outras seções do livro.

See also  Personalizando o plano de fundo do Zoom Rooms

estilos

Seus elementos de interface são estilizado visualmente através do uso de estilos. Não há muito o que ajustar, então não é muito difícil descobrir como fazer isso.

Na interface do programa, há uma grande variedade de ícones disponíveis. Há uma grande variedade de produtos disponíveis nessas categorias, como ar-condicionado e viva-voz. Além dos ícones listados abaixo, existem outros que serão adicionados regularmente à lista.

Dispositivo Nome Imagem
ar condicionado icon_air_conditioner
TV a cabo icon_cable_tv
microfone de teto icon_ceiling_mic
cortina icon_curtain
Leitor de DVD icon_dvd_player
Sistema Xbox/PS4 icon_game_console
HDMI icon_hdmi
computador portátil icon_laptop
luz icon_light
projetor icon_projector
equipamento de rack icon_rack_equipment
antena parabólica icon_satellite_dish
palestrante icon_speaker
viva voz icon_speakerphone
televisão icon_tv
poder icon_power
acima icon_up
abaixo icon_down
frio icon_cold
quente icon_hot
seco icon_dry
vento icon_wind

Entre os principais moduladores dentro dos estilos, existem três em particular: os ícones (como discutimos acima), os Métodos Principais e a Visibilidade do estilo.

Um ícone é uma representação visual do sistema como um todo. Esses marcadores podem ser usados ​​como uma forma de identificar um dispositivo ou como um substituto para o texto em um botão. Pode ser visto no exemplo abaixo, que definimos um dispositivo chamado ‘exemplo’ em nosso código.

{
"adapters": (
            {
            "model": "ExternalControlSystem",
            "ip": "tcp://(USER_IP_ADDRESS):(USER_PORT)",
            "ports": (
                     {
                     "id": "example",
                     "name": "Example Device",
                     "methods": (
...

Podemos usar o ID para o dispositivo ‘exemplo’ dentro dos estilos, uma vez que o definimos como um dispositivo. Nosso dispositivo de exemplo pode ser facilmente configurado para ter um ícone de luz como ícone principal.

"styles": (
          "example.icon=icon_light",
          "example.main_method=power"
          )

O método principal do dispositivo também foi definido em uma única linha, que também é algo que você pode ter percebido. Como um resultado do principal Método, um faturamento proeminente é atribuído ao comando referenciado que você definiu:

Existem vários comandos listados na parte superior barra, mas o comando power é o principal, por isso é exibido separadamente dos demais comandos na barra superior.

Além dos dois primeiros tipos de estilos, Visibilidade é o terceiro. Os programadores podem criar funções completamente ocultas da interface do usuário usando o recurso de visibilidade no Visual Basic Roteiro. Tão facilmente quanto pode ser definido, pode ser resumido assim:

"example.power.invisible=true"

Este comando pode ser completamente escondido do usuário das salas se você seguir o formato de “device.command.invisible=true” para ter este comando totalmente escondido deles.

Regras

O Room Controls é baseado no conceito de regras, que são o motor da automação. Nesta área, é possível definir coisas que ocorrem por conta própria, sem nenhuma entrada externa. Eu poderia, por exemplo, usar “meeting_started” e “meeting_ended” (eventos de zoom padrão) para tornar minha exibição ativa apenas se uma reunião estiver ativa, para que eu só possa ver minha exibição quando uma reunião estiver ativa.

"rules": {
          "meeting_started": (
                             "display.power.on",
                             "camera.power.wake"
                             )
          ),
          "meeting_ended": (
                           "display.power.off"
                           )
          }

Usando este exemplo, você poderá reduzir significativamente o consumo de energia do seu sistema.

Os comandos podem ser facilmente empilhados se o número de comandos para cada regra não for suficiente. Apesar do fato de que esses eventos disparam sequencialmente, eles são processados ​​com rapidez suficiente para considerá-los eventos simultâneos. Eu adicionei “camera.power.wake” sob o valor “display.power.on” no meu exemplo acima para garantir que minha câmera seria ativada quando a tela acordasse no meu exemplo.

Dentro das regras de hoje, existem alguns comandos de Zoom disponíveis em estoque:

Observação: As configurações do Zoom Rooms permitem que você defina o horário de funcionamento.

Os filtros de resposta também podem ser personalizados. Além dos eventos de gatilho discutidos abaixo, você também pode usar a seção de regras para automatizar seus próprios processos.

"rules":{
        "operation_time_started":(
                                "light.power.on"
                                ),
        "user_customized_event1":(
                                "light.power.off"
                                 )
         }

O “user_customized_event1” neste exemplo desligará a luz controlada por nosso usuário. Para que o quarto seja atualizado, isso pode ser acionado por uma entrada de um botão ou por um sensor de movimento que fica inativo ou o quarto pode até ser atualizado por um sistema de terceiros, como um sistema de reserva, enviando ao quarto uma atualização que não os usuários fizeram check-in para a reunião. Em termos de como esse recurso pode ser usado, sua imaginação é o único limite de como você pode utilizá-lo.

Resposta Filtros

Zoom Rooms Native Room Controls incluem filtros de resposta – um poderoso novo recurso que aprimora a funcionalidade do Zoom Rooms. Um filtro lê as mensagens que são enviadas de volta de um dispositivo definido e, em seguida, procura instantaneamente uma frase que corresponda à mensagem. Existe um Evento Gatilho de Regras que é disparado sempre que a frase (ou expressão) fornecida na conexão é identificada (descrita acima).

Existem três elementos que compõem cada filtro de resposta:

  • “nome”: Há uma referência a este nome na seção “portas” da seção “métodos”. Se esse nome aparecer na área “portas”, o filtro de resposta abrange essa conexão

  • “filter_regex”: os filtros de resposta tentam corresponder regex (ou expressões regulares) com base nos caracteres que encontram na resposta. “trigger_event” será ativado se a correspondência ocorrer

  • “trigger_event”: as seções de regra usam o evento de acionamento. Um Evento Trigger nas Regras será acionado quando o “filter_regex” for ativado

Como usar os controles de sala

O ícone Room Controls no controlador Zoom Rooms fornece acesso a esses recursos adicionais.

Fora dos horários de reunião, você pode acessar os Controles da sala no menu principal.

Os Controles da sala de uma reunião podem ser acessados ​​tocando no ícone no canto superior direito da janela do controlador.

Solução de problemas

As configurações personalizadas requerem solução de problemas. O sistema Room Controls tem a flexibilidade de ser simples ou complexo, dependendo da situação. Você pode resolver possíveis obstáculos lendo as seções abaixo.

Erros de Controle de Sala

Erro de código Descrição
No_Config_Error O portal da Web não carrega o perfil JSON
Json_Syntax_Error Foi encontrado um erro no perfil JSON
Json_Config_Error Ocorreu um erro durante a configuração do Perfil JSON
IP_Error O endereço IP especificado não está acessível
IP_Is_Public No momento, endereços IP públicos não são permitidos
DeviceID_Error A ID do dispositivo de um ou mais dispositivos foi definida incorretamente
MethodID_Error Um método ou mais está definido incorretamente
ParamID_Error Existem alguns parâmetros que foram definidos incorretamente
IP2SL_Settings_Error A porta serial no GC IP2SL está configurada incorretamente
Empty_Device_Error No Perfil JSON, foram chamados vários dispositivos que não estavam definidos no perfil
Desconhecido Parece que ocorreu um erro desconhecido

Amostra arquivos

Compilamos esses arquivos de várias fontes, mas eles devem ser usados ​​apenas como ponto de referência. Dependendo do seu aplicativo, você pode precisar fazer algumas modificações para fazê-lo funcionar.

  • Genérico arquivos

    • Perfil JSON de controle da sala de zoom

    • Perfil JSON de controle Zoom Room com comentários adicionais

    • Perfil JSON de Iluminação Genérica (Relay)

    • Perfil JSON de Iluminação Genérica (Serial)

  • abacate

  • Atlântico médio

  • Shure

Similar Posts