Dépannage

Cette page vous 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, vérifiez les problèmes suivants:

URI du point de terminaison d'entrée 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 à un URI de point de terminaison d'entrée avec l'adresse IP et le STREAM-ID appropriés.

L'entrée n'est pas associée à une 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é à une chaîne.

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 été correctement associé au canal, obtenez les détails du canal et recherchez le nom du point de terminaison d'entrée dans le champ inputAttachments.

Chaîne inactive

Une erreur se produit si votre encodeur envoie un flux d'entrée à une chaîne qui n'est pas en cours d'exécution.

Pour résoudre ce problème, vérifiez l'état de la chaîne pour vous assurer que son streamingState est AWAITING_INPUT. Si la valeur streamingState de la chaîne est STOPPED, démarrez la chaîne.

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 le canal est déjà dans l'état STREAMING. Si c'est le cas, vous avez les options suivantes:

  • Créez un point de terminaison et un canal d'entrée 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 située 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és, 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 les 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, obtenez les informations sur la chaîne de votre diffusion en direct. Vérifiez dans le champ output.uri que l'URI du bucket Cloud Storage est correct.

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

Les fichiers de sortie peuvent être 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 H.264 et audio AAC.

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 du même projet Google Cloud qui héberge les ressources de l'API Live Stream. Les 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 d'autorisations suffisantes. La création de 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 du compte de service.

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

Pistes audio manquantes

Il est possible que des fichiers de sortie soient 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, obtenez les informations sur 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).