Résoudre les problèmes de Media Services

  • Article

Logo de Media Services v3

Avertissement

Azure Media Services sera mis hors service le 30 juin 2024. Pour plus d’informations, consultez le Guide de mise hors service AMS.

Recherchez les causes et les solutions aux problèmes liés à Media Services.

Notes

De nombreux problèmes peuvent être résolus en migrant vers l’API Media Services v3 ou en lisant le Guide des meilleures pratiques de streaming en direct.

Problèmes liés au compte

Cause Solution
Vous tentez peut-être d’utiliser les fonctionnalités de l’API v3 avec un compte v2 ou une implémentation de l’API v2. Mettez à jour votre code pour utiliser l’API v3. Pour obtenir une assistance plus détaillée, consultez le Guide de migration.

Problèmes courants de lecture des vidéos

  • La lecture des vidéos démarre au bout d’un temps trop long.
  • Les vidéos sont floues au démarrage.
  • La qualité des vidéos est faible.
  • La vidéo n’est pas lue ou montre un écran noir.
Cause Solution
Vous tentez peut-être d’atteindre une audience étendue sans utiliser un CDN, ce qui provoque des problèmes de latence. Ajoutez un CDN à votre localisateur de streaming. Pour plus d’informations sur l’utilisation d’un CDN, consultez Diffuser du contenu avec l’intégration d’un CDN.
Vous n’avez peut-être pas implémenté l’empaquetage dynamique. Pour plus d’informations sur l’implémentation de l’empaquetage dynamique, consultez Empaquetage dynamique dans Media Services v3.
Vous pouvez avoir des « voisins bruyants », ce qui signifie que vous partagez des ressources de calcul avec d’autres clients. Pour éviter les « voisins bruyants », effectuez une mise à niveau d’un point de terminaison de streaming Standard vers un point de terminaison de streaming Premium avec des unités de streaming dédiées.
Vous utilisez peut-être un navigateur plus ancien pour visualiser les vidéos. Mettez à niveau votre navigateur.
Vous utilisez peut-être un lecteur et des filtres de tiers. Ajoutez audio-only=false à l’URL de streaming, comme suit : https://streamingtest.streaming.media.azure.net/00000000-0000-0000-0000-000000000000/sample.ism/manifest(format-m3u8-aapl,audio-only=false)

Vous ne pouvez pas lire un fichier MP4 à partir de la ressource

Cause Solution
Azure Media Services est conçu pour utiliser un fichier manifeste au lieu de lire directement des flux MP4 en taille maximale. Le fichier manifeste indique au lecteur les fragments multimédias encodés à lire et dans quel ordre. Utilisez un des encodeurs multimédias fournis pour créer des fragments multimédias et un fichier manifeste. Pour plus d’informations sur l’encodage, consultez Encodage prenant en compte le contenu et Encoder avec une échelle de débit binaire générée automatiquement.
Le nom du fichier contient des caractères réservés. Supprimez les caractères réservés du nom du fichier.

Caractères réservés

  • Media Services utilise la valeur du nom de fichier de ressource pour générer des URL pour la diffusion de contenu en continu. Pour cette raison, l’encodage par pourcentage n’est pas autorisé. La valeur de la propriété name ne peut avoir aucun des caractères réservés à l’encodage en pourcentage suivants : !*'() ;:@&=+$,/ ?%#[] ». En outre, il ne peut exister qu’un ’.’ pour l’extension de nom de fichier.
  • La longueur du nom ne doit pas dépasser 260 caractères.

Le contenu chiffré n’est pas lu en mode hors connexion.

Cause Solution
Le lecteur que vous utilisez pour lire les vidéos chiffrées AES téléchargées en mode hors connexion sur les appareils iOS gère la façon dont ces vidéos sont lues. La cause n’est pas liée à Media Services. Passez en revue la documentation du lecteur vidéo hors connexion que vous avez choisi.

L’audio n’est pas synchronisée.

Cause Solution
Les paquets vidéo sont délivrés avec retard. Solutions possibles :

1. Vous avez peut-être implémenté une stratégie de contrôle de version du stockage qui a été activée automatiquement, ce qui entraîne la mise en mémoire tampon et la déconnexion. Supprimez la stratégie et désactivez le contrôle de version automatique du stockage.
2. Activez un CDN.
3. Utilisez un point de terminaison de streaming Premium avec suffisamment d’unités réservées.

La demande du lecteur pour le fichier VTT a provoqué des erreurs CORS.

Cause Solution
Configuration des règles CORS Configurez des règles CORS pour votre compte de stockage ou votre CDN.

Vous pouvez aussi obtenir l’URL de téléchargement du fichier VTT auprès de la ressource.

Un point de terminaison de streaming ne démarre pas.

Cause Solution
Vous avez peut-être créé une stratégie personnalisée qui active seulement HTTPS. Ceci n’est actuellement pas pris en charge par Media Services. Solutions de contournement possibles :
1. Dans le Portail Azure, désactivez votre stratégie personnalisée.
2. Créez un point de terminaison de streaming avec un CDN activé et désactivez HTTP pour le point de terminaison du CDN.
Ou
1. N’activez pas le CDN pour le point de terminaison de streaming avec le portail ou l’API.
2. Au lieu de cela, accédez à la page Azure CDN dans le portail Azure ou utilisez l’API Azure CDN pour créer un point de terminaison qui pointe vers le point de terminaison Media Services, en définissant l’origine du point de terminaison du CDN sur le nom d’hôte du point de terminaison de streaming.
Vous avez peut-être arrêté un point de terminaison de streaming avec un CDN. Consultez Un point de terminaison de streaming ne s’arrête pas

Un point de terminaison de streaming avec un CDN ne s’arrête pas.

Cause Solution
Quand vous activez le CDN pour n’importe quel point de terminaison de streaming, le point de terminaison du CDN ne sera créé qu’après le démarrage du point de terminaison de streaming. La raison en est que pendant le processus de démarrage, notre plateforme va créer les points de terminaison du CDN et les lier au point de terminaison de streaming (y compris la configuration du nom d’hôte personnalisé).

Pendant le processus d’arrêt du point de terminaison de streaming, notre plateforme doit supprimer le point de terminaison du CDN. Par conséquent, si le point de terminaison de streaming est dans un état d’arrêt, le point de terminaison du CDN n’existe pas ni ne pointe vers le point de terminaison de streaming.

Cependant, dans certains scénarios, quand AMS appelle le CDN pour supprimer les points de terminaison du CDN, il ne parvient pas à supprimer les points de terminaison en raison de caches sur le CDN. Ceci entraîne un problème de conflit de nom d’hôte si le point de terminaison du CDN est toujours là et déclenche le problème d’arrêt du point de terminaison de streaming.		 Supprimez manuellement le profil CDN, puis supprimez le point de terminaison de streaming et configurez-en un nouveau.

Les points de terminaison de streaming n’apparaissent pas après le déplacement du compte vers un autre abonnement.

Cause Solution
Il faut un certain temps pour que les points de terminaison de streaming soient déplacés vers le nouvel abonnement. Attendez 2 heures et vérifiez que vos points de terminaison de streaming apparaissent dans le nouvel abonnement.

L’encodeur local n’envoie pas de données à l’événement en direct.

Cause Solution
Vous utilisez peut-être un encodeur qui n’a pas été testé avec Media Services. Consultez Encodeurs de streaming en direct locaux vérifiés.
L’encodeur local n’est peut-être pas configuré correctement. Vérifiez que vous avez correctement configuré l’encodeur local.

L’encodage semble prendre beaucoup de temps.

La plupart des problèmes de durée d’encodage peuvent être résolus en configurant les paramètres de l’encodeur de façon à contrôler l’équilibre entre la vitesse et la qualité. Pour un encodage plus rapide, définissez-le en mode vitesse.

Cause Solution
Le fichier mezzanine peut être très grand. La taille du fichier est égale au débit binaire multiplié par la durée. None
Il existe un nombre élevé de couches de sortie. Réduisez le nombre de couches de sortie.
Les couches de sortie ont une haute résolution. Réduisez la résolution de la couche de sortie au débit binaire que vous prévoyez pour diffuser le média.
Le fichier mezzanine peut être complexe, en particulier si vous encodez un fichier en résolution 4k. None

Échecs de transformation

Cause Solution
Vous avez peut-être dépassé le quota de transformations par compte, qui est de 100. Supprimez les transformations inutilisées.

Impossible de charger le média

Vous ne pouvez pas charger le média sur un compte de stockage.

Cause Solution
Vous tentez d’utiliser HTTP. utiliser le protocole HTTPS ; Le protocole HTTP n’est plus pris en charge pour le chargement de contenu.
Vous n’attendez pas suffisamment longtemps pour que le compte de stockage soit déployé. Si vous avez créé le compte de stockage par programmation, ajoutez du code pour tester que le compte de stockage est déployé avant de tenter de charger un média.

Problèmes CORS

Cause Solution
Si vous tentez d’utiliser des demandes préalables contenant des en-têtes traceparent, vous recevrez des erreurs CORS. Pour l’instant, Media Services ne prend pas en charge les demandes préalables. Nous avons conscience que les demandes préalables sont appréciées par nos clients. N’utilisez pas les demandes préalables tant que la fonctionnalité n’est pas disponible.

Problèmes de connexion au compte de stockage

État Déconnecté

L’état « Déconnecté » pour un compte Media Services indique que ce compte n’a plus accès à un ou plusieurs des comptes de stockage attachés en raison d’un changement dans les clés d’accès du stockage. Des clés d’accès du stockage à jour sont nécessaires à Media Services pour effectuer de nombreuses tâches dans le compte.

Voici les principaux scénarios qui aboutissent à un compte Media Services n’ayant pas accès aux comptes de stockage attachés.

Cause Solution
Le compte Media Services ou un ou plusieurs comptes de stockage attachés ont été migrés vers des abonnements distincts. Migrez le ou les comptes de stockage, ou le compte Media Services, afin qu’ils soient tous dans le même abonnement, ou utilisez l’identité managée pour l’authentification du compte de stockage si votre compte de stockage se trouve dans le même locataire.
Le compte Media Services utilise un compte de stockage attaché dans un abonnement différent car il s’agissait d’un ancien compte Media Services où ceci était pris en charge. Tous les anciens comptes Media Services ont été convertis en comptes modernes basés sur Azure Resource Manager et ont un état Déconnecté. Migrez le compte de stockage ou le compte Media Services afin qu’ils soient tous dans le même abonnement, ou utilisez l’identité managée pour l’authentification du compte de stockage si votre compte de stockage se trouve dans le même locataire.

Le compte Media Services ne peut pas accéder au compte de stockage

Cause Solution
L’identité managée Media Services n’a pas été attribuée au rôle Contributeur aux données Blob du stockage. Pour le vérifier dans le Portail Azure, déterminez tout d’abord l’identité définie pour le compte de stockage en sélectionnant « Comptes de stockage » dans le menu du compte Media Services. Il doit s’agir de « Affectée par le système » ou du nom d’une identité managée affectée par l’utilisateur. Accédez ensuite au compte de stockage dans le portail, sélectionnez « Contrôle d'accès (IAM) » dans le menu, sélectionnez « Attributions de rôles » dans la barre d’outils, puis ajoutez l’attribution de rôle. Lorsque vous ajoutez l’attribution de rôle, le rôle doit être défini sur « Contributeur aux données Blob du stockage » et les membres doivent être définis sur l’identité managée utilisée par le compte Media Services pour accéder au compte de stockage. Après avoir ajouté l’attribution de rôle, l’application de la modification peut prendre quelques minutes.

Azure Media Indexer 2 n’est pas retourné dans la liste des processeurs multimédias.

Cause Solution
Azure Media Indexer 2 a été déprécié le 1er janvier 2020. Migrez vers l’API Media Services v3.

Une erreur réseau a entraîné l’échec du téléchargement de la vidéo.

Cause Solution
Cette erreur est généralement le résultat de problèmes de connexion réseau côté client et non pas avec Media Services. Contactez votre administrateur réseau, ou utilisez Fiddler ou le débogage du navigateur avec F12 pour voir l’erreur sous-jacente.

Problèmes de téléchargement

Vous avez peut-être reçu le message d’erreur suivant :

« Lors de la tentative de téléchargement des fichiers d’entrée, les fichiers n’étaient pas accessibles, vérifiez la disponibilité de la source »

Cause Solution
Si vous utilisez un jeton SAS pour accéder au fichier, il peut avoir expiré. Ajustez votre code pour vérifier que le jeton n’a pas expiré avant de l’utiliser pour l’authentification.

Erreurs 5xx excessives et intermittentes

Cause Solution
L’encodage local peut avoir été implémenté incorrectement. Vérifiez que votre encodeur est configuré correctement.
Vous utilisez peut-être un encodeur local non testé Utilisez un encodeur local testé et vérifiez qu’il est correctement configuré.
Le ratio de mise en cache entre le point de terminaison de streaming et le CDN est peut-être insuffisant. 1. Ajustez le ratio de mise en cache afin que le CDN puisse gérer davantage de trafic.
2. Ajustez la règle d’optimisation du streaming pour le CDN.
La configuration du filtre est peut-être incorrecte. Vérifiez que vos filtres sont configurés correctement.

Consultez le Guide des bonnes pratiques de streaming en direct.

Erreurs de code générales

Vous pouvez rencontrer des erreurs dans votre code qui ne sont pas couvertes par des codes d’erreur de point de terminaison de streaming, des codes d’erreur d’événement en direct ou des références de codes d’erreur de travail.

Cause Solution
Vous tentez peut-être d’utiliser un objet, une propriété ou une méthode qui ne sont pas inclus dans une version antérieure de l’API. Mettez à niveau votre bibliothèque d’API dans votre environnement de développement.

Si vous n’avez pas trouvé la solution à votre problème, contactez le Support technique de Media Services.

Obtenir de l’aide et du support

Vous pouvez contacter Media Services pour vous poser des questions ou suivre nos mises à jour en suivant l’une des méthodes suivantes :