Recursos de chamada com suporte para usuários do Teams no SDK de Chamada

  • Artigo

O SDK de Chamada dos Serviços de Comunicação do Azure permite que os dispositivos de usuário do Teams impulsionem experiências de comunicação de voz e vídeo. Esta página fornece descrições detalhadas de recursos de Chamada, incluindo informações de suporte a plataformas e navegadores. Para começar imediatamente com JavaScript, confira Chamando inícios rápidos.

Principais recursos do SDK de chamada:

  • Endereçamento - os Serviços de Comunicação do Azure estão usando o identificador de usuário do Microsoft Entra para endereçar pontos de extremidade de comunicação. Os clientes usam identidades do Microsoft Entra para se autenticar no serviço e se comunicar uns com os outros. Essas identidades são usadas em APIs de Chamada, fornecendo aos clientes visibilidade de quem está conectado a uma chamada (a lista de participantes). Também são usados na API do Microsoft Graph.
  • Criptografia – o SDK de Chamada criptografa o tráfego e impede a adulteração da conexão.
  • Gerenciamento de Dispositivos e Mídia – o SDK de Chamada fornece recursos para associação a dispositivos de áudio e vídeo, codifica o conteúdo para transmissão eficiente no plano de dados de comunicação e renderiza o conteúdo para dispositivos de saída e exibições que você especificar. As APIs também são fornecidas para compartilhamento de tela e de aplicativo.
  • Notificações – O SDK de Chamada fornece APIs que permitem que os clientes sejam notificados de uma chamada de entrada. Em situações em que seu aplicativo não está em execução em primeiro plano, os padrões estão disponíveis para acionar notificações pop-up ("notificações do sistema") para informar os usuários de uma chamada de entrada.

Funcionalidades de chamada

A lista a seguir apresenta o conjunto de recursos atualmente disponíveis no SDK de Chamada dos Serviços de Comunicação do Azure ao participar de chamadas VoIP (voz sobre IP) 1:1 ou VoIP em grupo.

Grupo de recursos Funcionalidade JavaScript Windows Java (Android) Objective-C (iOS)
Principais funcionalidades Fazer uma chamada um para um para um usuário do Teams ✔️ ✔️ ✔️ ✔️
Fazer uma chamada um para um para usuário dos Serviços de Comunicação do Azure ❌ ❌ ❌ ❌
Fazer uma chamada de grupo com mais de dois usuários do Teams (até 350 usuários) ✔️ ✔️ ✔️ ✔️
Promover uma chamada de um-para-um com dois usuários to Teams em uma chamada de grupo com mais de dois usuários do Teams ✔️ ✔️ ✔️ ✔️
Ingressar em uma chamada de grupo depois que ela for iniciada ❌ ❌ ❌ ❌
Convidar outro participante de VoIP para ingressar em uma chamada de grupo em andamento ✔️ ✔️ ✔️ ✔️
Teste o microfone, o alto-falante e a câmera com um serviço de teste de áudio (disponível chamando 8:echo123) ✔️ ✔️ ✔️ ✔️
Fazer uma chamada cumpre a configuração de acesso externo do Teams ✔️ ✔️ ✔️ ✔️
Fazer uma chamada cumpre a configuração de acesso de convidado do Teams ✔️ ✔️ ✔️ ✔️
Controle de chamada média Ativar/desativar seu vídeo ✔️ ✔️ ✔️ ✔️
Ativar/desativar mudo do microfone ✔️ ✔️ ✔️ ✔️
Alternar entre câmeras ✔️ ✔️ ✔️ ✔️
Ativar/desativar colocação em espera local ✔️ ✔️ ✔️ ✔️
Indicador de alto-falantes dominantes na chamada ✔️ ✔️ ✔️ ✔️
Escolher dispositivo alto-falante para chamadas ✔️ ✔️ ❌2 ❌2
Escolher microfone para chamadas ✔️ ✔️ ❌2 ❌2
Indicador do estado do participante
Ocioso, Mídia inicial, Conectando, Conectado, Em espera, No lobby, Desconectado		 ✔️ ✔️ ✔️ ✔️
Indicador do estado da chamada
Mídia inicial, Realizando, Conectando, Tocando, Conectada, Em espera, Desconectando, Desconectada		 ✔️ ✔️ ✔️ ✔️
Indicar que os participantes estão sendo silenciados ✔️ ✔️ ✔️ ✔️
Indicar os motivos dos participantes para encerrar a chamada ✔️ ✔️ ✔️ ✔️
Compartilhamento de tela Compartilhar a tela inteira de dentro do aplicativo ✔️ ✔️1 ✔️1 ✔️1
Compartilhar um aplicativo específico (na lista de aplicativos em execução) ✔️ ✔️1 ❌ ❌
Compartilhar uma guia do navegador da Web na lista de guias abertas ✔️ ✔️ ✔️ ✔️
Receba seu fluxo de compartilhamento de tela ❌ ❌ ❌ ❌
Compartilhar conteúdo no modo "somente conteúdo" ✔️ ✔️ ✔️ ✔️
Receber fluxo de vídeo com conteúdo para experiência de compartilhamento de tela "somente conteúdo" ✔️ ✔️ ✔️ ✔️
Compartilhar conteúdo no modo "destaque" ❌ ❌ ❌ ❌
Receber fluxo de vídeo com conteúdo para uma experiência de compartilhamento de tela de "destaque" ❌ ❌ ❌ ❌
Compartilhar conteúdo no modo "lado a lado" ❌ ❌ ❌ ❌
Receber fluxo de vídeo com conteúdo para a experiência de compartilhamento de tela "lado a lado" ❌ ❌ ❌ ❌
Compartilhar conteúdo no modo "repórter" ❌ ❌ ❌ ❌
Receber fluxo de vídeo com conteúdo para uma experiência de compartilhamento de tela de "repórter" ❌ ❌ ❌ ❌
Compartilhar áudio do sistema durante o compartilhamento de tela ✔️ ❌ ❌ ❌
Lista de participantes Listar participantes ✔️ ✔️ ✔️ ✔️
Adicionar um usuário dos Serviços de Comunicação do Azure ❌ ❌ ❌ ❌
Adicionar um usuário do Teams ✔️ ✔️ ✔️ ✔️
Adicionar usuários do Teams respeita a configuração de acesso externo do Teams ✔️ ✔️ ✔️ ✔️
Adicionar usuário do Teams respeita a configuração de acesso de convidado do Teams ✔️ ✔️ ✔️ ✔️
Adicionar um número de telefone ✔️ ✔️ ✔️ ✔️
Remover um participante ✔️ ✔️ ✔️ ✔️
Admitir participantes no lobby nas reuniões do Teams ✔️ ✔️ ✔️ ✔️
Ser admitido do lobby para a reunião do Teams ✔️ ✔️ ✔️ ✔️
Adicionar usuários do Teams respeita as barreiras de informações ✔️ ✔️ ✔️ ✔️
Gerenciamento de dispositivo Solicitar permissão para usar áudio e/ou vídeo ✔️ ✔️ ✔️ ✔️
Obter lista de câmeras ✔️ ✔️ ✔️ ✔️
Definir a câmera ✔️ ✔️ ✔️ ✔️
Obter a câmera selecionada ✔️ ✔️ ✔️ ✔️
Obter lista de microfones ✔️ ✔️ ✔️ ✔️
Definir o microfone ✔️ ✔️ ✔️ ✔️
Obter o microfone selecionado ✔️ ✔️ ✔️ ✔️
Obter lista de alto-falantes ✔️ ✔️ ✔️ ✔️
Definir o alto-falante ✔️ ✔️ ✔️ ✔️
Obter o alto-falante selecionado ✔️ ✔️ ✔️ ✔️
Renderização de vídeo Renderizar um vídeo único em vários locais (câmera local ou fluxo remoto) ✔️ ✔️ ✔️ ✔️
Definir/atualizar o modo de dimensionamento ✔️ ✔️ ✔️ ✔️
Renderizar um fluxo de vídeo remoto ✔️ ✔️ ✔️ ✔️
Ver transmissão de vídeo no modo conferência ❌ ❌ ❌ ❌
Ver exibição de galeria grande ❌ ❌ ❌ ❌
Receber fluxo de vídeo do bot de mídia do Teams ❌ ❌ ❌ ❌
Receber fluxo ajustado para "conteúdo da Câmera" ❌ ❌ ❌ ❌
Adicionar e remover o fluxo de vídeo do destaque ✔️ ✔️ ✔️ ✔️
Permitir que o fluxo de vídeo seja selecionado para destaque ✔️ ✔️ ✔️ ✔️
Efeitos de vídeo Desfoque de fundo ✔️ ✔️ ✔️ ✔️
Imagem de fundo personalizada ✔️ ❌ ❌ ❌
Gravação e transcrição Gerenciar a gravação na nuvem do Teams ❌ ❌ ❌ ❌
Receba informações de chamada gravada na nuvem ✔️ ✔️ ✔️ ✔️
Gerenciar gravação local do Teams ❌ ❌ ❌ ❌
Receber informações de chamadas gravadas localmente ✔️ ✔️ ✔️ ✔️
Gerenciar transcrição do Teams ❌ ❌ ❌ ❌
Receber informações de chamada sendo transcrita ✔️ ✔️ ✔️ ✔️
Gerenciar legendas ocultas do Teams ✔️ ✔️ ✔️ ✔️
O suporte para gravação de conformidade ✔️ ✔️ ✔️ ✔️
Participação Levantar e abaixar a mão ✔️ ✔️ ✔️ ✔️
Indicar mãos levantadas e abaixadas de outros participantes ✔️ ✔️ ✔️ ✔️
Disparar reações ❌ ❌ ❌ ❌
Indicar reações de outros participantes ❌ ❌ ❌ ❌
Integrações Controlar aplicativos de terceiros do Teams ❌ ❌ ❌ ❌
Receber transmissão ao vivo do PowerPoint ❌ ❌ ❌ ❌
Receber fluxo do quadro de comunicações ❌ ❌ ❌ ❌
Interagir com uma sondagem ❌ ❌ ❌ ❌
Interaja com um Q&A ❌ ❌ ❌ ❌
Roteamento avançado de chamadas Iniciar uma chamada e adicionar operações de usuário Respeite as regras de encaminhamento ✔️ ✔️ ✔️ ✔️
Ler e configurar regras de encaminhamento de chamadas ❌ ❌ ❌ ❌
Iniciar uma chamada e adicionar operações de usuário honrar toque simultâneo ✔️ ✔️ ✔️ ✔️
Ler e configurar o toque simultâneo ❌ ❌ ❌ ❌
Iniciar uma chamada e adicionar operações de usuário honrar o status "Não perturbe" ✔️ ✔️ ✔️ ✔️
Colocar participante em espera toca a música em espera ✔️ ❌ ❌ ❌
Ser colocado pelo usuário do Teams em espera no cliente do Teams toca a música em espera ✔️ ✔️ ✔️ ✔️
Estacionar uma chamada ❌ ❌ ❌ ❌
Estar estacionado ✔️ ✔️ ✔️ ✔️
Transferir uma chamada para um usuário ✔️ ✔️ ✔️ ✔️
Ser transferido para um usuário ou uma chamada ✔️ ✔️ ✔️ ✔️
Transferir uma chamada para uma chamada ✔️ ✔️ ✔️ ✔️
Transferir uma chamada para o Serviço de Voz ❌ ❌ ❌ ❌
Ser transferido para a caixa postal ✔️ ✔️ ✔️ ✔️
Mesclar chamadas em andamento ❌ ❌ ❌ ❌
Iniciar uma chamada e adicionar operações de usuário respeitam a configuração de linha compartilhada? ✔️ ✔️ ✔️ ✔️
Iniciar chamada em nome do usuário do Teams ❌ ❌ ❌ ❌
Ler e configurar a configuração de linha compartilhada ❌ ❌ ❌ ❌
Receber uma chamada do auto-atendimento do Teams ✔️ ✔️ ✔️ ✔️
Transferir uma chamada para o auto-atendimento do Teams ✔️ ✔️ ✔️ ✔️
Receber uma chamada da fila de chamadas do Teams ✔️ ✔️ ✔️ ✔️
Transferir uma chamada da fila de chamadas do Teams ✔️ ✔️ ✔️ ✔️
Política de chamada do Teams Respeitar configuração "Fazer chamadas privadas" ✔️ ✔️ ✔️ ✔️
Respeitar configuração "Gravação de nuvem para chamada" Nenhuma API disponível Nenhuma API disponível Nenhuma API disponível Nenhuma API disponível
Respeitar configuração "Transcrição" Nenhuma API disponível Nenhuma API disponível Nenhuma API disponível Nenhuma API disponível
Respeitar configuração "Encaminhamento de chamadas e toque simultâneo para pessoas da sua organização" ✔️ ✔️ ✔️ ✔️
Respeitar configuração "Encaminhamento de chamadas e toque simultâneo para números de telefone externos" ✔️ ✔️ ✔️ ✔️
Respeitar configuração "Caixa postal está disponível para roteamento de chamadas de entrada" ✔️ ✔️ ✔️ ✔️
Respeitar configuração "Chamadas de entrada podem ser roteadas para grupos de chamadas" ✔️ ✔️ ✔️ ✔️
Respeitar configuração "Delegação para chamadas de entrada e saída" ✔️ ✔️ ✔️ ✔️
Respeitar configuração "Impedir bypass de tarifa e enviar chamadas por meio da PSTN" ❌ ❌ ❌ ❌
Respeitar configuração "Música em espera" ❌ ❌ ❌ ❌
Respeitar configuração "Ocupado em ocupado quando em uma chamada" ❌ ❌ ❌ ❌
Respeitar configuração "Legendas em tempo real nas chamadas do Teams" Nenhuma API disponível Nenhuma API disponível Nenhuma API disponível Nenhuma API disponível
Respeitar configuração "Filtragem de spam" ✔️ ✔️ ✔️ ✔️
Respeitar configuração "Dispositivos SIP podem ser usados para chamadas" ✔️ ✔️ ✔️ ✔️
DevOps Métricas do Azure ✔️ ✔️ ✔️ ✔️
Azure Monitor ✔️ ✔️ ✔️ ✔️
Insights dos Serviços de Comunicação do Azure ✔️ ✔️ ✔️ ✔️
Serviços de Comunicação do Azure – Eventos de chamada de voz e vídeo ❌ ❌ ❌ ❌
Análise de Chamadas do Teams ✔️ ✔️ ✔️ ✔️
Análise em tempo real do Teams ❌ ❌ ❌ ❌
  1. O recurso Compartilhar tela pode ser obtido usando Raw Media, se você quiser aprender, como adicionar Raw Media, visite o guia de início rápido.
  2. O SDK de chamada não tem uma API explícita, você precisa usar a API do sistema operacional (android & iOS) para alcançá-lo.

O suporte para streaming, tempos de vida, plataformas e navegadores é compartilhado com a visão geral do SDK de chamada dos Serviços de Comunicação.

Próximas etapas

Introdução a chamadas

Para obter mais informações, consulte os seguintes artigos: