Résoudre les problèmes

Cette page explique comment résoudre les problèmes liés à l'API Live Stream. Les erreurs affichées sur cette page sont spécifiques à l'API Live Stream. Pour en savoir plus sur les erreurs génériques dans les API Google, consultez la page Erreurs des API Cloud.

Flux d'entrée refusé

Si votre encodeur envoie un flux d'entrée à un point de terminaison d'entrée, mais que la connexion est toujours refusée, recherchez les problèmes suivants:

URI du point de terminaison saisi non valide

Une erreur se produit si votre encodeur envoie un flux d'entrée à un URI de point de terminaison d'entrée non valide.

Pour résoudre ce problème, vérifiez si votre encodeur est configuré pour envoyer le flux d'entrée vers un URI de point de terminaison d'entrée avec l'adresse IP correcte et STREAM-ID.

L'entrée n'est associée à aucune chaîne

Une erreur se produit si votre encodeur envoie un flux d'entrée à un URI de point de terminaison d'entrée qui n'est pas associé à un canal.

Pour résoudre ce problème, créez un canal avec le point de terminaison d'entrée. Pour vérifier si un point de terminaison d'entrée a bien été associé au canal, obtenez les détails du canal et recherchez le nom du point de terminaison de l'entrée dans le champ inputAttachments.

Chaîne inactive

Une erreur se produit si votre encodeur envoie un flux d'entrée à un canal qui n'est pas exécuté.

Pour résoudre ce problème, vérifiez l'état de la chaîne et assurez-vous que sa streamingState est AWAITING_INPUT. Si l'streamingState de la chaîne est STOPPED, démarrez-la.

Un autre encodeur est déjà connecté au même point de terminaison d'entrée

Une erreur se produit si plusieurs encodeurs tentent d'envoyer des flux d'entrée au même point de terminaison d'entrée. Une seule connexion est acceptée à la fois par URI de point de terminaison d'entrée.

Pour résoudre ce problème, vérifiez si la chaîne est déjà à l'état STREAMING. Si tel est le cas, vous disposez des options suivantes:

  • Créez un point de terminaison d'entrée et un canal distincts pour le deuxième flux d'entrée.

  • Arrêtez le premier flux d'entrée avant d'en envoyer un autre au même point de terminaison d'entrée.

L'adresse IP de l'encodeur ne figure pas dans les plages d'adresses IP autorisées

Une erreur se produit si votre encodeur envoie un flux d'entrée à partir d'une adresse IP en dehors des plages d'adresses IP spécifiées configurées pour un point de terminaison d'entrée.

Pour résoudre ce problème, obtenez les détails d'un point de terminaison d'entrée et vérifiez le champ securityRules. Si des ipRanges sont spécifiées, assurez-vous que votre encodeur dispose d'une adresse IP valide dans ces plages d'adresses IP.

Fichiers de sortie manquants dans le bucket Cloud Storage

Si votre encodeur envoie correctement un flux d'entrée au point de terminaison d'entrée, mais qu'aucun fichier de sortie n'apparaît dans le bucket Cloud Storage, vérifiez la présence des problèmes suivants:

Bucket Cloud Storage incorrect

Les fichiers de sortie peuvent être manquants si vous vérifiez le mauvais bucket Cloud Storage.

Pour résoudre ce problème, accédez aux informations de la chaîne de votre diffusion en direct. Vérifiez que l'URI du bucket Cloud Storage est correct dans le champ output.uri.

Codecs vidéo/audio d'entrée non valides

Il se peut que des fichiers de sortie soient manquants si votre encodeur envoie des codecs vidéo ou audio non valides.

Pour résoudre ce problème, assurez-vous que votre encodeur n'envoie que des codecs vidéo et audio AAC H264.

Autorisation Cloud Storage refusée

Par défaut, l'API Live Stream crée un compte de service pouvant accéder aux buckets Cloud Storage dans le même projet Google Cloud qui héberge les ressources de l'API Live Stream. Des fichiers de sortie peuvent être manquants si ce compte de service perd l'autorisation d'accéder au bucket Cloud Storage.

Pour résoudre ce problème, assurez-vous que le compte de service dispose des autorisations suffisantes. La création des fichiers de sortie peut échouer pour les raisons suivantes:

  • Le bucket Cloud Storage de sortie se trouve dans un projet Google Cloud différent des ressources de l'API Live Stream telles que le canal et le point de terminaison d'entrée.

  • Les autorisations par défaut sont révoquées pour le compte de service.

Pour en savoir plus, consultez la page Accès à Cloud Storage.

Pistes audio manquantes

Les fichiers de sortie peuvent être manquants si votre encodeur envoie un flux d'entrée avec des pistes audio manquantes. Le pipeline vidéo attend que toutes les pistes audio arrivent avant de commencer le traitement.

Pour résoudre ce problème, accédez aux informations de la chaîne de votre diffusion en direct. Assurez-vous que votre encodeur envoie toutes les pistes audio configurées dans le champ ElementaryStream.audioStream.mapping (AudioMapping).