Visão geral dos quartos
Os Serviços de Comunicação do Azure fornecem um conceito de sala para desenvolvedores que estão criando conversas estruturadas, como compromissos virtuais ou eventos virtuais. Atualmente, as salas permitem chamadas de voz e vídeo.
Aqui estão os principais cenários onde os quartos são úteis:
- As salas permitem uma experiência de comunicação agendada. As salas ajudam as plataformas de serviço a oferecer experiências no estilo de reunião, sem deixar de ser adequadamente genéricas para uma ampla variedade de aplicações do setor. Os serviços podem agendar e gerenciar salas para pacientes que procuram aconselhamento médico, planejadores financeiros que trabalham com clientes e advogados que prestam serviços jurídicos.
- Os quartos permitem uma experiência apenas para convidados. As salas permitem que seus serviços controlem quais usuários podem entrar na sala para uma consulta virtual com médicos ou consultores financeiros. Isso permitirá que apenas um subconjunto de usuários com identidades atribuídas aos Serviços de Comunicação participe de uma chamada de sala.
- As salas permitem comunicações estruturadas por meio de funções e permissões. As salas permitem que os desenvolvedores atribuam funções predefinidas aos usuários para exercer um maior grau de controle e estrutura na comunicação. Certifique-se de que apenas os apresentadores possam falar e compartilhar conteúdo em uma grande reunião ou em uma conferência virtual.
- Adicione participantes PSTN. Convide participantes da rede telefônica pública comutada (PSTN) para uma chamada usando um número adquirido por meio de sua assinatura ou por meio do roteamento direto do Azure para seu Controlador de Borda de Sessão (SBC).
Quando usar os quartos
Use salas quando precisar de qualquer um dos seguintes recursos:
- Controle quais usuários podem participar de chamadas de sala.
- Precisa de agendamento/coordenadas que estão habilitadas e expiram em uma hora e data especificadas.
- Precisa de comunicação estruturada através de funções e permissões para os usuários.
| Funcionalidade | 1:N Chamada | 1:N Chamada com ID efémera |
Chamada de quarto |
|---|---|---|---|
| Participantes interativos | 350 | 350 | 350 |
| ID efémera para distribuir aos participantes | ❌ | ✔️ (ID do grupo) |
✔️ (ID do quarto) |
| Participação apenas para convidados | ❌ | ❌ | ✔️ |
| Capacidade de discar para o usuário PSTN | ✔️ | ✔️ | ✔️ |
| Legendas de chamada | ✔️ Pré-visualização privada |
✔️ Pré-visualização privada |
✔️ Pré-visualização privada |
| Gravação de chamadas | ✔️ | ✔️ | ✔️ Pré-visualização pública |
| Todos os usuários no recurso de serviço de comunicação para participar de uma chamada | ❌ | ✔️ | ✔️ |
| Definir período de validade para uma chamada | ❌ | ❌ | ✔️ Até seis meses |
| Definir funções e permissões de usuário para uma chamada | ❌ | ❌ | ✔️ |
| API para criar, remover, atualizar, excluir a chamada | ❌ | ❌ | ✔️ API de quartos |
Gerir salas e participar em chamadas de sala
A API/SDK de salas é usada para realizar ações como criar uma sala, adicionar participantes e configurar agendamento, etc. O SDK de chamada é usado para iniciar a chamada dentro de uma sala do lado do cliente. A maioria das ações disponíveis em chamadas individuais ou em grupo em SDKs de chamada também estão disponíveis em chamadas de sala. A lista completa de recursos oferecidos no SDK de chamada está listada na Visão geral do SDK de chamada.
| Funcionalidade | SDK de chamada | API/SDK de salas |
|---|---|---|
| Participar numa chamada de sala com voz e vídeo | ✔️ | ❌ |
| Listar participantes que se juntaram à chamada de salas | ✔️ | ❌ |
| Permitir/não permitir discagem para um usuário PSTN no nível de Salas virtuais | ❌ | ✔️ |
| Criar quarto | ❌ | ✔️ |
| Listar todos os participantes convidados para a sala | ❌ | ✔️ |
| Iniciar, pausar, parar a gravação de chamadas | ✔️ | ❌ |
| Adicionar ou remover um participante VoIP | ❌ | ✔️ |
| Atribuir funções aos participantes da sala | ❌ | ✔️ |
A imagem abaixo ilustra o conceito de gestão e junção das salas.
API/SDKs de Salas Virtuais
As salas são criadas e gerenciadas por meio de APIs ou SDKs de salas. Use as salas API/SDKs em seu aplicativo de servidor para room operações:
- Criar
- Modificar
- Delete
- Definir e atualizar a lista de participantes
- Definir e modificar a validade do quarto
- Atribua funções e permissões aos usuários. Detalhes abaixo.
| SDK de Salas Virtuais | Versão | Estado |
|---|---|---|
| SDKs de Salas Virtuais | 2024-04-15 | Geralmente disponível - Totalmente suportado |
| SDKs de Salas Virtuais | 2023-10-30 | Pré-visualização pública - Totalmente suportado |
| SDKs de Salas Virtuais | 2023-06-14 | Geralmente disponível - Totalmente suportado |
| SDKs de Salas Virtuais | 2023-03-31 | Será aposentado em 30 de abril de 2024 |
| SDKs de Salas Virtuais | 2022-02-01 | Será aposentado em 30 de abril de 2024 |
| SDKs de Salas Virtuais | 2021-04-07 | Será aposentado em 30 de abril de 2024 |
Chamando SDKs
Use os SDKs de chamada para ingressar na chamada de sala. As chamadas de sala podem ser associadas usando os SDKs de chamada da Web, iOS ou Android. Você pode encontrar exemplos de início rápido para participar de chamadas de sala aqui.
As salas também podem ser acessadas usando a Biblioteca de Interface do Usuário dos Serviços de Comunicação do Azure. A Biblioteca da Interface do Usuário permite que os desenvolvedores adicionem um cliente de chamada habilitado para salas em seu aplicativo com apenas algumas linhas de código.
Funções e permissões de participante predefinidas
Os participantes da sala podem receber uma das seguintes funções: Apresentador, Participante e Consumidor. Por padrão, um usuário recebe uma função de Participante, se nenhuma outra função for atribuída.
As tabelas abaixo fornecem recursos detalhados mapeados para as funções. Em um alto nível, a função de Apresentador tem controle total, os recursos do Participante são limitados a áudio e vídeo, enquanto o Consumidor só pode receber áudio, vídeo e compartilhamento de tela.
| Funcionalidade | Função: Apresentador | Função: Participante | Função: Consumidor |
|---|---|---|---|
| Controles de chamada intermediária | |||
| - Ligar / desligar o vídeo | ✔️ | ✔️ | ❌ |
| - Mute/Unmute microfone | ✔️ | ✔️ | ❌ |
| - Silenciar usuário remoto | ✔️ | ❌ | ❌ |
| - Alternar entre câmaras | ✔️ | ✔️ | ❌ |
| - Alto-falante ativo | ✔️ | ✔️ | ✔️ |
| - Escolha o alto-falante para chamadas | ✔️ | ✔️ | ✔️ |
| - Escolha o microfone para chamadas | ✔️ | ✔️ | ❌ |
| - Mostrar o estado dos participantes (ocioso, conectando, conectado, em espera, desconectando, desconectado etc.) | ✔️ | ✔️ | ✔️ |
| - Mostrar estado da chamada (mídia inicial, entrada, conexão, toque, conectado, espera, desconexão, desconectado | ✔️ | ✔️ | ✔️ |
| - Mostrar se um participante está mudo | ✔️ | ✔️ | ✔️ |
| - Mostrar o motivo pelo qual um participante deixou uma chamada | ✔️ | ✔️ | ✔️ |
| Partilha de ecrã | |||
| - Compartilhar tela | ✔️ * | ❌ | ❌ |
| - Partilhar uma aplicação | ✔️ * | ❌ | ❌ |
| - Partilhe um separador do navegador | ✔️ * | ❌ | ❌ |
| - Os participantes podem ver a tela compartilhada | ✔️ | ✔️ | ✔️ |
| Gestão de escala de trabalho | |||
| - Remover um participante | ✔️ | ❌ | ❌ |
| Gestão de Dispositivos | |||
| - Peça permissão para usar áudio e/ou vídeo | ✔️ | ✔️ | ❌ |
| - Obter lista de câmeras | ✔️ | ✔️ | ❌ |
| - Definir câmera | ✔️ | ✔️ | ❌ |
| - Obter câmera selecionada | ✔️ | ✔️ | ❌ |
| - Obter lista de microfones | ✔️ * | ✔️ * | ❌ |
| - Definir microfone | ✔️ * | ✔️ * | ❌ |
| - Obter microfone selecionado | ✔️ * | ✔️ * | ❌ |
| - Obter lista de oradores | ✔️ * | ✔️ * | ✔️ * |
| - Definir alto-falante | ✔️ * | ✔️ * | ✔️ * |
| - Obter orador selecionado | ✔️ | ✔️ | ✔️ |
| Renderização de vídeo | |||
| - Renderizar um vídeo em vários lugares (câmera local ou fluxo remoto) | ✔️ | ✔️ | ✔️ (Apenas remoto) |
| - Definir / atualizar o modo de dimensionamento de vídeo | ✔️ | ✔️ | ✔️ (Apenas remoto) |
| - Renderizar fluxo de vídeo remoto | ✔️ | ✔️ | ✔️ |
| Adicionar participantes PSTN | |||
| - Ligue para os participantes usando chamadas telefônicas | ✔️ | ❌ | ❌ |
* Disponível apenas no SDK de chamadas na web. Não disponível em SDKs de chamadas iOS e Android
Manipulação de eventos
Os eventos de chamadas de voz e vídeo publicados através da Grelha de Eventos são anotados com informações da chamada de sala.
- CallStarted é publicado quando uma chamada de sala é iniciada.
- CallEnded é publicado quando uma chamada de sala termina.
- CallParticipantAdded é publicado quando um novo participante entra em uma chamada de sala.
- CallParticipantRemoved é publicado quando um participante desiste de uma chamada de sala.
Funcionalidades Preteridas
A versão de visualização pública anterior da API de Salas suportava duas configurações para o controle de lista de Quartos, da seguinte maneira:
- Uma sala "Somente convite" que só permite que usuários convidados participem da chamada de salas.
- Uma "Sala Aberta" que é menos segura. Na configuração de salas abertas, todos os usuários dos Serviços de Comunicação do Azure tinham permissão para participar de uma chamada sem serem explicitamente convidados por meio da lista de salas.
O conceito de "Sala Aberta" foi agora preterido. No futuro, as salas "Apenas convidar" serão o único tipo de quarto suportado.
Limitações Conhecidas
- Atualmente, os recursos de Automação de Chamadas dos Serviços de Comunicação do Azure não oferecem suporte à chamada de Salas.
Passos seguintes:
- Use o Guia de início rápido para criar, gerenciar e ingressar em uma sala.
- Saiba como participar de uma chamada de sala.
- Analise os requisitos de rede para mídia e sinalização.
- Analise os dados das salas, consulte: Registros das salas.
- Saiba como usar o espaço de trabalho do Log Analytics, consulte: Tutorial do Log Analytics.
- Crie suas próprias consultas no Log Analytics, consulte: Consultas de introdução.