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 |
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour