AXIS Audio Manager Center

O AXIS Audio Manager Center é uma solução segura e expansível para o gerenciamento e monitoramento remotos de sistemas de áudio grandes e complexos.

• Organize seus sites de áudio – Você pode organizar seus sites de áudio do AXIS Audio Manager Edge em uma estrutura que atenda à sua organização.

Exemplo

Um local chamado “França“ poderia conter um local chamado “Paris“, que, por sua vez, contém todos os sites de áudio localizados em Paris.

Exemplo

Um local chamado “Região de vendas Sul“ poderia conter todas as cidades pertencentes a essa região, que, por sua vez, contém todos os sites de áudio localizados nessas cidades.

• Monitore seu sistema – As exibições Dashboard (Painel) e Audio sites (Sites de áudio) fornecem uma visão geral do seu sistema. A funcionalidade de filtragem facilita a solução de problemas.

• Acesse seus sites remotamente – Acesse a interface do usuário de seus sites remotamente de forma segura via modo de exibição Sites.

• Gerencie usuários — Convide usuários e adicione cada um a um ou mais grupos de usuários. Cada grupo de usuários recebe um direito de acesso específico e é atribuído a um local ou site de áudio na estrutura de sites de áudio.

Exemplo

Um único usuário pode fazer parte de um grupo com direitos de gerente de conteúdo na Europa, mas também pertencer a um grupo com direitos de administrador em um site de áudio em Paris, França.

• Recursos premium

• • Scheduling (Programações) – Programe comunicados, anúncios e música para vários sites de áudio.

Para conhecer os novos recursos de cada versão do AXIS Audio Manager Center, acesse help.axis.com/whats-new-in-axis-audio-manager-center.

• É necessário ter instalado e configurado pelo menos um site de áudio do AXIS Audio Manager Edge. Para obter mais informações, visite o Manual do Usuário do AXIS Audio Manager Edge.

• Para permitir a comunicação entre o AXIS Audio Manager Edge e o AXIS Audio Manager Center, as seguintes portas devem estar abertas para tráfego de saída na rede em que o dispositivo líder está localizado:

• DNS	Detecção automática	Informações
  dispatchse1-st.axis.com ​dispatchse2-st.axis.com ​dispatcher-st.axis.com ​dispatchus1-st.axis.com dispatchjp1-st.axis.com	443, 80 Saída, TCP	Canal de comunicação de dispositivos proprietários. Uma dessas portas é necessária. A porta 80 será usada somente se a porta 443 não estiver disponível.
  *.devices.audiomanager.axis.com	443 Saída, TCP	Canal de comunicação de dispositivos proprietários.
  a1ecdk2dyb75d7-ats.iot.eu-west-1.amazonaws.com	8883 Saída, TCP	Canal MQTT usado para enviar e receber dados de integridade de um dispositivo para o serviço de nuvem.
  content.audiomanager.axis.com	443 Saída, TCP	Necessário para a distribuição de conteúdo em agendamentos.

1. Vá para audiomanager.axis.com em seu navegador da Web.

2. Faça login usando as credenciais de usuário da sua conta My Axis. Se não tiver uma conta My Axis, você poderá criar uma na janela de login.

3. No primeiro login, será necessário criar sua organização.

Quando você for convidado para fazer parte de uma organização, receberá um email com um link de convite do AXIS Audio Manager Center com o assunto “Convite de usuário para uma organização“.

1. Para aceitar o convite, clique no link incluído ou cole-o em seu navegador.

2. Faça login usando as credenciais de usuário da sua conta My Axis. Se não tiver uma conta My Axis, você poderá criar uma na janela de login.

3. Você será direcionado automaticamente para a organização para a qual foi convidado.

Organize seus sites de áudio em uma estrutura que facilite a localização de um site ou grupo de sites na organização. Você pode atribuir grupos de usuários a sites de áudio individuais ou a grupos de sites de áudio, selecionando locais na estrutura. Para obter mais informações, consulte Gerenciar usuários.

1. Vá para Audio sites (Sites de áudio).

2. Para criar um local:

3. 1. Vá para uma posição na estrutura.

   2. Clique em + Create (+ Criar).

   3. Atribua um nome ao local e clique em Create (Criar).

Exemplo

Ative a integração ao AXIS Audio Manager Center nos sites de áudio que deseja adicionar:

1. Faça login localmente em seu site de áudio do AXIS Audio Manager Edge.

2. Vá para System settings (Configurações do sistema) > Connectivity (Conectividade).

3. Marque a caixa de seleção para a AXIS Audio Manager Center integration (Integração ao AXIS Audio Manager Center).

4. Se necessário, selecione AXIS Audio Manager Center O3C proxy (Proxy do AXIS Audio Manager Center O3C) e insira os detalhes de proxy da sua organização para a rede em que o site de áudio está localizado.

5. Clique em SAVE (SALVAR).

Adicione um site de áudio a um local:

1. No AXIS Audio Manager Center, vá para Audio sites (Sites de áudio).

2. Selecione o local na estrutura.

3. Clique em + ADD AUDIO SITE (+ ADICIONAR SITE DE ÁUDIO).

4. Insira o nome do site, N/S (endereço MAC) e a chave OAK (chave de autenticação do proprietário) do dispositivo usado como líder no site de áudio.

   Exemplos de formatos:
   - S/N: XXXXXXXXXXXX (12 digit hexadecimal)
   - OAK: XXXXXXXXXXXX (12 digit hexadecimal)

   Para encontrar a chave OAK:

5. 1. Faça login localmente em seu site de áudio do AXIS Audio Manager Edge.

   2. Vá para System settings (Configurações do sistema) > Leader device settings (Configurações do dispositivo líder).

   3. Clique em Go to device settings (Ir para configurações do dispositivo).

   4. Vá para System (Sistema) > Network (Rede).

   5. Em One-click cloud connection (Conexão à nuvem com um clique) e Owner authentication key (OAK) (Chave de autenticação do proprietário (OAK)), clique em Get key (Obter chave).

   6. Observação

      Você encontrará o N/S (endereço MAC) e a chave OAK (chave de autenticação do proprietário) em uma nota fornecida com o produto que é usado como líder no sistema de áudio.

      Entre em contato com a Axis caso perca a nota. Uma prova de propriedade é necessária para receber uma nova chave.

6. Defina a localização geográfica do site de áudio:

7. 1. Selecione Place audio site on map (Posicionar o site de áudio no mapa).

   2. Escreva um endereço na pesquisa para aumentar o zoom naquela localização.

   3. Clique no mapa para adicionar a localização.

8. Para alterar ou remover o local posteriormente, acesse Audio sites (Sites de áudio), clique na linha do site de áudio para mostrar os detalhes do site e, em seguida, role para baixo até o mapa.

1. Vá para Audio sites (Sites de áudio).

2. Clique na linha de um site de áudio para visualizar seus respectivos detalhes.

   Você também pode clicar no site de áudio no mapa.

3. Visualize e edite os detalhes do site de áudio:

4. • Encontre informações sobre o dispositivo principal, como versão do AXIS OS, número de série e nome do produto.

   • Edite ou remova a localização geográfica no mapa.

   • Visualize ou altere o horário de funcionamento do site de áudio.

   • Baixe um arquivo de relatório de servidor para solucionar problemas.

Ao criar uma nova organização, você se torna seu proprietário e, assim, recebe o nível de acesso mais alto como parte do grupo de Administradores da organização. Os usuários pertencentes a este grupo terão acesso total de leitura e gravação às configurações da organização, incluindo todos os locais e sites. Para transferir a propriedade, você deve elevar um usuário para a função de proprietário. Deve haver pelo menos um proprietário de uma organização.

Para usar o AXIS Audio Manager Center você deve ser registrado como um usuário em uma organização. Há quatro funções de usuário pré-definidas:

• Administrator (Administrador) – Os administradores têm acesso de leitura/gravação aos locais e aos sites de áudio que são atribuídos ao grupo de usuários. Se eles forem atribuídos a um local na estrutura de sites de áudio, eles poderão adicionar novos locais e sites de áudio abaixo desse local.

• Content manager (Gerente de conteúdo) – Os gerentes de conteúdo têm acesso para carregar e programar conteúdo (música, anúncios e comunicados) em todos os sites de áudio atribuídos a seus grupos de usuários. Se eles forem atribuídos a um local na estrutura de sites de áudio, terão acesso a todos os sites de áudio abaixo desse local. Os gerentes de conteúdo também podem definir o horário de funcionamento e definir os volumes de música dos sites de áudio a eles atribuídos.

• Playback operator (Operador de reprodução) – Os operadores de reprodução têm acesso à definição de volumes de música em todos os sites de áudio atribuídos a seus grupos de usuários. Se eles forem atribuídos a um local na estrutura de sites de áudio, terão acesso a todos os sites de áudio abaixo desse local.

O total de direitos de acesso para usuários é decidido pelos grupos de usuários dos quais eles são membros. Cada grupo de usuários possui uma função de usuário definida e possui sites de áudio atribuídos ao grupo. Um usuário pode ser membro de vários grupos de usuários, e os direitos de acesso mais elevados para um site de áudio específico têm precedência para ele.

Exemplo

Imagine um usuário que pertence a ambos os grupos a seguir:

• Grupo: Gerentes de conteúdo França

• • Função de usuário: Gerente de conteúdo

  • Localização: França

• Grupo: Administradores Paris

• • Função de usuário: Administrador

  • Localização: Paris (sublocalização de França)

O usuário terá direitos de gerenciamento de conteúdo para todos os sites de áudio na França, exceto aqueles em Paris, sobre os quais o usuário terá direitos de administrador. Isso ocorre porque os direitos de administrador são de nível mais alto do que os direitos de gerenciamento de conteúdo. Quando um usuário pertence a vários grupos, é possível que várias funções de usuário se apliquem ao mesmo local. Quando isso ocorre, somente a função de usuário com o nível mais alto de direitos de acesso será aplicada ao local.

1. Convide um usuário para sua organização:

2. Vá para User management (Gerenciamento de usuários).

3. Observação

   Disponível apenas para proprietários e administradores no nível da organização.

4. Crie um grupo de usuários e atribua a ele uma função de usuário e acesso ao site de áudio:

5. 1. Clique em CREATE (CRIAR).

   2. Nome do grupo de usuários.

   3. Selecione uma função de usuário.

   4. Clique em CREATE (CRIAR).

   5. Clique em Add (Adicionar) próximo a Location (Local).

   6. Selecione um site de áudio para acessar um único site de áudio ou um local para ter acesso a todos os sites de áudio abaixo desse local.

6. Convide um novo usuário para o grupo de usuários:

7. 1. Clique em Add (Adicionar) próximo a Members (Membros).

   2. Clique em INVITE USER (Convidar usuário).

   3. Insira o endereço de email do usuário que deseja convidar.

      O grupo de usuários é pré-selecionado.

   4. Grave uma mensagem que será incluída no convite por email.

   5. Clique em INVITE (Convidar).

Os usuários convidados receberão um email com um link para sua organização. Ao seguirem o link, eles serão solicitados a fazer login. Em seguida, serão encaminhados automaticamente para a organização correta. Um usuário pode fazer parte de várias organizações.

1. Adicionar usuários existentes a um grupo de usuários:

2. Vá para User management (Gerenciamento de usuários).

3. Selecione o grupo de usuários ao qual o usuário deve ser adicionado.

4. Clique em Add (Adicionar) próximo a Members (Membros).

5. Localize o usuário na lista e clique em ADD (Adicionar).

O estado do seu sistema pode ser monitorado no painel, onde você pode, entre outras coisas, obter informações sobre o estado de conexão do seu site de áudio e o estado de conexão de todos os dispositivos em sua organização. A maioria dessas informações também está disponível no modo de exibição Audio sites (Sites de áudio).

1. Vá para Dashboard (Painel) .

2. Verifique o estado dos seus sites de áudio e programações.

3. Investigue seus sites de áudio:

4. 1. Vá para Audio sites (Sites de áudio).

   2. Clique no ícone do filtro acima da lista de sites de áudio e selecione os problemas que deseja investigar.

      Para obter informações sobre cada tipo de problema, consulte Solução de problemas.

   3. Para investigar um site de áudio, clique em > Open AXIS Audio Manager Edge (Abrir o AXIS Audio Manager Edge).

5. Investigue suas programações:

6. 1. Acesse Scheduling (Agendamentos).

   2. Clique no ícone do filtro acima da lista de agendamentos e selecione os problemas que deseja investigar.

      Para obter informações sobre cada tipo de problema, consulte Solução de problemas.

   3. Para investigar um agendamento, clique na linha na lista.

O AXIS Audio Manager Center pode enviar notificação por email e webhook sobre diferentes tipos de eventos que ocorrem no site de áudio.

Somente administradores podem configurar notificações.

É necessário ser um administrador no nível da organização para configurar notificações por email.

1. Vá para Notifications (Notificações).

2. Clique em + Create (+ Criar).

3. Dê um nome à sua notificação.

4. Selecione Email.

5. Clique em Next (Próximo).

6. Insira o email do destinatário.

7. Selecione um acionador de notificação.

8. Clique em Create (Criar).

9. O destinatário receberá um email com um pedido de confirmação. Após clicar em Confirm (Confirmar) no email, o destinatário começará a receber notificações.

10. Atualize seu navegador para verificar se o status da notificação foi alterado de Pending (Pendente)) para OK, o que indica que o destinatário confirmou a notificação.

1. Vá para Notifications (Notificações).

2. Clique em + Create (+ Criar).

3. Dê um nome à sua notificação.

4. Selecione Webhook.

5. Clique em Next (Próximo).

6. Insira os detalhes do destinatário.

7. Selecione os acionadores de notificação.

8. Para selecionar locais, clique em + Select (+ Selecionar).

9. Clique em Create (Criar).

O AXIS Audio Manager Center oferece acesso remoto seguro aos sites de áudio adicionados. Isso permite configurar sites de áudio do sistema AXIS Audio Manager Edge remotamente. Quando você acessa um site de áudio, os direitos da sua função de usuário ou grupo de usuários definirão o que você poderá fazer remotamente. Os administradores têm acesso total a todas as configurações no site de áudio, enquanto que os gerentes de conteúdo e os operadores de reprodução possuem acesso limitado.

1. Para abrir o AXIS Audio Manager Edge:

2. Vá para Audio sites (Sites de áudio) e encontre o seu site de áudio.

3. Clique em > Open AXIS Audio Manager Edge (Abrir o AXIS Audio Manager Edge).

Após configurar o AXIS Audio Manager Center e atribuir usuários, bem como permissões aos seus usuários, os usuários também terão acesso ao sistema de áudio por meio do aplicativo para dispositivos móveis AXIS Audio Manager para iOS e Android.

Ao selecionar Connect remotely (Conectar remotamente) no app para dispositivos móveis, seus usuários poderão fazer login no AXIS Audio Manager Center e selecionar um site de áudio para controlar.

O registro de eventos contém eventos que ocorreram na parte da organização em que você é administrador.

1. Vá para Event log (Registro de eventos).

2. Clique em Data selection (Seleção de dados).

3. Selecione um período de tempo.

4. • Relative (Relativo): Selecione até que ponto no passado, a partir do presente, você deseja recuperar os dados.

   • Absolute (Absoluto): Selecione um intervalo de tempo do qual deseja recuperar os dados.

5. Para adicionar um filtro, clique em + Filter (+ Filtro) e selecione as condições.

6. Em Order (Ordem), selecione como apresentar os dados recuperados.

7. Para exportar os dados recuperados para um arquivo CSV, clique em Export (Exportar).

O AXIS Audio Manager Center oferece recursos que estão disponíveis somente para organizações licenciadas. Esses normalmente são recursos avançados, que executam operações em vários locais de uma só vez, como distribuição de conteúdo ou programação de músicas em lote.

O AXIS Audio Manager Center oferece suporte à distribuição de arquivos de conteúdo em seus sites de áudio para programação local. Para cada site de áudio, o conteúdo será armazenado no dispositivo líder e adicionado à biblioteca do tipo de conteúdo correspondente. Os arquivos não serão adicionados automaticamente a qualquer agendamento.

Formatos de arquivo compatíveis: mp3, mpeg, ogg, opus, wave

Tamanho máximo de arquivo permitido: 20 MB

1. Vá para Distribute audio files (Distribuir arquivos de áudio) e selecione um tipo de conteúdo (Advertiement, Announcement ou Music - Comunicado, Anúncio ou Música).

2. Clique em + Add (Adicionar) próximo a Files (Arquivos).

3. Selecione os arquivos para distribuir e clique em Open (Abrir).

4. Clique em + Add (+ Adicionar) ao lado de Audio sites (Sites de áudio).

5. Selecione os locais na estrutura de sites de áudio.

   O conteúdo será distribuído para todos os sites no local, incluindo sites de áudio em sublocais.

6. Clique em Distribute audio files (Distribuir arquivos de áudio).

Com o AXIS Audio Manager Center, você pode programar comunicados, anúncios e música para vários sites de áudio de uma só vez. Ao criar uma programação, você a direciona para os sites de áudio selecionando um local. Todos os sites de áudio nesse local e em todos os seus sublocais estão incluídos. Você também pode selecionar um rótulo para filtrar ainda mais a seleção.

Quando você ativa uma programação, ela é automaticamente aplicada aos sites de áudio incluídos na programação, desde que o site esteja conectado. Se um site de áudio não estiver conectado, a programação será aplicada assim que o site for conectado.

Se a programação estiver ativada, ela incluirá automaticamente novos sites de áudio que forem adicionados aos locais selecionados ou seus sublocais, ou se mais sites de áudio tiverem o rótulo selecionado aplicado a eles.

O AXIS Audio Manager Center também distribui o conteúdo de mídia necessário para executar uma programação em todos os sites de áudio de destino. A exceção são os agendamentos de música que foram criados com uma biblioteca local ou uma tag de fonte.

Quando você agenda com relação ao horário de funcionamento, há um risco de que o evento seja configurado para ser executado fora do dia (0 – 24). Este áudio não poderá ser tocado. Por exemplo, se você programar um comunicado para tocar 5 horas após a hora de fechamento e a hora de fechamento for 21h, o evento será agendado para às 2h da madrugada no dia seguinte e, portanto, não será executado.

Saiba mais:

• Rótulos

• Tags de origens

• Locais

1. Crie um agendamento:

2. 1. Acesse SCHEDULING > Scheduling (AGENDAMENTO > Agendamento).

   2. Clique em + CREATE SCHEDULE (+ CRIAR CRONOGRAMA).

   3. Nomeie o agendamento.

   4. Em Type of schedule (Tipo de agendamento), selecione Announcement (Comunicado).

   5. Selecione um local.

      Para obter mais informações, consulte Locais.

   6. Clique em CREATE (CRIAR).

3. Para ver uma lista dos seus sites de áudio, acesse AUDIO SITES (SITES DE ÁUDIO).

4. Para carregar arquivos de áudio e criar listas de reprodução, acesse CONTENT (CONTEÚDO).

5. Configure o agendamento:

6. 1. Vá para SCHEDULE (Agendamento).

   2. Clique em + EVENT (+ EVENTO) e selecione Single event (Evento único) ou Interval event (Intervalo de eventos).

   3. Preencha os detalhes e clique em SAVE (SALVAR).

   4. Para ativar o agendamento, selecione Enabled (Ativado) em Schedule status (Status do agendamento).

7. Visualizar a programação:

8. 1. Em Preview schedule (Visualizar programação), selecione o horário de funcionamento ou um site de áudio.

      O evento ficará cinza se não for exibido durante o horário de abertura selecionado.

9. Para salvar as alterações feitas no agendamento, clique em SAVE (SALVAR).

O agendamento de anúncios pode ser usado para qualquer conteúdo deveria ser reproduzido repetidamente por um determinado período

1. Crie um agendamento:

2. 1. Acesse SCHEDULING > Scheduling (AGENDAMENTO > Agendamento).

   2. Clique em + CREATE SCHEDULE (+ CRIAR CRONOGRAMA).

   3. Nomeie o agendamento.

   4. Em Type of schedule (Tipo de agendamento), selecione Advertisement (Anúncio).

   5. Selecione um local.

      Para obter mais informações, consulte Locais.

   6. Clique em CREATE (CRIAR).

3. Para ver uma lista dos seus sites de áudio, acesse AUDIO SITES (SITES DE ÁUDIO).

4. Para carregar arquivos de áudio e criar listas de reprodução, acesse CONTENT (CONTEÚDO).

5. Configure o agendamento:

6. 1. Vá para SCHEDULE (Agendamento).

   2. Clique em + EVENT (+ EVENTO) e selecione Single event (Evento único) ou Interval event (Intervalo de eventos).

   3. Preencha os detalhes e clique em SAVE (SALVAR).

   4. Para ativar o agendamento, selecione Enabled (Ativado) em Schedule status (Status do agendamento).

7. Visualizar a programação:

8. 1. Em Preview schedule (Visualizar programação), selecione o horário de funcionamento ou um site de áudio.

      O evento ficará cinza se não for exibido durante o horário de abertura selecionado.

9. Para salvar as alterações feitas no agendamento, clique em SAVE (SALVAR).

Você pode criar programações de música ambiente que começam e terminam com um deslocamento em relação ao horário de funcionamento de um site de áudio.

Para obter mais informações, consulte Deslocamento de abertura e fechamento.

• Origens de música válidas:

• A biblioteca local de cada site de áudio.

• Um stream da Web distribuído pelo AXIS Audio Manager Center.

  Para obter mais informações, consulte Fonte do Audio Manager Center.

• Uma tag de fonte voltada para fontes de site de áudio locais, como entrada de áudio e aplicativos integrados.

  Para obter mais informações, consulte Tags de origens.

• Pré-requisitos:

• A programação de música é aplicada em relação ao horário de funcionamento no site de áudio local.

  Para definir o horário de funcionamento de um site de áudio local, consulte Definir o horário de funcionamento no Manual do Usuário do AXIS Audio Manager Edge.

1. Para usar uma fonte de stream da Web:

2. 1. Acesse SCHEDULING > Sources (AGENDAMENTO > Fontes) e clique em + CREATE SOURCE (+ CRIAR FONTE).

   2. Nomeie a origem.

   3. No momento, o tipo está limitado a Stream da Web, o qual é pré-selecionado.

   4. Insira o URL do stream da Web.

   5. Se a URL exigir autenticação, ative Use authentication (Usar autenticação) e insira o nome de usuário e a senha.

   6. Clique em CREATE (CRIAR).

3. Crie um agendamento:

4. 1. Acesse SCHEDULING > Scheduling (AGENDAMENTO > Agendamento) e clique em + CREATE SCHEDULE (+ CRIAR AGENDAMENTO).

   2. Nomeie o agendamento.

   3. Em Type of schedule (Tipo de agendamento), selecione Music (Música).

   4. Selecione um local.

      Para obter mais informações, consulte Locais.

   5. Clique em CREATE (CRIAR).

5. Para ver todos os sites de áudio de destino, acesse AUDIO SITES (SITES DE ÁUDIO).

6. Configure o agendamento:

7. 1. Vá para SCHEDULE (Agendamento).

   2. Selecione Exigir seleção manual da fonte localmente antes do início da reprodução se não quiser que a música programada comece a ser reproduzida automaticamente, mas, em vez disso, esperar que alguém inicie a música localmente a partir do painel no AXIS Audio Manager Edge, com o aplicativo móvel AXIS Remote ou usando um controlador de volume AXIS C8310.

   3. Em Schedule time (Hora do agendamento), defina o tempo de compensação relativo aos horários de abertura e fechamento.

      Para obter mais informações, consulte Deslocamento de abertura e fechamento.

   4. Adicione fontes de música.

   5. 1. Clique em ADD MUSIC SOURCE (ADICIONAR FONTE DE MÚSICA)

      2. Selecione um tipo de fonte:

      3. • Fonte do Audio Manager Center

           Para obter mais informações, consulte Fonte do Audio Manager Center.

         • Tag de fonte

           Para obter mais informações, consulte Tags de origens.

         • Biblioteca local

      4. Clique em ADD (Adicionar).

   6. Observação

      Você pode adicionar várias fontes a um agendamento musical. Os usuários podem alternar as fontes localmente a partir do painel no AXIS Audio Manager Edge se estiverem usando um dispositivo host com AXIS OS 11.6 ou posterior. Para versões de AXIS OS anteriores, somente a primeira fonte na lista será reproduzida.

   7. Salve o agendamento:

   8. • Se desejar salvar seu agendamento sem ativá-lo, desmarque a caixa de seleção Enabled (Ativado) e clique em SAVE (Salvar).

        O agendamento agora é salvo e está disponível em sua lista de agendamentos de música, mas ainda não está ativado.

      • Se desejar salvar seu agendamento e ativá-lo, marque a caixa de seleção Enabled (Ativado) e clique em SAVE AND PUBLISH (Salvar e publicar).

        A programação agora está disponível em sua lista Music schedules (Programações de música) e está ativada, o que significa que ela será distribuída para todos os sites de áudio de destino.

      • Observação

        Observe que isso substitui qualquer programação de música local.

Com o AXIS Audio Manager Mobile app, você pode reproduzir mensagens por megafonia de um smartphone para um ou mais dispositivos em um site de áudio, de forma remota.

Para usar o aplicativo para dispositivos móveis para megafonia remota, primeiro é necessário criar um destinatário de megafonia e um grupo de usuários com direitos de operador de megafonia no AXIS Audio Manager Center.

• Dois tipos de megafonia SIPS podem ser configurados no AXIS Audio Manager Center:

• One-way paging (Megafonia unidirecional): para enviar, mas não receber, mensagens de áudio para um ou mais dispositivos em um site de áudio. Os destinatários da megafonia unidirecional aparecerão na guia Callout (Convocação) no aplicativo para dispositivos móveis. É possível enviar tanto mensagens de áudio ao vivo quanto pré-gravadas.

• Two-way paging (Megafonia bidirecional): para comunicação bidirecional ao vivo por meio de um único dispositivo em um site de áudio. Os destinatários da megafonia bidirecional aparecerão na guia Call (Chamada) no aplicativo para dispositivos móveis.

1. Crie um destinatário de megafonia:

2. 1. Em Location (Local), selecione o site de áudio no qual você deseja criar o destinatário da megafonia.

   2. Clique em + Create (+ Criar).

   3. Dê um nome ao seu destinatário.

   4. Em Type (Tipo), selecione One-way (Unidirecional) ou Two-way (Bidirecional).

   5. Observação

      Recomendamos criar os destinatários bidirecionais primeiro, antes de criar os destinatários unidirecionais.

   6. Clique em Create (Criar).

   7. Para megafonia unidirecional, adicione as zonas físicas e os dispositivos que deseja direcionar.

      Para megafonia bidirecional, selecione o dispositivo pelo qual deseja se comunicar.

   8. Clique em Create (Criar).

   9. Aguarde até que seja exibido OK em Status.

      Se, em vez disso, você receber Error (Erro), clique em > Verify configuration (Verificar configuração) para investigar.

   10. Clique em > Ports (Portas) para ter certeza de que está usando as portas SIPS corretas.

   11. Clique em > Volume para ter certeza de que o nível de volume está normalizado.

3. Conceda direitos de megafonia aos usuários:

4. 1. Vá para User management (Gerenciamento de usuários).

   2. Clique em + Create user group (+ Criar grupo de usuários).

   3. Nome do grupo de usuários.

   4. Em User role (Função do usuário), selecione Paging operator (Operador de megafonia).

   5. Clique em Create (Criar).

   6. Adicione locais e membros.

   7. Clique em Fechar.

Um local é um nó na estrutura de sites de áudio. Para obter mais informações, consulte Criar uma estrutura para seus sites de áudio.

Ao agendar conteúdo no AXIS Audio Manager Center, selecione primeiro um local em que o agendamento deve ser distribuído. Todos os sites de áudio no local e em seus sublocais estarão disponíveis para a programação.

Os rótulos são usados para adicionar um identificador a um site de áudio, que podem ser filtrados ou pesquisados no AXIS Audio Manager Center.

• Você pode filtrar e pesquisar por um rótulo no modo de exibição Audio sites (Sites de áudio) para facilitar a localização de sites.

• Você pode incluir um rótulo em uma programação do AXIS Audio Manager Center para filtrar ainda mais a seleção e incluir somente os sites que possuem esse rótulo como um atributo.

As programações são criadas em relação ao horário de funcionamento de cada site de áudio. Isso resolve o problema quando sites de áudio que são o destino de uma configuração de programação em lote possuem horários de funcionamento diferentes. O deslocamento de abertura determina quando a música começa a tocar e o deslocamento de fechamento define quando a música para de tocar.

A Audio Manager Center Source (Origem do Audio Manager Center) é uma origem criada sob SCHEDULING (Agendamento) > Music (Música) > Sources (Origens). Ela é distribuída automaticamente para todos os sites de áudio na organização. A fonte é gerenciada centralmente pelo AXIS Audio Manager Center. No momento, somente as origens de stream da Web são aceitas.

Se você pretende usar fontes locais para os sites de áudio do AXIS Audio Manager Edge em suas programações do AXIS Audio Manager Center, será necessário atribuir uma tag de fonte a essas fontes em cada um dos sites de áudio do AXIS Audio Manager Edge. As tags de fonte são criadas no AXIS Audio Manager Center e distribuídas para todos os sites de áudio conectados na organização. Para configurar uma fonte em um site de áudio local com uma tag de fonte, vá para  AXIS Audio Manager Edge > SCHEDULING > Music > SOURCES (AXIS Audio Manager Edge > PROGRAMAÇÕES > Música > FONTES), selecione a fonte correta e atribua uma tag de fonte. Essa origem pode então ser usada em um agendamento distribuído pelo AXIS Audio Manager Center.

• Exemplos de origens que devem ser definidas localmente:

• Entrada de linha

• Lista de reprodução

• ACAP

• URLs de transmissão da Web exclusivos (isto é, onde o URL é exclusivo a cada site de áudio)

Exemplo: Uma organização comprou um serviço de transmissão de música online que usa um ACAP instalado para fornecer o serviço. Ela cria uma tag de fonte “ACAP streaming“ (Transmissão do ACAP) no AXIS Audio Manager Center. Cada site de áudio com a fonte de música ACAP deverá, então, atribuí-la à tag de fonte “ACAP streaming“ (Transmissão do ACAP) para permitir que essa fonte seja programada no AXIS Audio Manager Center. Ao criar a programação, ela garante que os sites de áudio corretos sejam alcançados usando o local e o rótulo, em seguida, define o deslocamento de abertura/fechamento desejado e, finalmente, seleciona a fonte da música “Source tag“ (Tag de fonte) com a tag “ACAP streaming“ (Transmissão do ACAP). Os sites de áudio de destino agora têm uma programação tocando música via serviço de transmissão de música.

Você pode receber eventos do sistema por meio do webhook do AXIS Audio Manager Center. Os eventos são entregues como solicitações HTTP POST.

Um handshake de validação deve ser concluído antes que os eventos possam ser enviados a um consumidor. Quando um webhook está configurado, o remetente emite uma solicitação prévia para validar o endpoint de destino. Se o consumidor não responder adequadamente a essa solicitação, a assinatura não será estabelecida.

Para aceitar todos os emissores de eventos de webhook, responda à solicitação OPTIONS (OPÇÕES) com um status 200 OK e inclua o cabeçalho: Webhook-Allowed-Origin: '*'

Para aceitar apenas nós como emissor, responda com um 200 OK e inclua a origem exata do cabeçalho Webhook-Request-Origin.

Para estar em conformidade com a especificação CloudEvents, os receptores de webhooks devem responder com um status HTTP bem-sucedido, como 200 OK, 201 Created, 202 Accepted ou 204 No Content (200 OK, 201 Criado, 202 Aceito, 204 Sem conteúdo). Respostas de redirecionamento (3xx) não são permitidas e não serão seguidas.

Se o receptor estiver temporariamente sobrecarregado, ele deverá retornar 429 Too Many Requests (429 Muitas solicitações). Se o endpoint tiver sido permanentemente retirado, ele deverá retornar 410 Gone (410 Eliminado), o que desativa a assinatura e interrompe a entrega de eventos.

Todos os eventos de webhook seguem esta estrutura:

{
  "specversion": "1.0",
  "id": "<event-id>",
  "source": "com.axis.audiomanager",
  "type": "<event-type>",
  "time": "<timestamp>",
  "eventversion": "1",
  "eventcorrelationid": "<correlation-id>",
  "datacontenttype": "application/json",
  "dataschema": "com/axis/one/notification-service/webhook/@v/1.0.0",
  "data": {
    "data": { <event-specific data> },
    "datacontenttype": "application/json",
    "dataschema": "<event-specific schema>"
  }
}

1. Existem três tipos de tipos de eventos de webhook:

2. Audio site events (Eventos do site de áudio) — Alterações no estado do site de áudio.

3. • Tipo: com.axis.audiomanager.status.site

   • Esquema: com/axis/audiomanager/status/site/@v/1.0.0

   • Campos em data.data:

   • • siteName – O nome do site de áudio.

     • siteId – ID do site de áudio.

     • siteLocationNames – O caminho do local do site de áudio.

     • statusSeverity – Estado do site de áudio de alto nível.

     • statusType – Subcategoria de estado do site de áudio.

     • organizationName – O nome da organização.

     • organizationId – ID da organização.

     • aamcUrl – Link para o registro de eventos no AXIS Audio Manager Center.

4. Scheduled events (Eventos programados) — Alterações de status das programações na organização.

5. • Tipo: com.axis.audiomanager.status.schedule

   • Esquema: com/axis/audiomanager/status/schedule/@v/1.0.0

   • Campos em data.data:

   • • scheduleName – O nome da programação.

     • scheduleId – O ID da programação.

     • statusSeverity – Status da programação de alto nível.

     • statusType – Subcategoria de status da programação.

     • siteName – O nome do site que acionou o evento.

     • siteId – ID do site de áudio.

     • siteLocationNames – O caminho do local do site de áudio.

     • organizationName – O nome da organização.

     • organizationId – ID da organização.

     • aamcUrl – Link para o registro de eventos no AXIS Audio Manager Center.

6. Paging recipient events (Eventos de destinatários de megafonia) — Atualizações de estado de destinatários individuais de megafonia nos sites de áudio.

7. • Tipo: com.axis.audiomanager.status.paging

   • Esquema: com/axis/audiomanager/status/paging/@v/1.0.0

   • Campos em data.data:

   • • pagingRecipientName – Nome do destinatário da megafonia.

     • pagingRecipientId – ID do destinatário da megafonia.

     • statusSeverity – Status de destinatário de megafonia de alto nível.

     • statusType – Subcategoria de destinatário de megafonia

     • siteName – Nome do site onde o destinatário de megafonia está localizado.

     • siteId – ID do site onde o destinatário de megafonia está localizado.

     • siteLocationNames – Caminho do local do site de áudio.

     • organizationName – Nome da organização.

     • organizationId – ID da organização.

     • aamcUrl – Link para o registro de eventos no AXIS Audio Manager Center.

Ao configurar um webhook, você pode inserir um segredo de webhook junto com a URL de destino. Esse segredo é usado para verificar se as solicitações de webhook recebidas são genuínas e não foram adulteradas.

1. Como funciona:

2. O remetente cria uma assinatura HMAC-SHA256 da carga útil do evento usando sua chave de assinatura secreta configurada.

3. A assinatura está incluída no cabeçalho webhook-signature-sha256 da solicitação.

4. No servidor, recalcule o HMAC usando a carga útil recebida e sua chave de assinatura secreta.

5. Compare com a assinatura fornecida.

6. Se corresponderem, a solicitação é verificada.

Requisitos para a chave secreta de assinatura do webhook:

• A chave de assinatura secreta deve ser inserida ao configurar a URL do webhook no AXIS Audio Manager Center.

• A chave de assinatura secreta deve ser uma sequência hexadecimal com até 1.024 caracteres.

• A chave de assinatura secreta deve ter um número par de caracteres.

• O mesmo segredo deve ser usado em seu servidor para verificar as solicitações recebidas.

• Uma expressão regular para uma chave de assinatura secreta válida: ^([0-9a-fA-F]{2}){0,512}$

Este exemplo demonstra os princípios básicos da implementação do receptor de webhook e tem finalidade exclusivamente educativa. As implementações de produção devem incluir reforço de segurança, validação e tratamento de erros adequados.

1. Crie uma nova função do AWS Lambda:

2. 1. Runtime (Tempo de execução): Node.js 22 ou superior

   2. Architecture (Arquitetura): X86_64

   3. Function URL (URL da função): ativado (tipo de autenticação NONE [NENHUM])

3. Insira e implemente o código.

4. Configure um novo webhook no AXIS Audio Manager Center:

5. 1. Com a URL da sua função lambda pública.

   2. Com sua chave de assinatura secreta (do código de exemplo: 4d79207365637265742070617373706872617365).

   3. Selecione qual acionador usar (por exemplo, eventos do site de áudio) e um local (por exemplo, nível da organização).

6. Acione um evento de teste (por exemplo, reiniciar um líder do site de áudio para gerar um evento de desconexão).

7. Verifique seus registros de lambda.

import { createHmac, timingSafeEqual } from "crypto";

const passphrase = "My secret passphrase";
// Resulting secret signing key (hex): 4d79207365637265742070617373706872617365
const secretSigningKey = Buffer.from(passphrase, "utf-8").toString("hex");

const verifySignature = (event) => {
  try {
    const signature = event.headers["webhook-signature-sha256"];
    const signatureBuffer = Buffer.from(signature, "hex");
    const signingKeyBuffer = Buffer.from(secretSigningKey, "hex");
    const bodyBuffer = Buffer.from(event.body, "utf-8");
    const hmacDigest = createHmac("sha256", signingKeyBuffer).update(bodyBuffer).digest();

    return timingSafeEqual(hmacDigest, signatureBuffer);
  } catch (error) {
    console.error("Failed to verify signature:", error);
    return false;
  }
};

const innerHandler = (event) => {
  // Handle the preflight request (required to verify receiver existence during setup)
  if (event.requestContext.http.method === "OPTIONS") {
    return {
      statusCode: 200,
      headers: { "Webhook-Allowed-Origin": event.headers["webhook-request-origin"] }
    };
  }

  if (!verifySignature(event)) {
    return { statusCode: 401, body: "Invalid signature" };
  }

  // Do business logic, e.g., store the event, send it to another service, etc.

  return { statusCode: 200, body: "Success" };
};

export const handler = async (event) => {
  console.log("Event:", event);
  const response = innerHandler(event);
  console.log("Response:", response);

  return response;
};

Se precisar de ajuda adicional, acesse axis.com/support.