Partager via


Présentation des codes appelants et des erreurs de sous-codes

Le Kit de développement logiciel (SDK) Appelant et l’infrastructure de serveur respective utilisent une infrastructure unifiée pour représenter les erreurs. En utilisant des codes d’erreur, des sous-codes et leurs catégories de résultats correspondantes, en tant que développeur, vous pouvez plus facilement comprendre ces erreurs et trouver des explications sur la raison pour laquelle ils se sont produits et comment atténuer à l’avenir. Les détails sur les résultats d’erreur peuvent être consultés comme suit :

Code Sont modélisés sous forme d’entiers à 3 chiffres qui indiquent l’état de réponse d’une réponse cliente ou serveur. Ils sont regroupés dans :

  • Réponses réussies (200-299)
  • Erreur du client (400-499)
  • Erreur du serveur (500-599)

Sous-code Sont définis en tant qu’entier, où chaque nombre indique une raison unique, spécifique à un groupe de scénarios ou à un résultat de scénario spécifique.
Message Décrit le résultat et fournit des conseils sur la façon d’atténuer le problème si un résultat est un échec.
ResultCategory : indique le type de l’erreur. Selon le contexte, la valeur peut être Success, ExpectedError, UnexpectedClientError ou UnexpectedServerError

Important

Les fonctionnalités décrites dans cet article sont actuellement en préversion publique. Cette préversion est fournie sans contrat de niveau de service et n’est pas recommandée pour les charges de travail de production. Certaines fonctionnalités peuvent être limitées ou non prises en charge. Pour plus d’informations, consultez Conditions d’Utilisation Supplémentaires relatives aux Évaluations Microsoft Azure.

Codes d’erreur et sous-codes de fin d’appel Azure Communication Services

Il existe plusieurs explications quant à la raison pour laquelle un appel a pris fin. Voici les significations des codes et sous-codes de fin d’appel montrant la façon dont un appel a pris fin.

Sous-code Code Message (préversion publique *) Catégories de résultats (préversion publique *) Conseils
0 0 L’appel s’est terminé avec succès par le participant local. Succès
0 487 L’appel s’est terminé avec succès, car l’appelant a annulé l’appel. Succès
0 603 L’appel s’est terminé correctement, car il a été refusé de l’appelé. Réussite
4097 0 Appel terminé pour tous les utilisateurs par l’organisateur de la réunion. Réussite
4507 495 L’appel s’est terminé car l’application n’a pas fourni de jeton Azure Communication Services valide. UnexpectedClientError - Vérifiez que votre application implémente correctement le mécanisme d’actualisation des jetons.
5 000 0 L’appel s’est terminé pour ce participant, car il a été supprimé de la conversation par un autre participant. Réussite
5003 0 L’appel s’est terminé avec succès, car tous les points de terminaison appelés ont refusé l’appel. Réussite
5300 0 L’appel s’est terminé pour ce participant, car il a été supprimé de la conversation par un autre participant. Réussite
7000 0 Appel terminé par la plateforme Azure Communication Services. Réussite
10003 487 L’appel a été accepté ailleurs, par un autre point de terminaison de cet utilisateur. Réussite
10004 487 L’appel a été annulé lors du délai d’attente, aucun point de terminaison appelé n’a été accepté à l’heure. Vérifiez que l’utilisateur a vu la notification et essayez de lancer cet appel à nouveau. ExpectedError
10024 487 L’appel s’est terminé correctement, car il a été refusé par tout point de terminaison appelé. Réussite - Essayez à nouveau de passer l'appel.
301005 410 Le participant a été supprimé de l’appel par l’infrastructure Azure Communication Services en raison de la perte de connectivité multimédia avec l’infrastructure Azure Communication Services, cela se produit généralement si le participant quitte l’appel brusquement ou perd la connectivité réseau. Si le participant souhaite poursuivre l’appel, il doit se reconnecter. UnexpectedClientError - Vérifiez que vous utilisez le kit SDK le plus récent dans un environnement pris en charge.
510403 403 L’appel s’est terminé, car il a été marqué comme un courrier indésirable et a été bloqué. ExpectedError - Vérifiez que votre jeton Communication Services est valide et n’a pas expiré.
- Veillez à passer AlternateId dans les options d’appel.
540487 487 L’appel s’est terminé avec succès, car l’appelant a annulé l’appel. Réussite
560000 0 L'appel s'est terminé avec succès par le participant PSTN distant. Réussite Causes possibles :
- L’utilisateur a terminé l’appel.
- L’appel a été terminé par l’agent multimédia.
560486 486 L'appel a pris fin car le participant PSTN distant était occupé. Le numéro appelé était déjà dans en communication ou avait des problèmes techniques.

Codes d’erreur et sous-codes du client du Kit de développement logiciel (SDK) Appel d’Azure Communication Services

Pour les erreurs client, si la propriété resultCategories est ExpectedError, l'erreur est attendue du point de vue du SDK. Ces erreurs sont généralement rencontrées dans les échecs de condition préalable, tels que les arguments incorrects passés par l’application, ou lorsque l’état système actuel n’autorise pas l’appel d’API. L’application doit vérifier la raison de l’erreur et la logique d’appel de l’API.

Sous-code Code Message Catégories de résultats (préversion publique *) Conseils
40101 408 Échec de la création de CallAgent. Réessayez. Si le problème persiste, réunissez les journaux de la console du navigateur, le fichier .HAR, et contactez le support Azure Communication Services. UnexpectedClientError
40104 408 Échec de la création de CallAgent. Réessayez. Si le problème persiste, réunissez les journaux de la console du navigateur, le fichier .HAR, et contactez le support Azure Communication Services. UnexpectedClientError
40114 408 Échec de la connexion à l’infrastructure Azure Communication Services. Réessayez et vérifiez les demandes réseau du navigateur. Si les demandes continuent d’échouer, réunissez les journaux de la console du navigateur, le fichier HAR et contactez le support Azure Communication Services. UnexpectedClientError Pour obtenir plus de détails, consultez Configuration réseau requise.
40115 412 Échec de la création de CallAgent, impossible d’initialiser la connexion à l’infrastructure Azure Communication Services. Réessayez et vérifiez les demandes réseau du navigateur. Si les demandes continuent d’échouer, réunissez les journaux de la console du navigateur, le fichier HAR et contactez le support Azure Communication Services. UnexpectedClientError Pour obtenir plus de détails, consultez Configuration réseau requise.
40216 500 Échec de la création de CallAgent. Réessayez. Si le problème persiste, réunissez les journaux de la console du navigateur et contactez le support Azure Communication Services. UnexpectedClientError
40228 409 Impossible de créer CallAgent, une instance de CallAgent associée à cette identité existe déjà. Supprimez l’élément CallAgent existant, ou créez-en un avec une identité différente. ExpectedError
40230 409 Impossible de créer TeamsCallAgent, une instance de TeamsCallAgent associée à cette identité existe déjà. Supprimez l’objet TeamsCallAgent existant avant d’en créer un nouveau. ExpectedError
40606 405 Échec de l’énumération des haut-parleurs, l’énumération et la sélection de haut-parleurs n’est pas prise en charge sur Android Chrome, iOS Safari et macOS Safari. ExpectedError L’énumération/sélection d’intervenants n’est pas prise en charge sur Android Chrome, iOS Safari et macOS Safari. Le système d’exploitation sélectionne automatiquement l’orateur (périphérique de sortie).

Découvrez-en davantage sur la gestion des appareils et sur la meilleure façon d’atténuer ces problèmes.
40613 400 Échec de l’obtention de l’autorisation pour l’utilisation du microphone et/ou de la caméra. Elle a été refusée ou elle a échoué. Veillez à accorder les autorisations dans les paramètres du navigateur et dans les paramètres du système d’exploitation. ExpectedError Découvrez-en davantage sur la gestion optimale des autorisations d’appareil.
40614 500 Échec de la demande d’autorisations d’appareil. Vérifiez que vous avez accordé les autorisations dans les paramètres du navigateur et dans les paramètres du système d’exploitation, puis réessayez. Si le problème persiste, réunissez les journaux de la console du navigateur et contactez le support Azure Communication Services. UnexpectedClientError Découvrez-en davantage sur la gestion optimale des autorisations d’appareil.
41006 400 Échec de l’acceptation de l’appel entrant, il n’est pas dans l’état Sonnerie. Abonnez-vous à l’événement « incomingCall » de CallAgent pour accepter l’appel entrant. ExpectedError Consultez les articles suivants pour identifier la cause racine du problème
- Recevoir un appel entrant
- S’abonner aux événements SDK
41007 400 Échec du rejet de l’appel entrant, il n’est pas dans l’état Sonnerie. Abonnez-vous à l’événement « incomingCall » de CallAgent pour rejeter l’appel entrant. ExpectedError Consultez les articles suivants pour identifier la cause racine du problème
- Recevoir un appel entrant
- S’abonner aux événements SDK
41015 500 Impossible de désactiver le microphone. Réessayez. Si le problème persiste, réunissez les journaux de la console du navigateur et contactez le support Azure Communication Services. UnexpectedClientError
41016 400 Échec de l’activation du microphone. Réessayez. Si le problème persiste, réunissez les journaux de la console du navigateur et contactez le support Azure Communication Services. UnexpectedClientError
41025 400 Échec du démarrage de la vidéo, l’instance LocalVideoStream est invalide ou vide. Transmettez une instance LocalVideoStream. ExpectedError Vérifiez que l’objet passé pour démarrer la vidéo est une instance de LocalVideoStream.
Un LocalVideoStream est construit d’un objet VideoDeviceInfo ou MediaStream.

Consultez les articles suivants pour identifier la cause racine du problème :
- Passer un appel avec une caméra vidéo
- Démarrer et arrêter l’envoi d’une vidéo locale pendant un appel
- Accéder aux vidéos brutes
41027 400 Échec du démarrage de la vidéo, la vidéo est déjà lancée. ExpectedError Liens utiles :
- Passer un appel avec une caméra vidéo
- Démarrer et arrêter l’envoi d’une vidéo locale pendant un appel
41030 400 Échec de l’arrêt de la vidéo, la vidéo est déjà arrêtée. ExpectedError Liens utiles :
- Passer un appel avec une caméra vidéo
- Démarrer et arrêter l’envoi d’une vidéo locale pendant un appel
41032 400 Échec de l’arrêt de la vidéo, argument non valide. Le LocalVideoStream utilisé comme entrée n’est pas en cours d’envoi. ExpectedError LocalVideoStream qui est envoyé dans l’appel, est stocké dans le tableau Call.localVideoStreams[] et est de type « Video » ou « RawMedia ».
Consultez les articles suivants pour identifier la cause racine du problème :
- Passer un appel avec une caméra vidéo
- Démarrer et arrêter l’envoi d’une vidéo locale pendant un appel
- Accéder aux vidéos brutes
41033 500 Échec de la mise en suspens de l’appel. Réessayez. Si le problème persiste, réunissez les journaux de la console du navigateur et contactez le support Azure Communication Services. UnexpectedClientError
41034 500 Échec de la reprise de l’appel. Réessayez. Si le problème persiste, réunissez les journaux de la console du navigateur et contactez le support Azure Communication Services. UnexpectedClientError
41035 400 Échec du démarrage du partage d’écran. Le partage d’écran est déjà lancé. ExpectedError En savoir plus sur comment démarrer et arrêter le partage d’écran lors d’un appel
41041 400 Échec de l’arrêt du partage d’écran, le partage d’écran est déjà arrêté. ExpectedError En savoir plus sur comment démarrer et arrêter le partage d’écran lors d’un appel
41048 410 Échec du démarrage de la vidéo pendant le processus de configuration des appels. Veillez à accorder les autorisations vidéo dans les paramètres du navigateur et dans les paramètres du système d’exploitation, et vérifiez que la caméra n’est pas utilisée par un autre processus. UnexpectedClientError La caméra peut être désactivée dans le système.
La caméra est utilisée par un autre processus.

41056 412 Échec du démarrage ou de la jonction à l’appel, la stratégie de voix Entreprise Teams n’est pas activée pour cette ressource Azure Communication Services. Suivez le didacticiel en ligne pour l’activer. ExpectedError Consultez Comment activer Voix Entreprise en ligne et la messagerie vocale de système téléphonique pour les utilisateurs pour activer la stratégie de voix Entreprise Teams
41071 412 Échec du démarrage du partage d’écran, l’appel n’est pas dans l’état Connecté. Abonnez-vous à l’événement « statteChanged » de l’appel pour savoir quand l’appel est connecté. ExpectedError Liens utiles :
- Vérifier les propriétés de l’appel
- S’abonner aux événements SDK
41073 412 Échec de l’obtention ou de la définition de MediaStream personnalisé, cette fonctionnalité est actuellement désactivée par Azure Communication Services. ExpectedError
43000 412 Échec du démarrage de la vidéo, l’appareil vidéo est utilisé par un autre processus ou une autre application. Arrêtez l’utilisation de votre caméra dans l’autre processus ou application, puis réessayez. ExpectedError Découvrez plus en détail comment mieux gérer une caméra utilisée par un autre processus
43001 403 Impossible de démarrer la vidéo, l’autorisation pour utiliser l’appareil vidéo sélectionné n’a pas été accordée. Vérifiez que les autorisations d’appareil vidéo sont autorisées dans les paramètres du navigateur et dans les paramètres du système. ExpectedError Vérifiez que les autorisations de caméra sont autorisées dans les paramètres du navigateur et les paramètres système de l’appareil.
Vérifiez que les caméras ne sont pas désactivées dans les paramètres système de l’appareil.
Sur macOS, vérifiez que l’enregistrement de l’écran est autorisé à partir des paramètres système.

Liens utiles :
- Demander des autorisations d’appareil-
Autorisations de partage d’écran sur macOS
- Accès aux appareils ou énumération de ces appareils pour Safari sur macOS et iOS
43002 500 Échec du démarrage de la vidéo, erreur inconnue. Réessayez. Si le problème persiste, contactez le support Azure Communication Services. UnexpectedClientError
43004 400 Échec du changement d’appareil vidéo, entrée non valide. L’entrée doit être de type VideoDeviceInfo. ExpectedError Utilisez le gestionnaire d’appareils pour obtenir la liste des objets VideoDeviceInfo, puis utilisez l’objet VideoDeviceInfo pour changer la source.

En savoir plus sur comment démarrer et arrêter l’envoi d’une vidéo locale pendant un appel
43005 400 Échec du basculement d’appareil vidéo, impossible de basculer vers le même appareil vidéo, il est déjà sélectionné. ExpectedError
43013 412 Échec du démarrage de la vidéo, aucun appareil vidéo n’a été trouvé. Vérifiez que les appareils vidéo sont branchés et activés dans les paramètres système. ExpectedError Vérifiez que vous disposez d’une caméra connectée et installée sur votre appareil.

43014 412 Échec du démarrage de la vidéo, erreur demandant le flux multimédia. Réessayez. Si le problème persiste, contactez le support Azure Communication Services. UnexpectedClientError
43015 412 Échec du démarrage de la vidéo, la demande de flux multimédia a expiré. Accordez l’autorisation sur l’invite du navigateur à accéder à la caméra, puis réessayez. ExpectedError Cette erreur peut se produire si l’utilisateur n’agit pas sur l’invite d’autorisation du navigateur pour autoriser l’accès à la caméra.

43016 412 Échec du démarrage de la vidéo, autorisations refusées par le système. Vérifiez que les autorisations d’appareil vidéo sont autorisées dans les paramètres du navigateur et dans les paramètres du système. ExpectedError Vérifiez que les autorisations de caméra sont autorisées dans les paramètres du navigateur et les paramètres système de l’appareil.
Vérifiez que les caméras ne sont pas désactivées dans les paramètres système de l’appareil.
Sur macOS, vérifiez que l’enregistrement de l’écran est autorisé à partir des paramètres système.

Liens utiles
- Demander des autorisations d’appareil
-Autorisations de partage d’écran sur macOS
- Accès aux appareils ou énumération de ces appareils pour Safari sur macOS et iOS
43017 412 Échec du démarrage de la vidéo, flux non pris en charge. Réessayez. Si le problème persiste, contactez le support Azure Communication Services. UnexpectedClientError
43018 412 Échec du démarrage de la vidéo, impossible de définir des contraintes. Réessayez. Si le problème persiste, contactez le support Azure Communication Services. UnexpectedClientError En savoir plus sur comment définir des contraintes vidéo
43019 412 Échec du démarrage de la vidéo, aucun appareil n’est sélectionné. Veillez à transmettre un LocalVideoStream construit avec un VideoDeviceInfo, puis réessayez. Si le problème persiste, contactez le support Azure Communication Services. UnexpectedClientError Liens utiles :
- Passer un appel avec une caméra vidéo
- Démarrer et arrêter l’envoi d’une vidéo locale pendant un appel
43200 412 Échec du rendu du flux vidéo, ce flux n’est pas disponible. Abonnez-vous à la propriété isAvailable du flux pour être averti lorsque le participant distant dispose de sa vidéo et que le flux est disponible pour le rendu. ExpectedError Liens utiles :
- Afficher les flux de partage de partage d’écran ou de vidéo de participants distants
- Ajouter l’appel vidéo 1:1 à votre application
- S’abonner aux événements SDK
43202 404 Échec du rendu du flux vidéo, ce flux n’est plus disponible. Le participant distant a désactivé sa vidéo. ExpectedError Le participant distant a désactivé sa vidéo lors de sa tentative de création d’un affichage.

43203 408 Échec du rendu du flux vidéo, le rendu a expiré lors de l’attente d’images vidéo. Réessayez. Si le problème persiste, contactez le support Azure Communication Services. UnexpectedClientError
43204 500 Échec du rendu du flux vidéo, échec de l’abonnement à la vidéo dans l’infrastructure Azure Communication Services. Réessayez. Si le problème persiste, contactez le support Azure Communication Services. UnexpectedClientError
43209 405 Échec du rendu du flux vidéo, VideoStreamRenderer a été supprimé pendant le processus d’initialisation. ExpectedError
43210 400 Échec de la suppression de VideoStreamRenderer, car il est déjà supprimé. ExpectedError
43220 400 Impossible de créer l’affichage, car le nombre maximal de 10 RemoteVideoStream actifs a été atteint. Vous pouvez en supprimer un ancien pour en créer un. ExpectedError En savoir plus sur comment prendre en charge correctement le meilleur nombre de flux vidéo entrants