Macros

Uma macro é um pequeno programa JavaScript executado localmente no seu dispositivo. Por exemplo, você pode programar seu dispositivo para atender automaticamente chamadas de números específicos.

As macros podem executar comandos da Interface de Programação de Aplicativos (API) para seus dispositivos, bem como para sistemas de terceiros.

Todas as macros ativas são executadas em um único processo no dispositivo, chamado Tempo de execução. Na interface web do dispositivo você pode iniciar e parar o tempo de execução, conforme necessário. O Runtime está em área restrita e o código é isolado com segurança do software padrão do dispositivo.

Você pode gerenciar macros no Control Hub ou no Editor de macro na interface da web do dispositivo. Para configurar macros no Control Hub, primeiro você precisa habilitar o provisionamento de macro para seus dispositivos.

No Control Hub, você pode ver as alterações feitas nas macros no histórico do dispositivo.

Extensões de IU

Uma extensão de UI é um botão ou painel personalizado que você mesmo cria e adiciona à tela sensível ao toque do seu dispositivo. Por exemplo, adicione um botão "Discagem rápida" para ligar para um número usado com frequência ou programe seu dispositivo para atender automaticamente chamadas de números específicos.

As extensões de UI também podem controlar periféricos de terceiros, como luzes, persianas e interruptores de vídeo. Quando o dispositivo de vídeo e os periféricos são controlados pela mesma interface de usuário, você obtém uma experiência de usuário consistente na sala de reuniões. A comunicação com os sistemas de controle de terceiros é feita através do API de terceiros.

A plataforma aberta permite que você crie personalizações que se anexam aos seus fluxos de trabalho existentes; assim, permitindo que você crie valor adicional além da oferta principal Webex.

Alguns exemplos incluem:

  • Exibindo dados personalizados do servidor web na tela principal.

  • Relatar problemas a um sistema de tickets.

  • Coleta de dados acústicos da sala e envio para um servidor web onde podem ser plotados.

  • Controlar periféricos de terceiros, como luzes, persianas e switchers de vídeo.

Você pode criar extensões de IU no Editor de extensões de IU na interface da Web do dispositivo.

Habilitar o provisionamento de macro fornece acesso de leitura e gravação a macros dispositivo por dispositivo no Control Hub. Depois de habilitados, todos os dispositivos registrados no modo compartilhado carregarão suas macros no Control Hub. Os administradores podem então editar o código-fonte da macro, baixar cópias locais e carregar as macros para outros dispositivos.

Para ativar o provisionamento de macros, acesse Dispositivos > Configurações > Macros no Control Hub e ative Permitir que o Control Hub gerencie macros.


  • Esteja ciente de que todas as macros serão armazenadas e criptografadas na Cisco Cloud. Se suas macros contiverem dados confidenciais, você não deverá ativar o provisionamento de macro do Control Hub.

  • O provisionamento de macros do Control Hub se aplica apenas a dispositivos de modo compartilhado.


Você deve primeiro ativar o provisionamento de macros do Control Hub conforme descrito acima.

O provisionamento de macro é fornecido para um único dispositivo. Para compartilhar macros entre dispositivos, você pode baixar uma macro de um dispositivo e carregá-la em outro dispositivo.

Para acessar macros para dispositivos em modo compartilhado:

  1. Na visualização do cliente em https://admin.webex.com, acesse Dispositivos e selecione o dispositivo que deseja configurar.

  2. Acesse Configurações e selecione Macros.


Painel Macros de dispositivos do Control Hub

A partir daqui, você pode:

  • Crie, edite e exclua macros.

  • Carregar e baixar macros (*.js).

  • Habilite ou desabilite macros.

  • Salvar suas alterações.

  • Visualize registros de macro.


Se alguém editou simultaneamente as mesmas macros de outro local da web, serão apresentadas opções para baixar uma cópia da sua versão, descartar sua versão ou substituir a outra versão.

O Editor de Macro fornece um editor de código, ferramentas de registro e controles para testes rápidos de macros.


Editor de macros

Faça login na interface da Web do dispositivo usando credenciais de Administrador e navegue até Personalização > Editor de macros. A partir daqui, você pode:

  • Crie, edite e exclua macros.

  • Importe ou exporte macros (*.js).

  • Habilite ou desabilite macros.

  • Revise os logs de depuração.

  • Salve suas alterações (Ctrl+S)


    Se alguém editou simultaneamente a mesma macro de outro local da web, serão apresentadas opções para baixar uma cópia da sua versão, descartar sua edição ou substituir a outra versão.

O Editor de extensões de IU fornece ferramentas para criar:

  • Botões de ação - Um botão adicionado à página inicial. O botão de ação pode ser programado para executar ações quando um usuário toca nele.

  • Painéis - Um painel de controle pode conter muitos elementos de UI (por exemplo, botões, campos de texto, interruptores, controles deslizantes), todos os quais podem ser programados para executar ações. Isso pode permitir que você combine seu próprio grupo de controles em um local comum.

  • Aplicativos da Web – um atalho de aplicativo da Web adicionado à página inicial. O aplicativo da web iniciará uma página da web predefinida em tela inteira. Isto está disponível em todos os dispositivos com um Web Engine (ou seja, dispositivos Board e Desk Series, excluindo DX).

Faça login na interface da web do dispositivo usando Administrador, RoomControl, ou Integrador credenciais e navegue até Costumização > Editor de extensões de UI.


Editor de extensões de UI

A partir daqui, você pode:

  • Adicione, carregue, baixe ou exclua uma extensão de IU.

  • Crie e configure vários tipos de controles.

  • Defina uma extensão de IU como ativa ou inativa.

  • Defina quando a extensão da UI ficará visível.

  • Exporte suas extensões de UI para o dispositivo de vídeo ou para um arquivo no seu computador.

Para conectar uma extensão de UI a uma macro, você precisa usar o exclusivo Eu ia para o item. Por exemplo, o ID da sua alternância pode ser "lights_on". Então, você escreveria uma macro que monitorasse os toques na tela e quando detectasse que o botão "lights_on" foi tocado, emitiria o comando desejado (por exemplo, ligar/desligar as luzes).

Para obter exemplos de conexão de extensões de UI a macros, consulte aqui.