Compartilhar via

Problemas conhecidos nos Serviços de Comunicação do Azure chamando SDKs do WebJS

  • Artigo

Este artigo fornece problemas conhecidos relacionados ao uso do SDK de chamada do WebJS dos Serviços de Comunicação do Azure.

Todos os navegadores da área de trabalho

Não é possível renderizar várias visualizações de vários dispositivos na Web

Versão do navegador: Tudo.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: não é possível renderizar várias visualizações de vários dispositivos na Web. Esse problema é uma limitação conhecida.
Referência de problema conhecida: para obter mais informações, consulte Visão geral do SDK de chamada.

Alternar repetidamente dispositivos de vídeo pode fazer com que o streaming de vídeo pare temporariamente

Versão do navegador: Tudo.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: alternar entre dispositivos de vídeo pode fazer com que o fluxo de vídeo pause enquanto o fluxo é adquirido do dispositivo selecionado. Alternar entre dispositivos com frequência pode causar degradação de desempenho.
Solução alternativa recomendada: os desenvolvedores devem garantir a interrupção do fluxo de um dispositivo antes de iniciar outro para reduzir a degradação do desempenho ao alternar entre dispositivos de vídeo.

Problema de sinal de vídeo quando a chamada está no estado de conexão

Versão do navegador: Tudo.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: se um usuário ativar e desativar o vídeo rapidamente enquanto a chamada estiver no estado de conexão, essa ação poderá causar um problema com o fluxo adquirido para a chamada. É melhor para os desenvolvedores criarem seus aplicativos de uma maneira que não exija que o vídeo seja ativado ou desativado enquanto a chamada estiver no estado Conectando. O desempenho de vídeo degradado pode ocorrer nos seguintes cenários:

  • Se o usuário iniciar com áudio e, em seguida, iniciar e parar o vídeo, enquanto a chamada estiver no estado Conectando.
  • Se o usuário iniciar com áudio e, em seguida, iniciar e parar o vídeo, enquanto a chamada estiver no estado Lobby.

Atraso na renderização de vídeos de participantes remotos

Versão do navegador: Tudo.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: durante uma chamada de grupo contínua, suponha que o usuário A envie vídeo e, em seguida, o usuário B ingresse na chamada. Às vezes, o Usuário B não vê o vídeo do Usuário A ou o vídeo do Usuário A começa a renderizar após um longo atraso. Um problema de configuração de ambiente de rede pode causar esse atraso.
Referência de problema conhecida: para obter mais informações , recomendações de rede.

O uso excessivo de determinadas APIs, como mudo/desativação, resulta em limitação na infraestrutura dos Serviços de Comunicação do Azure

Versão do navegador: Tudo.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: Como resultado da chamada de API mute/unmute, a infraestrutura dos Serviços de Comunicação do Azure informa a outros participantes na chamada sobre o estado do áudio de um participante local que invocou mudo/desativação, para que os participantes da chamada saibam quem está mudo/desativado.

O uso excessivo de mudo/desativação é bloqueado na infraestrutura dos Serviços de Comunicação do Azure. A limitação ocorre se o participante (ou o aplicativo em nome do participante) tentar ativar/desativar o mudo continuamente, a cada segundo, mais de 15 vezes em uma janela sem interrupção de 30 segundos.

A ativação da Siri durante a chamada do WebRTC não ativa automaticamente o microfone no macOS

Sistema operacional: macOS.
Navegadores: todos os navegadores e versões.
Versão da SDK de Chamada dos Serviços de Comunicação do Azure: Todas.
Descrição: a chamada WebRTC não é silenciada automaticamente quando um usuário começa a falar com a Siri no meio da chamada. Durante essas instâncias, outros participantes podem ouvir o usuário dando comandos à Siri ou ao comando determinado e à resposta da Siri.
Referência de problema conhecido: esse é um problema conhecido no macOS.
Solução alternativa recomendada: atualmente, nenhuma solução alternativa direta está disponível. Os usuários precisam ativar manualmente o microfone ao ativar a Siri durante uma chamada.

Sobreposição de áudio em chamadas do ACS WebJS e chamadas de FaceTime no macOS

Sistema operacional: macOS.
Navegadores: todos os navegadores e versões.
Versão da SDK de Chamada dos Serviços de Comunicação do Azure: Todas.
Descrição: quando um usuário do macOS envolvido em uma chamada do ACS WebJS recebe uma chamada do FaceTime e a aceita, o áudio da chamada do ACS WebJS e das chamadas do FaceTime é transmitido e recebido simultaneamente. Isso resulta em fluxos de áudio sobrepostos em que o usuário pode ouvir e ser ouvido em ambas as chamadas ao mesmo tempo.
Referência de problema conhecido: esse é um problema conhecido no macOS.
Solução alternativa recomendada: atualmente, nenhuma solução alternativa direta está disponível. Os usuários podem ativar mudo proativo do microfone na chamada WebRTC ou sair da chamada WebRTC antes de atender a chamada do FaceTime.

Todos os navegadores móveis

Não é possível renderizar várias visualizações de vários dispositivos na Web

Versão do navegador: Tudo.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: não é possível renderizar várias visualizações de vários dispositivos na Web. Esse problema é uma limitação conhecida.
Referência de problema conhecida: para obter mais informações, consulte Visão geral do SDK de chamada.

Alternar repetidamente dispositivos de vídeo pode fazer com que o streaming de vídeo pare temporariamente

Versão do navegador: Tudo.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: alternar entre dispositivos de vídeo pode fazer com que o fluxo de vídeo pause enquanto o fluxo é adquirido do dispositivo selecionado. Alternar entre dispositivos com frequência pode causar degradação de desempenho.
Solução alternativa recomendada: os desenvolvedores devem garantir a interrupção do fluxo de um dispositivo antes de iniciar outro para reduzir a degradação do desempenho ao alternar entre dispositivos de vídeo.

Problema de sinal de vídeo quando a chamada está no estado de conexão

Versão do navegador: Tudo.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: se um usuário ativar e desativar o vídeo rapidamente enquanto a chamada estiver no estado de conexão, essa ação poderá causar um problema com o fluxo adquirido para a chamada. É melhor para os desenvolvedores criarem seus aplicativos de uma maneira que não exija que o vídeo seja ativado ou desativado enquanto a chamada estiver no estado Conectando. O desempenho de vídeo degradado pode ocorrer nos seguintes cenários:

  • Se o usuário iniciar com áudio e, em seguida, iniciar e parar o vídeo, enquanto a chamada estiver no estado Conectando.
  • Se o usuário iniciar com áudio e, em seguida, iniciar e parar o vídeo, enquanto a chamada estiver no estado Lobby.

Atraso na renderização de vídeos de participantes remotos

Versão do navegador: Tudo.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: durante uma chamada de grupo contínua, suponha que o usuário A envie vídeo e, em seguida, o usuário B ingresse na chamada. Às vezes, o Usuário B não vê o vídeo do Usuário A ou o vídeo do Usuário A começa a renderizar após um longo atraso. Um problema de configuração de ambiente de rede pode causar esse atraso.
Referência de problema conhecida: para obter mais informações , recomendações de rede.

O uso excessivo de determinadas APIs, como mudo/desativação, resulta em limitação na infraestrutura dos Serviços de Comunicação do Azure

Versão do navegador: Tudo.
Serviço de Comunicação do Azure chamando versão do SDK: Todos
Descrição: Como resultado da chamada de API mute/unmute, a infraestrutura dos Serviços de Comunicação do Azure informa a outros participantes na chamada sobre o estado do áudio de um participante local que invocou mudo/desativação, para que os participantes da chamada saibam quem está mudo/desativado.

O uso excessivo de mudo/desativação é bloqueado na infraestrutura dos Serviços de Comunicação do Azure. A limitação ocorre se o participante (ou o aplicativo em nome do participante) tentar ativar/desativar o mudo continuamente, a cada segundo, mais de 15 vezes em uma janela sem interrupção de 30 segundos.

A atualização de uma página não remove imediatamente o usuário da chamada

Versão do navegador: Tudo.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: se um usuário estiver em uma chamada e decidir atualizar a página, o serviço de mídia dos Serviços de Comunicação não removerá esse usuário imediatamente da chamada. Ele aguarda que o usuário retome. O usuário será removido da chamada depois que o serviço de mídia atingir o tempo limite.

Se um usuário estiver em uma chamada e decidir atualizar a página, o serviço de mídia dos Serviços de Comunicação não removerá esse usuário imediatamente da chamada. Ele aguarda que o usuário retome. O usuário será removido da chamada depois que o serviço de mídia atingir o tempo limite.

É melhor criar experiências do usuário que não exijam que os usuários finais atualizem a página do aplicativo durante uma chamada. Se um usuário atualizar a página, reutilize a mesma ID de usuário dos Serviços de Comunicação depois que o usuário retornar ao aplicativo. Ao reingressar com a mesma ID de usuário, o usuário é representado como o mesmo objeto existente na coleção remoteParticipants. Da perspectiva de outros participantes na chamada, o usuário permanece na chamada durante o tempo necessário para atualizar a página, até um minuto ou dois.

Se o usuário estava enviando vídeo antes de atualizar, a coleção videoStreams mantém as informações de fluxo anteriores até que o serviço expire e a remova. Nesse cenário, o aplicativo pode decidir observar quaisquer novos fluxos adicionados à coleção, e renderizar um com o maior id.

Safari Desktop

No macOS Safari 18 ou posterior, o usuário não pode compartilhar a tela por aproximadamente 1 minuto depois de cancelar a ação em uma chamada. Durante esse tempo, algumas das opções não funcionam enquanto o compartilhamento de tela se recupera

Versão do navegador: Safari 18 e posteriores.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: após cancelar uma tentativa de compartilhamento de tela, o usuário não poderá começar a compartilhar a tela novamente por aproximadamente 1 minuto. Durante esse período, algumas opções ficam sem resposta, como a capacidade de ativar/desativar a câmera. Após cerca de 1 minuto, o usuário poderá iniciar o compartilhamento de tela e usar todas as opções disponíveis na chamada novamente.
Referência de problema conhecida: essa regressão é um problema conhecido introduzido no Safari.
Solução alternativa recomendada: é recomendável evitar o uso da opção “Cancelar” durante o compartilhamento de tela para evitar atrasos na reinicialização do compartilhamento de tela. Se o compartilhamento precisar ser interrompido, é recomendável concluir a ação de compartilhamento ou aguardar o tempo de recuperação antes de tentar novamente.

No macOS Safari 17 e superior, o áudio pode ser interrompido se os usuários do macOS conectarem fones de ouvido Bluetooth durante uma chamada

Versão do navegador: Safari 17 e posteriores.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: quando os usuários do macOS conectam os fones de ouvido Bluetooth a um MacBook durante uma chamada usando o Safari, eles podem enfrentar problemas com o áudio. Em ambos os casos de uso em que os usuários conectam fones de ouvido Bluetooth antes ou durante a chamada, o áudio de entrada e saída pode ficar indisponível ou interrompido. Observe que esperar pelo menos 30 segundos pode resolver o problema do áudio de entrada, mas o áudio de saída geralmente não se recupera automaticamente.
Referência de problema conhecida: essa regressão é um problema conhecido introduzido no Safari.
Solução alternativa recomendada: como uma solução temporária, é possível que os usuários precisem reconectar seu dispositivo Bluetooth ou atualizar a chamada para tentar a recuperação do áudio. Atualizar para a versão mais recente do macOS e do Safari também pode ajudar, pois pode incluir possíveis correções para esses problemas.

No macOS Safari 17 e superior, os efeitos em segundo plano de vídeo podem causar flash de vídeo, tanto na visualização local quanto no lado remoto

Versão do navegador: Safari 17 e posteriores.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: um bug foi encontrado em uma das atualizações do macOS Safari 17 que está causando a captura de quadros de implementação de efeitos de plano de fundo para ignorar quadros e, portanto, pode causar um flash de vídeo na visualização local e no lado remoto.

  • Uma correção está disponível a partir da versão 17.5 do Safari (macOS Sonoma 14.5).

Solução alternativa recomendada: recomenda-se aos usuários que atualizem para a versão mais recente do macOS e Safari (pelo menos v17.5) em que esse problema foi resolvido.

Problema de vídeo de entrada e saída piscando no macOS Sonoma com versões do Safari até 17.1

Versão do navegador: Safari v17.0, v17.1 (macOS Sonoma 14).
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: usuários no macOS Sonoma 14.0 enfrentam um problema de vídeo piscando nas versões do Safari 17.0 e 17.1 ao ingressar em uma chamada com vídeo ativado. O vídeo de entrada pisca quando um usuário do Safari ingressa em uma chamada, afetando o que é recebido de outros participantes da chamada. Além disso, o vídeo de saída do usuário do Safari pisca para os participantes remotos que já estão na chamada. Esse problema atrapalha a qualidade visual da chamada.

  • Uma correção está disponível a partir do Safari versão 17.2.

Solução alternativa recomendada: recomenda-se aos usuários que atualizem para a versão mais recente do macOS e Safari (pelo menos v17.2) em que esse problema foi resolvido.

Outro participante da chamada não pôde iniciar o compartilhamento de tela simultaneamente com o usuário do macOS Safari nas chamadas de vídeo dos Serviços de Comunicação do Azure entre duas pessoas

Versão do navegador: Tudo.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: nas chamadas de vídeo dos Serviços de Comunicação do Azure entre duas pessoas, quando um usuário do macOS Safari compartilha sua tela, outro participante que usa um navegador diferente não pode iniciar o compartilhamento de tela até que o primeiro participante pare seu compartilhamento de tela. Essa limitação é observada em várias combinações de navegadores e sistemas operacionais, mas é específica para chamadas entre duas pessoas. O problema não ocorre em chamadas em que ambos os participantes usam o Safari no macOS.
Referência de problema conhecida: essa regressão é um problema conhecido introduzido no Safari.
Solução alternativa recomendada: uma solução alternativa temporária é garantir que apenas um participante compartilhe sua tela por vez em chamadas de vídeo dos Serviços de Comunicação do Azure entre duas pessoas, quando um dos participantes estiver usando o macOS Safari.

O compartilhamento de tela não funciona no macOS Ventura com versões do Safari até 16.3

Versão do navegador: Safari v16.1, v16.2, v16.3 (macOS Ventura 13.0).
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: O problema foi introduzido no macOS Ventura 13.0 ao usar o navegador Safari (v16.1, v16.2 e v16.3), e uma correção está disponível a partir da versão 16.4 do Safari.
Referência de problema conhecida: essa regressão é um problema conhecido introduzido no Safari.
Solução alternativa recomendada: recomenda-se aos usuários que atualizem para a versão mais recente do macOS e Safari (pelo menos v16.4) em que esse problema foi resolvido.

Os participantes das chamadas pela Web ouvem o áudio da chamada PSTN quando forem atendidos no macOS com integração com o iPhone

Versão do navegador: Tudo.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: quando um usuário do macOS, que está em uma chamada ACS ativa usando um navegador, aceita uma chamada PSTN recebida no seu MacBook que está vinculado ao iPhone (usando a mesma conta do iCloud), o áudio da chamada PSTN é compartilhado entre os participantes da chamada na Web. Isso faz com que os participantes da chamada ouçam o áudio da chamada PSTN.
Referência de problema conhecido: esse é um problema conhecido no macOS.
Solução alternativa recomendada: atualmente, nenhuma solução alternativa direta está disponível. Os usuários são aconselhados a usarem dispositivos separados nas chamadas PSTN e da Web para evitarem que o áudio seja compartilhado com outros participantes da chamada em uma chamada separada.

Safari iOS Mobile

Problemas de recuperação de vídeo no iOS 17+ quando um usuário do iOS recebe uma chamada PSTN ou de aplicativo de terceiros, ou ativa a Siri durante uma chamada baseada na Web do ACS

Versão do iOS: versões 17 ou superiores do iOS.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: quando um usuário do iOS em uma chamada da Web recebe e recusa ou aceita uma chamada de aplicativo PSTN/de terceiros, o usuário terá problemas de vídeo. O vídeo de entrada pode aparecer congelado ou nenhum vídeo de entrada pode ser exibido. Isso exigirá uma nova habilitação do usuário da câmera. A visualização do vídeo e o vídeo de saída também não conseguem se recuperar, a menos que o usuário reative a câmera.

Problemas de vídeo no iOS 17+ quando um usuário do iOS tenta usar a Siri durante uma chamada

Versão do iOS: versões 17 ou superiores do iOS.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: quando um usuário do iOS tenta ativar a Siri no meio de uma chamada móvel pela Web, o vídeo de entrada pode ficar congelado e levar alguns segundos para ser recuperado.

Problema de resolução de visualização da câmera nas chamadas da Web ao usar o iOS 16.3 a 17.3.1

Versão do iOS: versões iOS da 16.3 a 17.3.1.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: é possível que os usuários tenham um problema em que a visualização da câmera é mostrada em uma resolução incorreta e aparece cortada quando o usuário do iOS entra em uma chamada usando o iOS Safari móvel com a câmera habilitada. O problema não será mais observado se o usuário reabilitar a câmera durante a chamada. O problema foi corrigido com o iOS 17.4+.
Solução alternativa recomendada: os usuários são aconselhados a atualizarem para a versão mais recente do iOS e do Safari (pelo menos iOS 17.4), onde esse problema foi resolvido.

Dados telemétricos para audioInputLevel e frameRateInput ausentes em chamadas de vídeo no iOS 16 para iOS 17.4

Versão do iOS: versões iOS de 16.0 a 17.4.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: os dados telemétricos de audioInputLevel e frameRateInputnão são capturados durante chamadas de vídeo nas versões 16 a 17.4 do iOS, afetando a capacidade de monitorar e otimizar as configurações de áudio e vídeo em tempo real. O problema foi corrigido com o iOS 17.5+.
Solução alternativa recomendada: os usuários são aconselhados a atualizarem para a versão mais recente do iOS e do Safari (pelo menos iOS 17.5), em que esse problema foi resolvido.

Problema de recuperação de áudio e vídeo no iOS 16 a 16.3.1 durante as chamadas feitas pela Web com as chamadas recebidas de terceiros ou PSTN

Versão do iOS: versões do iOS 16 até 16.3.1.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: quando um usuário do iOS entra em uma chamada da Web e recebe uma chamada do aplicativo PSTN/de terceiros, o áudio de entrada e saída e o vídeo de saída não recuperam automaticamente a chamada depois de terminar a chamada telefônica. O usuário do iOS precisa desativar a chamada na Web novamente. O usuário final deve desabilitar e habilitar o botão "Microfone" para conseguir obter áudio e vídeo.
Referência de problema conhecido: bug do WebKit relacionado aqui.
Solução alternativa recomendada: os usuários são aconselhados a atualizarem para a versão mais recente do iOS e do Safari (pelo menos iOS 16.4), em que esse problema foi resolvido.

O iOS 16 introduziu bugs ao colocar o navegador em segundo plano durante uma chamada

Versão do iOS: iOS versões 16 a 16.1.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: A versão do iOS 16 introduziu um bug que pode interromper a chamada de áudio\vídeo dos Serviços de Comunicação do Azure ao usar o navegador móvel Safari. O impacto pode ser que uma chamada do Serviços de Comunicação do Azure pode parar de funcionar enquanto está acontecendo e a única resolução para fazê-la funcionar novamente é pedir que o cliente final reinicie o telefone. Para reproduzir este bug:

  • Ter um usuário usando um iPhone executando o iOS 16.
  • Ingresse na chamada dos Serviços de Comunicação do Azure (apenas com áudio ou com áudio e vídeo) usando o navegador móvel Safari iOS. Se durante uma chamada alguém colocar o navegador Safari em segundo plano e exibir o YouTube OU receber uma chamada faceTime\phone enquanto estiver conectado por meio de um dispositivo Bluetooth Resultados:
  • Após alguns minutos dessa situação, o vídeo de entrada e saída pode parar de funcionar.
  • A única maneira de fazer com que a chamada dos Serviços de Comunicação do Azure funcione novamente é fazer com que o usuário final reinicie o telefone. O bug foi corrigido com o iOS 16.2.

Referência de problema conhecida: bugs relacionados do WebKit aqui e aqui.
Solução alternativa recomendada: considere atualizar para a versão mais recente do iOS.

Problemas de vídeo e áudio no iPhone X, ocorrendo quando o usuário está em uma chamada por mais de 30 minutos com a câmera ativada

Dispositivos afetados: iPhone X (iOS 16.7.x).
Versão do navegador: Tudo.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: durante as chamadas do Serviço de Comunicação do Azure no iPhone X com o iOS 16.7.x, os usuários experimentam o desaparecimento de sua visualização de vídeo local e vídeo de entrada após mais de 30 minutos de estar em uma chamada com vídeo habilitado, que pode parecer em branco ou vazio para o usuário. Para outros usuários, o vídeo do usuário do iPhone X aparece congelado no momento em que é perdido no dispositivo iPhone X. Junto com o desaparecimento do vídeo, um eco pronunciado pode ocorrer. O vídeo é restaurado quando o usuário do iPhone X desativa a câmera e liga-a novamente.

  • Esse problema foi observado apenas no dispositivo iPhone X com as versões 16.7.5 e 16.7.7 do iOS.

O microfone do headset Bluetooth não é detectado ou audível durante a chamada no Safari no iOS

Versão do iOS: Todos
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: os fones de ouvido Bluetooth não são compatíveis com o Safari no iOS. Seu dispositivo Bluetooth não será listado nas opções de microfone disponíveis e os outros participantes não poderão ouvir você usando o Bluetooth no Safari. Essa regressão é uma limitação conhecida do sistema operacional. Com o Safari no macOS e iOS/iPadOS, não é possível enumerar nem selecionar dispositivos de alto-falante por meio do gerenciador de dispositivos dos Serviços de Comunicação. Isso porque o Safari não dá suporte à enumeração ou à seleção de alto-falantes.
Solução alternativa recomendada: nesse cenário, use o sistema operacional para atualizar a seleção do dispositivo.

O uso de bibliotecas de terceiros durante a chamada pode resultar em perda de áudio

Versão do navegador: Tudo.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: se você usar getUserMedia separadamente dentro do aplicativo, o fluxo de áudio será perdido. Isso ocorre porque uma biblioteca de terceiros assume o acesso ao dispositivo da biblioteca dos Serviços de Comunicação do Azure.

  • Não use bibliotecas de terceiros que estejam usando a API getUserMedia internamente durante a chamada.
  • Se você ainda precisar usar uma biblioteca de terceiros, a única maneira de recuperar o fluxo de áudio é alterar o dispositivo selecionado (se o usuário tiver mais de um), ou reiniciar a chamada. A causa deste problema pode ser que adquirir seu próprio fluxo do mesmo dispositivo terá um efeito colateral de executar em condições de corrida. A aquisição de fluxos de outros dispositivos pode levar o usuário a uma largura de banda USB/E/S insuficiente e a taxa sourceUnavailableError aumentará demais.

Enumerando ou acessando dispositivos para Safari no iOS

Versão do navegador: Tudo.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: em determinados ambientes, você pode notar que as permissões do dispositivo são redefinidas após algum período de tempo. No macOS e no iOS, o Safari não mantém permissões por muito tempo, a menos que haja um fluxo adquirido. A maneira mais simples de resolver isso é chamar a API DeviceManager.askDevicePermission() antes de chamar as APIs de enumeração de dispositivo do gerenciador de dispositivos. Essas APIs de enumeração incluem DeviceManager.getCameras(), DeviceManager.getSpeakers(), e DeviceManager.getMicrophones(). Se as permissões estiverem presentes, o usuário não verá nada. Se as permissões não estiverem presentes, o usuário será solicitado a fornecer as permissões novamente.

Microfone/câmera local muda quando determinadas interrupções ocorrem no iOS Safari

Descrição: esse problema pode ocorrer se outro aplicativo ou o sistema operacional assumir o controle do microfone ou da câmera. Aqui estão alguns exemplos que podem acontecer enquanto um usuário está na chamada:

  • Uma chamada de entrada chega por meio de PSTN (Rede Telefônica Comutado Pública) e captura o acesso ao dispositivo de microfone.
  • Um usuário reproduz um vídeo do YouTube, por exemplo, ou inicia uma chamada FaceTime. Alternar para outro aplicativo nativo pode capturar o acesso ao microfone ou à câmera.
  • Um usuário habilita a Siri, que captura o acesso ao microfone.

No iOS, por exemplo, durante uma chamada dos Serviços de Comunicação do Azure, se uma chamada PSTN chegar, uma UFD com microfoneMutedUnexepectedly ruim será gerada e o áudio parará de fluir na chamada dos Serviços de Comunicação do Azure e a chamada será marcada como silenciada. Depois que a chamada PSTN terminar, o usuário precisará desativar a chamada dos Serviços de Comunicação do Azure para que o áudio comece a fluir novamente na chamada dos Serviços de Comunicação do Azure.

Caso a câmera esteja ativada e ocorra uma interrupção, a chamada dos Serviços de Comunicação do Azure pode ou não perder a câmera. Se perdido, a câmera será marcada como desativada e o usuário precisará ativá-la novamente depois que a interrupção liberou a câmera.

Ocasionalmente, os dispositivos de microfone ou câmera não serão liberados a tempo e isso pode causar problemas com a chamada original. Por exemplo, se o usuário tentar ativar o som ao assistir a um vídeo do YouTube ou se uma chamada PSTN estiver ativa simultaneamente.

  • A renderização dos fluxos de vídeo de entrada não será interrompida se o usuário estiver no iOS 15.2+ e estiver usando o SDK versão 1.4.1-beta.1+. As etapas de desativar mudo/iniciar vídeo ainda serão necessárias para reiniciar o áudio e o vídeo de saída.
  • Para o iOS 15.4+, áudio e vídeo devem conseguir se recuperar automaticamente na maioria dos casos. Em alguns casos de borda, para desativar o mudo, uma API para "desativar o mudo" deve ser chamada pelo aplicativo (pode ser resultado da ação do usuário) para recuperar o áudio de saída.

O iOS Safari atualiza a página se o usuário for para outro aplicativo e retornar ao navegador

Versão do navegador: Tudo.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: O problema pode ocorrer se um usuário em uma chamada dos Serviços de Comunicação do Azure com o iOS Safari e alternar para outro aplicativo por um tempo. Depois que o usuário retornar ao navegador, a página do navegador poderá ser atualizada. Isso ocorre porque o sistema operacional mata o navegador. Uma maneira de atenuar esse problema é manter alguns estados e recuperar após a atualização da página.

Um usuário móvel do iOS retirou a chamada, mas ainda está aparecendo na lista de participantes

Versão do navegador: Tudo.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: o problema pode ocorrer se um usuário móvel sair da chamada de grupo dos Serviços de Comunicação do Azure sem usar a API Call.hangUp(). Quando um usuário móvel fecha o navegador ou atualiza a página da Web sem desligar, outros participantes da chamada de grupo ainda podem ver esse usuário móvel na lista de participantes por cerca de 60 segundos.

Problema de congelamento do Safari no iOS 15

Versão do navegador: iOS versões 15 a 15.1.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: é possível que os usuários experimentem o congelamento do Safari ao navegarem pelo YouTube, habilitarem a Siri, receberem chamadas PSTN de entrada ou durante outros cenários de interrupção durante uma chamada pela Web. Esse é um problema conhecido introduzido com o iOS 15 e observado nas versões 15.0, 15.0.2 e 15.1 do iOS.

  • Ele foi corrigido com o iOS 15.2+.

Referência de problema conhecida: bugs relacionados do WebKit aqui e aqui.
Solução alternativa recomendada: considere atualizar para a versão mais recente do iOS.

Safari iPadOS Tablet

A rotação de um dispositivo pode criar baixa qualidade de vídeo – Apple iPad 8 e Apple iPad X

Dispositivos afetados: Apple iPad 8 e Apple iPad X.
Descrição: quando os usuários giram um dispositivo, esse movimento pode degradar a qualidade do vídeo que está sendo transmitido.

Área de Trabalho do Chrome

Problemas de desconexão de chamadas no macOS 15.0, Build: 24A335

Versão do SO: macOS 15.0, build: 24A335.
Versão do navegador: Google Chrome - todas as versões.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: ao iniciar uma chamada 1:1 no macOS 15.0, se o receptor da chamada aceitar a chamada, às vezes ela se desconecta automaticamente após alguns segundos. São observados atrasos adicionais no recebimento e na combinação de chamadas, o que também pode levar a desconexões. Desabilitar o Firewall resolve temporariamente esses problemas, sugerindo que a interferência das configurações de firewall do macOS é a causa raiz. Esse problema foi resolvido no macOS 15.0.1, que aprimora a compatibilidade com software de segurança de terceiros, conforme detalhado aqui nas notas de versão do macOS 15.0.1.
Solução alternativa recomendada: os usuários que enfrentam esse problema devem considerar desabilitar o Firewall temporariamente ou atualizar para o macOS 15.0.1 para resolver esses problemas de conectividade de chamada de maneira permanente.

Chrome M98 – uma regressão que degrada a resolução de vídeo e aumenta a geração de quadros-chave para dispositivos que não têm um cartão NVIDIA

Versão do navegador: Google Chrome versão 98 (fevereiro de 2022)
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: O Chrome versão 98 introduziu uma regressão com geração anormal de keyframes de vídeo que afeta a resolução de um fluxo de vídeo enviado negativamente para a maioria (70%+) dos usuários.
Referência de problema conhecida: essa regressão é um problema conhecido introduzido no Chromium.
Solução alternativa recomendada: atualizando o Google Chrome para a versão mais recente.

Chrome Mobile Android

Chrome M125 – Nenhum vídeo de saída em chamadas em Grupo e chamadas dos Serviços de Comunicação do Azure – Microsoft Teams em alguns dispositivos Android

Versão do navegador: Google Chrome versão 125 (maio de 2024) instalado em dispositivos Android.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: o Chrome versão 125 para Android introduziu uma regressão ao fazer chamadas de vídeo - o resultado desse bug é que um usuário que faz uma chamada nos Serviços de Comunicação do Azure com essa versão do Chrome não tem vídeo de saída em chamadas em Grupo e chamadas dos Serviços de Comunicação do Azure – Microsoft Teams. Esse comportamento é observado em dispositivos Android Huawei, OnePlus, Poco e Xiaomi. O comportamento não é observado em dispositivos Android Samsung, Google Pixel e Motorola.

  • Uma correção está disponível a partir do Google Chrome versão 125.0.6422.146/147.

Dispositivos afetados:

  • Huawei P30 Lite
  • OnePlus Nord N10
  • OnePlus 7T
  • Poco X3 Pro
  • Xiaomi Redmi 8T e possivelmente outros modelos/dispositivos similares.

Solução alternativa recomendada: os usuários são aconselhados a atualizarem para o Google Chrome versão 125.0.6422.146/147 ou posterior, em que esse problema foi resolvido.

Problema de áudio de saída no Android 14 em que o navegador está em segundo plano ou a tela do dispositivo está bloqueada

Versão do Android: Android 14.
Versão do navegador: Tudo.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: no Android 14, quando o navegador é colocado em segundo plano ou a tela do dispositivo está bloqueada, o áudio de saída desaparece após aproximadamente 5 segundos. Esse problema afeta a experiência do usuário, pois interrompe a transmissão de áudio durante as chamadas. O problema não é observado no Android 13 ou em outras versões do Android.
Solução alterativa recomendada: recomenda-se aos usuários que mantenham o navegador ativo em primeiro plano durante as chamadas.

Problema de áudio de entrada e saída no Android quando o navegador está em segundo plano ou a tela do dispositivo é bloqueada com o modo Economia de Energia habilitado

Versão do navegador: Tudo.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: em celulares Android quando o modo Economia de Energia está habilitado, o áudio de entrada e saída é interrompido imediatamente quando o navegador que hospeda a chamada do ACS é colocado em segundo plano ou a tela do dispositivo é bloqueada. Além disso, devido à ação de colocar o navegador em segundo plano no modo Economia de Energia, o usuário será desconectado e removido da chamada após cerca de um minuto depois que a tela do dispositivo for bloqueada ou o navegador entrar em segundo plano.
Referência de problema conhecido: esse é um problema conhecido no Chromium.
Solução alternativa recomendada: para evitar esse problema, os usuários são aconselhados a manter o navegador ativo em primeiro plano durante as chamadas ou desabilitar o modo Economia de Energia durante as chamadas do WebRTC.

Versão do navegador: Tudo.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: quando mais de três usuários estão em uma chamada de vídeo com um usuário que tem um dispositivo Android, às vezes, o usuário Android pode observar que o vídeo recebido fica piscando e, outras vezes, duplica com outro vídeo recebido. Outro comportamento que os usuários às vezes vivenciam no mesmo caso de uso é que o vídeo recebido pode aparecer com uma tonalidade verde ou sobreposição verde por um instante e, outras vezes, pode durar mais. Esse comportamento é especialmente perceptível quando outro usuário reativa sua câmera ou entra na chamada com o vídeo ativado. Esse comportamento é observado no Samsung Galaxy S10, S20, S21 e Google Pixel 6, 8.
Dispositivos afetados:

  • Samsung Galaxy S10
  • Samsung Galaxy S20
  • Samsung Galaxy S21
  • Google Pixel 6
  • Google Pixel 8

Referência de problema conhecido: essa regressão é um problema conhecido no Chromium.

Chrome M115 – Nenhum vídeo de saída em chamadas do Grupo e dos Serviços de Comunicação do Azure -Microsoft Teams

Versão do navegador: Google Chrome versão 115 (Jul 2023) instalada em dispositivos Android.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: o Chrome versão 115 para Android introduziu uma regressão ao fazer chamadas de vídeo - o resultado desse bug é um usuário fazendo uma chamada nos Serviços de Comunicação do Azure com esta versão do Chrome não tem nenhum vídeo de saída em chamadas do Grupo e dos Serviços de Comunicação do Azure-Microsoft Teams.
Referência de problema conhecida: essa regressão é um problema conhecido introduzido no Chromium.
Solução alternativa recomendada: como uma mitigação de curto prazo, instrua os usuários a usar o Microsoft Edge ou o Firefox no Android ou evite usar o Google Chrome 115/116 no Android.

O usuário do Android ainda pode ouvir áudio da chamada "Serviços de Comunicação do Azure" durante uma chamada PSTN

Versão do navegador: Tudo.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: esse problema ocorre quando um usuário do Android Chrome experimenta uma chamada PSTN de entrada. Depois de atender à chamada PSTN, o microfone na chamada "Serviços de Comunicação do Azure" fica mudo. O áudio de saída da chamada "Serviços de Comunicação do Azure" é mudo, para que outros participantes não possam ouvir o usuário que é a chamada PSTN. Vale a pena observar que o áudio de entrada do usuário não está mudo e esse comportamento é inerente ao navegador.
Solução alternativa recomendada: aguarde uma próxima atualização ou patch do Google.

O áudio de entrada é visivelmente mais silencioso na chamada dos Serviços de Comunicação do Azure após chamada de aplicativo de terceiros em dispositivos Android

Versão do navegador: Tudo.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: Os usuários experimentam um áudio de entrada visivelmente mais silencioso depois de receber e aceitar uma chamada de um aplicativo de terceiros (por exemplo, WhatsApp, Viber) durante uma chamada dos Serviços de Comunicação do Azure. Esse problema ocorre em dispositivos Android usando o navegador móvel. Além disso, os controles de volume indicam níveis máximos, embora o áudio permaneça mais silencioso do que antes da chamada de terceiros.
Referência de problema conhecido: esse é um problema conhecido no Chromium.
solução alternativa recomendada: Os usuários são aconselhados a voltar à chamada dos Serviços de Comunicação do Azure ou lidar com chamadas de aplicativo de terceiros separadamente.

O Android Chrome silencia a chamada após o navegador ficar em segundo plano por um minuto

Versão do navegador: Tudo.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: no Android Chrome, se um usuário estiver em uma chamada dos Serviços de Comunicação do Azure e colocar o navegador em segundo plano por um minuto. O microfone perde o acesso e os outros participantes da chamada não podem ouvir o áudio do usuário. Depois que o usuário colocar o navegador em primeiro plano, o microfone estará disponível novamente.
Referência de problema conhecida: bugs de chromium relacionados aqui e aqui.

Microfone/câmera local muda quando determinadas interrupções ocorrem no Android Chrome

Versão do navegador: Tudo.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: esse problema pode ocorrer se outro aplicativo ou o sistema operacional assumir o controle do microfone ou da câmera. Aqui estão alguns exemplos que podem acontecer enquanto um usuário está na chamada:

  • Uma chamada de entrada chega por meio de PSTN (Rede Telefônica Comutado Pública) e captura o acesso ao dispositivo de microfone.
  • Um usuário reproduz um vídeo do YouTube, por exemplo, ou inicia uma chamada de aplicativo de terceiros. Alternar para outro aplicativo nativo pode capturar o acesso ao microfone ou à câmera.

No Android Chrome, quando uma chamada PSTN chega, o áudio para de fluir na chamada dos Serviços de Comunicação do Azure e a chamada dos Serviços de Comunicação do Azure não é marcada como silenciada. Nesse caso, não há nenhum evento UFD microphoneMutedUnexepectedly. Depois que a chamada PSTN for concluída, o Android Chrome recuperará o áudio automaticamente e o áudio começará a fluir normalmente novamente na chamada dos Serviços de Comunicação do Azure.

Caso a câmera esteja ativada e ocorra uma interrupção, a chamada dos Serviços de Comunicação do Azure pode ou não perder a câmera. Se perdido, a câmera será marcada como desativada e o usuário precisará ativá-la novamente depois que a interrupção liberou a câmera.

Ocasionalmente, os dispositivos de microfone ou câmera não serão liberados a tempo e isso pode causar problemas com a chamada original. Por exemplo, se o usuário tentar ativar o som ao assistir a um vídeo do YouTube ou se uma chamada PSTN estiver ativa simultaneamente.

Falha na seleção automática de microfone para fones de ouvido com fio nas chamadas WebRTC nos dispositivos Android

Versão do navegador: Tudo.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: quando os usuários conectam fones de ouvido com fio ao seu dispositivo Android e participam de uma chamada WebRTC, a opção de microfone não é padrão para os fones de ouvido com fio. Esse problema pode ser reproduzido de forma consistente nos diferentes dispositivos do Android e nas versões do Google Chrome. Comportamento semelhante foi observado em outros serviços, como o Twilio e o exemplo do WebRTC do Google.
Referência de problema conhecido: esse é um problema conhecido no Chromium.
Solução alternativa recomendada: os usuários devem selecionar manualmente os fones de ouvido com fio como a opção de microfone nas configurações de chamada depois de ingressarem na chamada WebRTC.

Um usuário móvel do Android retirou a chamada, mas ainda está aparecendo na lista de participantes

Versão do navegador: Tudo.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: o problema pode ocorrer se um usuário móvel sair da chamada de grupo dos Serviços de Comunicação do Azure sem usar a API Call.hangUp(). Quando um usuário móvel fecha o navegador ou atualiza a página da Web sem desligar, outros participantes da chamada de grupo ainda podem ver esse usuário móvel na lista de participantes por cerca de 60 segundos.

Alguns dispositivos Android (A326U, A125U e A215U) falham em cenários de chamada, exceto para chamadas em grupo

Dispositivos afetados:

  • Samsung Galaxy A32 (Modelo A326U)
  • Samsung Galaxy A12 (Modelo A125U)
  • Samsung Galaxy A21 (Modelo A215U)

Descrição: muitos dispositivos Android específicos não conseguem iniciar, aceitar chamadas e reuniões. Os dispositivos que têm esse problema não podem se recuperar e falham em todas as tentativas. Em grande parte, são os dispositivos do modelo A da Samsung, especialmente os modelos A326U, A125U e A215U.

Rotação de um dispositivo pode criar baixa qualidade de vídeo – Google Pixel 3a, Google Pixel 5

Dispositivos afetados: Google Pixel 3a, Google Pixel 5.
Versão do navegador: Tudo.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: quando os usuários giram um dispositivo, esse movimento pode degradar a qualidade do vídeo que está sendo transmitido.

Comutação de câmera faz a tela congelar – Google Pixel 4a

Dispositivo afetado: Google Pixel 4a.
Versão do navegador: Tudo.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: quando um usuário dos Serviços de Comunicação ingressa em uma chamada usando o SDK de chamada javaScript e, em seguida, seleciona o botão de opção de câmera, a interface do usuário pode ficar sem resposta. Em seguida, o usuário deve atualizar o aplicativo ou efetuar push do navegador para o segundo plano.

Chrome Mobile iOS

Nenhum áudio de saída e entrada ao alternar o navegador para tela de fundo ou bloquear o dispositivo – corrigido na versão 16.4+ do iOS

Versão do iOS: todas as versões do iOS até o iOS 16.3.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: O problema de nenhum áudio de saída ou de entrada ao alternar o navegador para o plano de fundo ou bloquear o dispositivo estava presente e incluindo o iOS versão 16.3 e foi corrigido a partir do iOS 16.4.
Referência de problema conhecida: bug do WebKit relacionado.
Solução alternativa recomendada: considere atualizar para a versão mais recente do iOS.

Nenhum áudio de entrada/saída proveniente do fone de ouvido bluetooth – iOS 15

Versão do iOS: vimos esse problema em versões do iOS – 15.6, 15.7.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: quando um usuário conecta o headset bluetooth no meio da chamada dos Serviços de Comunicação do Azure, o áudio ainda sai do alto-falante até que o usuário bloqueie e desbloqueie o telefone. O problema não é reproduzível no iOS 16.
Solução alternativa recomendada: considere atualizar para a versão mais recente do iOS.

Um usuário móvel do iOS retirou a chamada, mas ainda está aparecendo na lista de participantes

Versão do navegador: Tudo.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: o problema pode ocorrer se um usuário móvel sair da chamada de grupo dos Serviços de Comunicação do Azure sem usar a API Call.hangUp(). Quando um usuário móvel fecha o navegador ou atualiza a página da Web sem desligar, outros participantes da chamada de grupo ainda podem ver esse usuário móvel na lista de participantes por cerca de 60 segundos.

Firefox Desktop

Enumeração e seleção do locutor indisponíveis no Firefox por meio do gerenciador de dispositivos dos Serviços de Comunicação

Versão do navegador: Tudo.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: se você estiver usando o Firefox, seu aplicativo não poderá enumerar ou selecionar alto-falantes por meio do gerenciador de dispositivos dos Serviços de Comunicação.
Solução alternativa: nesse cenário, você deve selecionar dispositivos por meio do sistema operacional.

No momento, não há suporte para câmeras virtuais

Versão do navegador: Tudo.
Serviço de Comunicação do Azure chamando versão do SDK: Tudo.
Descrição: No momento, não há suporte para câmeras virtuais ao fazer chamadas de áudio\vídeo da área de trabalho do Firefox.