Visão geral de salas
Os Serviços de Comunicação do Azure fornecem um conceito de uma 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 em que as salas 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 e, ao mesmo tempo, ser adequadamente genéricas para uma ampla variedade de aplicativos do setor. Os serviços podem agendar e gerenciar salas para pacientes que buscam conselhos médicos, planejadores financeiros trabalhando com clientes e advogados que fornecem serviços jurídicos.
- As salas permitem uma experiência somente para convidados. As salas permitem que seus serviços controlem quais usuários podem ingressar na sala para uma consulta virtual com médicos ou consultores financeiros. Isso permitirá que apenas um subconjunto de utilizadores com identidades atribuídas aos Serviços de Comunicação participe numa 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 nível de controle e estrutura na comunicação. Verifique se somente os apresentadores podem falar e compartilhar conteúdo em uma reunião grande ou em uma conferência virtual.
- Adicione participantes PSTN. Convide participantes da PSTN (rede telefônica pública comutada) para uma chamada utilizando um número adquirido através da sua subscrição ou através do encaminhamento direto do Azure para o seu SBC (Session Border Controller).
Quando usar salas
Use salas quando precisar de uma das seguintes funcionalidades:
- Controlar quais usuários podem ingressar em chamadas de sala.
- Precisar de agendamento/coordenadas habilitadas e que expiram em uma data e hora específicas.
- Precisar de comunicação estruturada por meio de funções e permissões para os usuários.
| Funcionalidade | 1: N chamada | 1: N chamada com ID efêmera |
Chamada de sala |
|---|---|---|---|
| Participantes interativos | 350 | 350 | 350 |
| ID efêmera a ser distribuída aos participantes | ❌ | ✔️ (ID do grupo) |
✔️ (ID da sala) |
| Convide somente a participação | ❌ | ❌ | ✔️ |
| Capacidade de discar para o usuário PSTN | ✔️ | ✔️ | ✔️ |
| Legendas de chamadas | ✔️ versão prévia privada |
✔️ versão prévia privada |
✔️ versão prévia privada |
| Gravação de telefonemas | ✔️ | ✔️ | ✔️ versão prévia pública |
| Todos os usuários no recurso do serviço de comunicação podem ingressar em uma chamada | ❌ | ✔️ | ✔️ |
| Definir o período de validade de uma chamada | ❌ | ❌ | ✔️ Até seis meses |
| Definir funções de usuário e permissões para uma chamada | ❌ | ❌ | ✔️ |
| API para criar, remover, atualizar, excluir a chamada | ❌ | ❌ | ✔️ API de salas |
Gerenciar salas e ingressar em chamadas de sala
A API/SDK de salas é usada para realizar ações como criar uma sala, adicionar participantes e configurar agendamento etc. Chamar o SDK é usado para iniciar a chamada dentro de uma sala do lado do cliente. A maioria das ações disponíveis em chamadas de um para um ou de grupo nos SDKs de chamada também estão disponíveis em salas. 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 |
|---|---|---|
| Junte-se a uma chamada de sala com voz e vídeo | ✔️ | ❌ |
| Listar os participantes que ingressaram na chamada de salas | ✔️ | ❌ |
| Permitir/proibir discagem para um usuário PSTN no nível de salas virtuais | ❌ | ✔️ |
| Criar sala | ❌ | ✔️ |
| Listar todos os participantes que são convidados para sala | ❌ | ✔️ |
| Iniciar, pausar, parar a gravação de chamadas | ✔️ | ❌ |
| Adicionar ou remover um participante de VoIP | ❌ | ✔️ |
| Atribuir funções aos participantes da sala | ❌ | ✔️ |
A figura abaixo ilustra o conceito de gerenciamento e junção das salas.
API/SDKs de Virtual Rooms
As salas são criadas e gerenciadas por meio de APIs SDKs de salas. Use a API/SDK de salas em seu aplicativo para servidores para operações room:
- Criar
- Modificar
- Excluir
- Definir e atualizar a lista de participantes
- Definir e modificar a validade da sala
- Atribuir funções e permissões a usuários. Veja os detalhes abaixo.
| SDK de Virtual Rooms | Versão | Estado |
|---|---|---|
| SDKs de Virtual Rooms | 2024-04-15 | Disponibilidade Geral - Totalmente compatível |
| SDKs de Virtual Rooms | 2023-10-30 | Visualização Pública - Totalmente compatível |
| SDKs de Virtual Rooms | 2023-06-14 | Disponibilidade Geral - Totalmente compatível |
| SDKs de Virtual Rooms | 2023-03-31 | Será desativado em 30 de abril de 2024 |
| SDKs de Virtual Rooms | 2022-02-01 | Será desativado em 30 de abril de 2024 |
| SDKs de Virtual Rooms | 2021-04-07 | Será desativado em 30 de abril de 2024 |
SDKs de chamada
Use os SDKs de chamada para ingressar na chamada de sala. As chamadas de sala podem ser ingressadas usando os SDKs de chamadas para Web, iOS ou Android. Você pode encontrar exemplos de início rápido para ingressar em chamadas de sala aqui.
As salas também podem ser acessadas usando a biblioteca de interface do usuário do Serviços de Comunicação do Azure. A Biblioteca de 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.
Permissões e funçõ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 receberá uma função 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 Apresentador tem controle total, as funcionalidades Participante são limitadas a áudio e vídeo, e Consumidor só pode receber áudio, vídeo e compartilhamento de tela.
| Funcionalidade | Função: Apresentador | Função: Participante | Função: Consumidor |
|---|---|---|---|
| Controle de chamada intermediária | |||
| – Ativar/desativar vídeo | ✔️ | ✔️ | ❌ |
| – Ativar/desativar mudo do microfone | ✔️ | ✔️ | ❌ |
| - Ativar mudo do usuário remoto | ✔️ | ❌ | ❌ |
| – Alternar entre câmeras | ✔️ | ✔️ | ❌ |
| – Alto-falante ativo | ✔️ | ✔️ | ✔️ |
| – Escolher alto-falante para chamadas | ✔️ | ✔️ | ✔️ |
| – Escolher microfone para chamadas | ✔️ | ✔️ | ❌ |
| – Mostrar o estado dos participantes (Ocioso, Conectando, Conectado, Em espera, Desconectando, Desconectado etc.) | ✔️ | ✔️ | ✔️ |
| – Mostrar estado da chamada (Mídia inicial, Realizando, Conectando, Tocando, Conectada, Em espera, Desconectando, Desconectada | ✔️ | ✔️ | ✔️ |
| – Mostrar se um participante está com o mudo ativado | ✔️ | ✔️ | ✔️ |
| – Mostrar o motivo pelo qual um participante saiu de uma chamada | ✔️ | ✔️ | ✔️ |
| Compartilhamento de tela | |||
| – Compartilhar tela | ✔️ * | ❌ | ❌ |
| – Compartilhar um aplicativo | ✔️ * | ❌ | ❌ |
| – Compartilhar uma guia do navegador | ✔️ * | ❌ | ❌ |
| – Os participantes podem exibir a tela compartilhada | ✔️ | ✔️ | ✔️ |
| Gerenciamento de lista | |||
| – Remover um participante | ✔️ | ❌ | ❌ |
| Gerenciamento de dispositivos | |||
| – Solicitar 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 alto-falantes | ✔️ * | ✔️ * | ✔️ * |
| – Definir o alto-falante | ✔️ * | ✔️ * | ✔️ * |
| – Obter alto-falante selecionado | ✔️ | ✔️ | ✔️ |
| Renderização de vídeo | |||
| – Renderizar um vídeo em vários locais (câmera local ou fluxo remoto) | ✔️ | ✔️ | ✔️ (Somente remoto) |
| – Definir/atualizar modo de escala de vídeo | ✔️ | ✔️ | ✔️ (Somente remoto) |
| – Renderizar fluxo de vídeo remoto | ✔️ | ✔️ | ✔️ |
| Adicionar participantes PSTN | |||
| - Chamar participantes usando chamadas telefônicas | ✔️ | ❌ | ❌ |
* Disponível apenas na web chamando SDK. Não disponível em SDKs de chamada para iOS e Android
Manipulação de eventos
Os eventos de chamada de voz e vídeo publicados por meio da Grade de Eventos são anotados com informações de chamada da sala.
- CallStarted é publicado quando uma chamada de sala é iniciada.
- CallEnded é publicado quando uma chamada de sala é encerrada.
- CallParticipantAdded é publicado quando um novo participante ingressa em uma chamada de sala.
- CallParticipantRemoved é publicado quando um participante sai de uma chamada de sala.
Recursos preteridos
A versão de visualização pública anterior da API Rooms suportava duas configurações para controle de lista de salas, como segue:
- Uma sala "Somente para convidados" que permite apenas que usuários convidados participem da chamada de salas.
- Uma "Sala Aberta" que é menos segura. Na configuração de salas abertas, todos os utilizadores dos Serviços de Comunicação do Azure foram autorizados a participar numa chamada sem serem explicitamente convidados através da lista de salas.
O conceito de "Sala Aberta" está obsoleto. A partir de agora, as salas "Somente para convidados" serão o único tipo de sala compatível.
Limitações conhecidas
- As capacidades de automação de chamadas dos Serviços de Comunicação do Azure atualmente não suportam chamadas de Salas.
Próximas etapas:
- Use o Início rápido para criar, gerenciar e ingressar em uma sala.
- Saiba como ingressar em uma chamada de sala.
- Examine os Requisitos de rede para mídia e sinalização.
- Analise os dados das suas salas, veja Registros das salas.
- Saiba como usar o espaço de trabalho Log Analytics, veja: Tutorial Log Analytics.
- Crie suas próprias consultas no Log Analytics, veja: Consultas de introdução.