Noções básicas sobre códigos de chamada e erros de subcódigos

O SDK de chamada e a respetiva infraestrutura de servidor usam uma estrutura unificada para representar erros. Usando códigos de erro, subcódigos e suas categorias de resultados correspondentes, como desenvolvedor, você pode entender mais facilmente esses erros e encontrar explicações sobre por que eles aconteceram e como mitigar no futuro. Os detalhes sobre os resultados do erro podem ser vistos como:

Código São modelados como inteiros de 3 dígitos que indicam o status de resposta de um cliente ou servidor. Eles estão agrupados em:

• Respostas positivas (200-299)
  
• Erro do cliente (400-499)
  
• Erro de servidor (500-599)
  

Subcódigo São definidos como um número inteiro, onde cada número indica um motivo exclusivo, específico para um grupo de cenários ou resultado de cenário específico.
Mensagem Descreve o resultado e fornece dicas sobre como atenuar o problema se um resultado for uma falha.
ResultCategory - Indica o tipo do erro. Dependendo do contexto, o valor pode ser Success, ExpectedError, UnexpectedClientError, ou UnexpectedServerError

Importante

A funcionalidade descrita neste artigo está atualmente em visualização pública. Esta versão de pré-visualização é fornecida sem um contrato de nível de serviço e não a recomendamos para cargas de trabalho de produção. Algumas funcionalidades poderão não ser suportadas ou poderão ter capacidades limitadas. Para obter mais informações, veja Termos Suplementares de Utilização para Pré-visualizações do Microsoft Azure.

Códigos e subcódigos de chamada de Fim de Chamada dos Serviços de Comunicação do Azure

Existem diferentes explicações para o facto de uma chamada ter terminado. Aqui estão os significados do fim dos códigos de chamada e subcódigos que mostram como uma chamada pode terminar.

Subcódigo	Código	Mensagem (pré-visualização pública *)	Categorias de resultados (pré-visualização pública *)	Recomendações
0	0	Chamada encerrada com sucesso pelo participante local.	Com êxito
0	487	A chamada terminou com êxito quando o chamador cancelou a chamada.	Com êxito
0	603	A chamada terminou com sucesso, pois foi recusada pelo destinatário.	Com êxito
4097	0	Chamada encerrada para todos os usuários pelo organizador da reunião.	Com êxito
4507	495	A chamada terminou porque o aplicativo não fornecia um token válido dos Serviços de Comunicação do Azure.	UnexpectedClientError	- Certifique-se de que seu aplicativo implementa o mecanismo de atualização de token corretamente.
5000	0	A chamada terminou para este participante, uma vez que foi removida da conversa por outro participante.	Com êxito
5003	0	A chamada terminou com êxito, pois todos os pontos de extremidade do destinatário recusaram a chamada.	Com êxito
5300	0	A chamada terminou para este participante, uma vez que foi removida da conversa por outro participante.	Com êxito
7000	0	Chamada encerrada pela plataforma dos Serviços de Comunicação do Azure.	Com êxito
10003	487	A chamada foi aceita em outro lugar, por outro ponto de extremidade deste usuário.	Com êxito
10004	487	A chamada foi cancelada no tempo limite, nenhum ponto de extremidade do destinatário foi aceito a tempo. Certifique-se de que o usuário viu a notificação e tente iniciar essa chamada novamente.	ExpectedError
10024	487	A chamada terminou com êxito, pois foi recusada por todos os pontos de extremidade do destinatário.	Com êxito	- Tente fazer a chamada novamente.
301005	410	O participante foi removido da chamada pela infraestrutura dos Serviços de Comunicação do Azure devido à perda de conectividade de mídia com a infraestrutura dos Serviços de Comunicação do Azure, isso geralmente acontece se o participante sair da chamada abruptamente ou perder a conectividade de rede. Se o participante quiser continuar a chamada, ele deve se reconectar.	UnexpectedClientError	- Certifique-se de que você está usando o SDK mais recente em um ambiente suportado.
510403	403	A chamada terminou, pois foi marcada como spam e foi bloqueada.	ExpectedError	- Certifique-se de que o seu token de Serviços de Comunicação é válido e não expirou. - Certifique-se de passar em AlternateId nas opções de chamada.
540487	487	A chamada terminou com êxito quando o chamador cancelou a chamada.	Com êxito
560000	0	A chamada terminou com sucesso pelo participante remoto da PSTN.	Com êxito	Causas possíveis: - Usuário encerrou a chamada. - Chamada foi encerrada por agente de mídia.
560486	486	A chamada terminou porque o participante remoto da PSTN estava ocupado. O número chamado já estava em uma chamada ou tendo iss técnico

Códigos de erro e subcódigos do cliente SDK de chamada dos Serviços de Comunicação do Azure

Para erros de cliente, se a propriedade resultCategories for ExpectedError, o erro é esperado da perspetiva do SDK. Esses erros são comumente encontrados em falhas de pré-condição, como argumentos incorretos passados pelo aplicativo ou quando o estado atual do sistema não permite a chamada de API. O aplicativo deve verificar o motivo do erro e a lógica para invocar a API.

Subcódigo	Código	Mensagem	Categorias de resultados (pré-visualização pública *)	Recomendações
40101	408	Falha ao criar o CallAgent. Tente novamente, se o problema persistir, reúna os logs do console do navegador, . HAR e contacte o suporte dos Serviços de Comunicação do Azure.	UnexpectedClientError
40104	408	Falha ao criar o CallAgent. Tente novamente, se o problema persistir, reúna os logs do console do navegador, . HAR e contacte o suporte dos Serviços de Comunicação do Azure.	UnexpectedClientError
40114	408	Falha ao se conectar à infraestrutura dos Serviços de Comunicação do Azure. Tente novamente e verifique as solicitações de rede do navegador. Se as solicitações continuarem falhando, reúna os logs do console do navegador, . HAR e contacte o suporte dos Serviços de Comunicação do Azure.	UnexpectedClientError	Para obter mais informações, consulte Requisitos de rede para obter mais detalhes.
40115	412	Falha ao criar o CallAgent, não é possível inicializar a conexão com a infraestrutura dos Serviços de Comunicação do Azure. Tente novamente e verifique as solicitações de rede do navegador. Se as solicitações continuarem falhando, reúna os logs do console do navegador, . HAR e contacte o suporte dos Serviços de Comunicação do Azure.	UnexpectedClientError	Para obter mais informações, consulte Requisitos de rede para obter mais detalhes.
40216	500	Falha ao criar o CallAgent. Tente novamente, se o problema persistir, reúna os logs do console do navegador e entre em contato com o suporte dos Serviços de Comunicação do Azure.	UnexpectedClientError
40228	409	Falha ao criar o CallAgent, já existe uma instância do CallAgent associada a essa identidade. Descarte o CallAgent existente ou crie um novo com uma identidade diferente.	ExpectedError
40230	409	Falha ao criar TeamsCallAgent, uma instância de TeamsCallAgent associada a essa identidade já existe. Descarte o TeamsCallAgent existente antes de criar um novo.	ExpectedError
40606	405	Falha ao enumerar alto-falantes, não é suportado para enumerar/selecionar alto-falantes no Android Chrome, iOS Safari ou macOS Safari.	ExpectedError	A enumeração/seleção de alto-falantes não é compatível com Android Chrome, iOS Safari nem macOS Safari. O sistema operacional selecionará automaticamente o alto-falante (dispositivo de saída). Saiba mais sobre o gerenciamento de dispositivos e como melhor mitigar esses problemas.
40613	400	Falha ao obter permissão para uso de microfone e/ou câmera, foi negado ou falhou. Certifique-se de permitir as permissões nas configurações do navegador e do sistema operacional.	ExpectedError	Saiba mais sobre a melhor forma de lidar com as permissões do dispositivo.
40614	500	Falha ao pedir permissões do dispositivo Certifique-se de permitir as permissões nas configurações do navegador e nas configurações do sistema operacional e tente novamente. Se o problema persistir, reúna os logs do console do navegador e entre em contato com o suporte dos Serviços de Comunicação do Azure.	UnexpectedClientError	Saiba mais sobre a melhor forma de lidar com as permissões do dispositivo.
41006	400	Falha ao aceitar a chamada recebida, ela não está no estado de toque. Inscreva-se no evento 'incomingCall' do CallAgent para aceitar a chamada recebida.	ExpectedError	Consulte os seguintes artigos para identificar a causa raiz do problema - Receber uma chamada - Inscrever-se em eventos do SDK
41007	400	Falha ao rejeitar a chamada recebida, ela não está no estado de toque. Inscreva-se no evento 'incomingCall' do CallAgent para rejeitar a chamada recebida.	ExpectedError	Consulte os seguintes artigos para identificar a causa raiz do problema - Receber uma chamada - Inscrever-se em eventos do SDK
41015	500	Falha ao silenciar o microfone. Tente novamente, se o problema persistir, reúna os logs do console do navegador e entre em contato com o suporte dos Serviços de Comunicação do Azure.	UnexpectedClientError
41016	400	Falha ao desativar o som do microfone. Tente novamente, se o problema persistir, reúna os logs do console do navegador e entre em contato com o suporte dos Serviços de Comunicação do Azure.	UnexpectedClientError
41025	400	Falha ao iniciar o vídeo, a instância LocalVideoStream é inválida ou vazia. Passe em uma instância LocalVideoStream.	ExpectedError	Verifique se o objeto passado para iniciar o vídeo é uma instância de LocalVideoStream. Um LocalVideoStream é construído com um VideoDeviceInfo objeto ou um MediaStream objeto. Consulte os seguintes artigos para identificar a causa raiz do problema: - Fazer uma chamada com câmara de vídeo - Iniciar e parar o envio de vídeo local durante uma chamada - Aceda a vídeo raw
41027	400	Falha ao iniciar o vídeo, o vídeo já foi iniciado.	ExpectedError	Ligações úteis: - Fazer uma chamada com câmara de vídeo - Iniciar e parar o envio de vídeo local durante uma chamada
41030	400	Falha ao parar o vídeo, o vídeo já está parado.	ExpectedError	Ligações úteis: - Fazer uma chamada com câmara de vídeo - Iniciar e parar o envio de vídeo local durante uma chamada
41032	400	Falha ao parar vídeo, argumento inválido. LocalVideoStream usado como uma entrada não está sendo enviado no momento.	ExpectedError	O LocalVideoStream que está sendo enviado na chamada é armazenado na matriz Call.localVideoStreams[] e é do tipo 'Video' ou 'RawMedia'. Consulte os seguintes artigos para identificar a causa raiz do problema: - Fazer uma chamada com câmara de vídeo - Iniciar e parar o envio de vídeo local durante uma chamada - Aceda a vídeo raw
41033	500	Falha ao segurar a chamada. Tente novamente, se o problema persistir, reúna os logs do console do navegador e entre em contato com o suporte dos Serviços de Comunicação do Azure.	UnexpectedClientError
41034	500	Falha ao retomar a chamada. Tente novamente, se o problema persistir, reúna os logs do console do navegador e entre em contato com o suporte dos Serviços de Comunicação do Azure.	UnexpectedClientError
41035	400	Falha ao iniciar o compartilhamento de tela, o compartilhamento de tela já foi iniciado.	ExpectedError	Saiba mais sobre como iniciar e parar a partilha de ecrã durante uma chamada
41041	400	Falha ao parar o compartilhamento de tela, o compartilhamento de tela já está interrompido.	ExpectedError	Saiba mais sobre como iniciar e parar a partilha de ecrã durante uma chamada
41048	410	Falha ao iniciar o vídeo durante o processo de configuração da chamada. Certifique-se de permitir permissões de vídeo nas configurações do navegador e nas configurações do sistema operacional e certifique-se de que o dispositivo da câmera não está sendo usado por outro processo.	UnexpectedClientError	O dispositivo da câmera pode ser desativado no sistema. A câmera está sendo usada por outro processo.
41056	412	Falha ao iniciar ou ingressar na chamada, a política de voz do Teams Enterprise não está habilitada para este recurso dos Serviços de Comunicação do Azure. Siga o tutorial on-line para ativá-lo.	ExpectedError	Veja como habilitar usuários para o Enterprise Voice online e o Email de voz do sistema telefônico para habilitar a política de voz do Teams Enterprise
41071	412	Falha ao iniciar o compartilhamento de tela, a chamada não está no estado Conectado. Inscreva-se no evento 'statteChanged' da chamada para saber quando a chamada está conectada.	ExpectedError	Ligações úteis: - Verificar propriedades de chamada - Inscrever-se em eventos do SDK
41073	412	Falha ao obter ou definir MediaStream personalizado, essa funcionalidade está atualmente desabilitada pelos Serviços de Comunicação do Azure.	ExpectedError
43000	412	Falha ao iniciar o vídeo, o dispositivo de vídeo está sendo usado por outro processo / aplicativo. Impeça que a sua câmara seja utilizada no outro processo/aplicação e tente novamente.	ExpectedError	Entenda mais sobre a melhor forma de lidar com uma câmera sendo usada por outro processo
43001	403	Falha ao iniciar o vídeo, não foi concedida permissão para usar o dispositivo de vídeo selecionado. Verifique se as permissões do dispositivo de vídeo são permitidas nas configurações do navegador e nas configurações do sistema.	ExpectedError	Verifique se as permissões da câmera são permitidas nas configurações do navegador e nas configurações do sistema do dispositivo. Verifique se as câmeras não estão desativadas nas configurações do sistema do dispositivo. No macOS, verifique se a gravação de tela é permitida nas configurações do sistema. Ligações úteis: - Solicitar permissões de dispositivo- Permissões de compartilhamento de tela no macOS - Enumerar ou aceder a dispositivos para o Safari no macOS e iOS
43002	500	Falha ao iniciar o vídeo, erro desconhecido. Tente novamente. Se o problema persistir, contacte o suporte dos Serviços de Comunicação do Azure.	UnexpectedClientError
43004	400	Falha ao mudar de dispositivo de vídeo, entrada inválida. A entrada deve ser do tipo VideoDeviceInfo.	ExpectedError	Use o gerenciador de dispositivos para obter uma lista de objetos VideoDeviceInfo e, em seguida, use o objeto VideoDeviceInfo para alternar a origem. Saiba mais sobre como iniciar e parar o envio de vídeo local durante uma chamada
43005	400	Falha ao alternar o dispositivo de vídeo, não é possível alternar para o mesmo dispositivo de vídeo, ele já está selecionado.	ExpectedError
43013	412	Falha ao iniciar o vídeo, nenhum dispositivo de vídeo encontrado. Verifique se os dispositivos de vídeo estão conectados e ativados nas configurações do sistema.	ExpectedError	Certifique-se de que tem uma câmara ligada e instalada no seu dispositivo.
43014	412	Falha ao iniciar o vídeo, erro ao solicitar fluxo de mídia. Tente novamente, se o problema persistir, entre em contato com o suporte dos Serviços de Comunicação do Azure.	UnexpectedClientError
43015	412	Falha ao iniciar o vídeo, a solicitação de fluxo de mídia atingiu o tempo limite. Permita permissão no prompt do navegador para acessar a câmera e tente novamente.	ExpectedError	Este erro pode ocorrer se o usuário não executar uma ação no prompt de permissão do navegador para permitir o acesso à câmera.
43016	412	Falha ao iniciar o vídeo, permissões negadas pelo sistema. Verifique se as permissões do dispositivo de vídeo são permitidas nas configurações do navegador e nas configurações do sistema.	ExpectedError	Verifique se as permissões da câmera são permitidas nas configurações do navegador e nas configurações do sistema do dispositivo. Verifique se as câmeras não estão desativadas nas configurações do sistema do dispositivo. No macOS, verifique se a gravação de tela é permitida nas configurações do sistema. Ligações úteis - Solicitar permissões de dispositivo -Permissões de compartilhamento de tela no macOS - Enumerar ou aceder a dispositivos para o Safari no macOS e iOS
43017	412	Falha ao iniciar vídeo, fluxo não suportado. Tente novamente, se o problema persistir, entre em contato com o suporte dos Serviços de Comunicação do Azure.	UnexpectedClientError
43018	412	Falha ao iniciar o vídeo, falha ao definir restrições. Tente novamente, se o problema persistir, entre em contato com o suporte dos Serviços de Comunicação do Azure.	UnexpectedClientError	Saiba mais sobre como definir restrições de vídeo
43019	412	Falha ao iniciar o vídeo, nenhum dispositivo selecionado. Certifique-se de passar um LocalVideoStream construído com um VideoDeviceInfo e tente novamente. Se o problema persistir, contacte o suporte dos Serviços de Comunicação do Azure.	UnexpectedClientError	Ligações úteis: - Fazer uma chamada com câmara de vídeo - Iniciar e parar o envio de vídeo local durante uma chamada
43200	412	Falha ao renderizar fluxo de vídeo, esse fluxo não está disponível. Assine a propriedade isAvailable do fluxo para ser notificado quando o participante remoto tiver seu vídeo ativado e o fluxo estiver disponível para renderização.	ExpectedError	Ligações úteis: - Renderizar fluxos de vídeo/compartilhamento de tela de participantes remotos - Adicionar videochamadas 1:1 ao seu aplicativo - Inscrever-se em eventos do SDK
43202	404	Falha ao renderizar o fluxo de vídeo, esse fluxo não está mais disponível. O participante remoto desligou o vídeo.	ExpectedError	O participante remoto desligou o vídeo enquanto tentava criar uma visualização para ele.
43203	408	Falha ao renderizar o fluxo de vídeo, a renderização atingiu o tempo limite enquanto aguardava os quadros de vídeo. Tente novamente, se o problema persistir, entre em contato com o suporte dos Serviços de Comunicação do Azure.	UnexpectedClientError
43204	500	Falha ao renderizar fluxo de vídeo, falha ao assinar vídeo na infraestrutura dos Serviços de Comunicação do Azure. Tente novamente, se o problema persistir, entre em contato com o suporte dos Serviços de Comunicação do Azure.	UnexpectedClientError
43209	405	Falha ao renderizar fluxo de vídeo, VideoStreamRenderer foi descartado durante o processo de inicialização.	ExpectedError
43210	400	Falha ao descartar VideoStreamRenderer porque ele já está descartado.	ExpectedError
43220	400	Falha ao criar o modo de exibição, o número máximo de exibições ativas do RemoteVideoStream foi atingido. Você pode descartar um anterior para criar um novo.	ExpectedError	Saiba mais sobre como suportar corretamente o melhor número de fluxos de vídeo recebidos