Recursos de chamada com suporte para usuários do Teams no SDK de Chamada
O SDK de Chamada dos Serviços de Comunicação do Azure permite que dispositivos de usuário do Teams gerem 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 o JavaScript, confira os Guias de início rápido de chamada.
Principais recursos do SDK de chamada:
- Endereçamento – os Serviços de Comunicação do Azure usam o identificador de usuário do Microsoft Entra para lidar com os pontos de extremidade de comunicação. Os clientes usam as identidades do Microsoft Entra para se autenticarem no serviço e se comunicarem entre si. 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 que estão disponíveis atualmente no SDK de Chamadas dos Serviços de Comunicação do Azure ao participar de chamadas VoIP (voz sobre IP) entre duas pessoas ou VoIP de 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 | ✔️ | ✔️ | ✔️ | ✔️ | |
Receber o 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 | ✔️ | ❌ | ❌ | ❌ | |
Confira a exibição 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 em segundo plano | ✔️ | ✔️ | ✔️ | ✔️ |
Imagem de plano de fundo personalizada | ✔️ | ❌ | ❌ | ❌ | |
Gravando & transcrição | Gerenciar gravação em nuvem do Teams | ❌ | ❌ | ❌ | ❌ |
Receber informações da chamada sendo gravada em nuvem | ✔️ | ✔️ | ✔️ | ✔️ | |
Dar consentimento explícito para gravação em nuvem do Teams | ✔️ | ❌ | ❌ | ❌ | |
Gerenciar transcrição do Teams | ❌ | ❌ | ❌ | ❌ | |
Receber informações de chamada sendo transcrita | ✔️ | ✔️ | ✔️ | ✔️ | |
Dar consentimento explícito para transcrição do Teams | ✔️ | ❌ | ❌ | ❌ | |
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 Whiteboard | ❌ | ❌ | ❌ | ❌ | |
Interagir com uma sondagem | ❌ | ❌ | ❌ | ❌ | |
Interagir com uma Q&A | ❌ | ❌ | ❌ | ❌ | |
Roteamento avançado de chamadas | Iniciar uma chamada e adicionar operações de usuário respeitam as regras de encaminhamento | ✔️ | ✔️ | ✔️ | ✔️ |
Ler e configurar regras de encaminhamento de chamadas | ❌ | ❌ | ❌ | ❌ | |
Iniciar uma chamada e adicionar operações de usuário respeitam o toque simultâneo | ✔️ | ✔️ | ✔️ | ✔️ | |
Ler e configurar o toque simultâneo | ❌ | ❌ | ❌ | ❌ | |
Iniciar uma chamada e adicionar operações de usuário respeitam o status "Não incomodar" | ✔️ | ✔️ | ✔️ | ✔️ | |
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 | ❌ | ❌ | ❌ | ❌ |
- O recurso Compartilhar tela pode ser obtido usando Mídia bruta. Se você quiser aprender como adicionar Mídia bruta, visite o guia de início rápido.
- O SDK de Chamada não tem uma API explícita, você precisa usar a API do sistema operacional (Android & iOS) para obtê-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
Para obter mais informações, consulte os seguintes artigos:
- Familiarize-se com fluxos de chamada gerais
- Saiba mais sobre tipos de chamada