Configuration Issues for LiveStream Resources

Dans une ressource liveStream, l'objet status.healthStatus.configurationIssues[] contient la liste des problèmes de configuration affectant le flux. Ces informations vous permettent d'identifier, de diagnostiquer et de résoudre les problèmes qui affectent la qualité de vos flux vidéo en direct.

Ce document répertorie les types de problèmes de configuration qui peuvent être référencés dans une réponse de l'API. Chaque problème est associé au type de problème, à une brève description de l'erreur et à une description plus longue qui contient souvent des informations expliquant comment la corriger.

Problèmes de configuration

Le tableau ci-dessous liste les problèmes de configuration pouvant affecter les flux vidéo en direct. La colonne de gauche identifie le type de problème et la colonne de droite fournit des informations supplémentaires sur la façon de le résoudre.

Sachez que certaines descriptions contiennent des variables qui sont renseignées pour refléter les données de votre diffusion en direct. Dans les descriptions ci-dessous, du texte de style <code>, tel que %(actual_gop).1f, identifie une partie d'un message d'erreur personnalisé pour chaque diffusion en direct. Votre code doit correspondre aux types de problèmes indiqués dans la colonne de gauche.

Problèmes de configuration
audioBitrateHigh
Explication :Vérifiez les paramètres audio.
Description:Le débit actuel du flux audio (%(actual)) est supérieur au débit recommandé. Nous vous recommandons d'utiliser un débit audio de %(expected)s.
audioBitrateLow
Explication :Vérifiez les paramètres audio.
Description:Le débit actuel du flux audio (%(actual)s) est inférieur au débit recommandé. Nous vous recommandons d'utiliser un débit audio de %(expected)s.
audioBitrateMismatch
Explication :Vérifiez le flux secondaire.
Description:Dans la configuration actuelle, le flux principal et le flux secondaire de la vidéo ont des débits audio différents. Vous devez configurer les flux pour qu'ils aient le même débit audio.
audioCodec
Explication :Vérifiez les paramètres audio.
Description:Le flux audio est encodé à l'aide d'un codec non compatible. Veuillez définir le codec audio pour le flux sur un codec compatible (AAC ou MP3).
audioCodecMismatch
Explication :Flux secondaire incorrect.
Description:Dans la configuration actuelle, le flux principal et le flux secondaire de la vidéo utilisent des codecs audio différents. Vous devez configurer les flux pour utiliser le même codec audio.
audioSampleRate
Explication :Vérifiez les paramètres audio.
Description:Le taux d'échantillonnage actuel est de %(actual). Les taux d'échantillonnage recommandés sont 44,1 kHz et 48 kHz.
audioSampleRateMismatch
Explication :Flux secondaire incorrect.
Description:Dans votre configuration actuelle, le flux principal et le flux secondaire de la vidéo ont des taux d'échantillonnage audio différents. Vous devez configurer les flux pour qu'ils aient le même taux d'échantillonnage audio.
audioStereoMismatch
Explication :Flux secondaire incorrect.
Description:Dans la configuration actuelle, le flux principal et le flux secondaire de la vidéo utilisent des canaux audio différents. Vous devez définir le même canal audio pour ces flux.
audioTooManyChannels
Explication :Vérifiez les paramètres audio.
Description:L'audio comporte plus de deux canaux, mais un seul (mono) ou deux (canaux stéréo) sont acceptés. Veuillez corriger le nombre de chaînes audio.
badContainer
Explication :Paramètres vidéo incorrects.
Description:Veuillez modifier le format du conteneur de la vidéo. Le format actuel du conteneur n'est pas correct pour cette configuration.
bitrateHigh
Explication :Vérifiez les paramètres vidéo.
Description:Le débit actuel du flux (%(actual)s) est supérieur au débit recommandé. Nous vous recommandons d'utiliser un débit de flux de %(expected)s.
bitrateLow
Explication :Sortie vidéo faible.
Description:Le débit actuel du flux (%(actual)s) est inférieur au débit recommandé. Nous vous recommandons d'utiliser un débit de flux de %(expected)s.
framerateMismatch
Explication :Vérifiez le flux secondaire.
Description:Dans votre configuration actuelle, le flux principal et le flux secondaire de la vidéo ont des fréquences d'images différentes. Vous devez configurer les flux pour qu'ils aient la même fréquence d'images.
frameRateHigh
Explication :Fréquence d'images trop élevée.
Description:La fréquence d'images actuelle est trop élevée. Veuillez définir une fréquence d'images inférieure ou égale à %(framerate)s fps.
gopMismatch
Explication :Flux secondaire incorrect.
Description:Dans la configuration actuelle, le flux principal et le flux secondaire de la vidéo ont des fréquences d'images clés différentes. Vous devez configurer la même fréquence d'images clés pour les flux.
gopSizeLong
Explication :Paramètres vidéo incorrects.
Description:Veuillez définir une fréquence d'images clés de quatre secondes au maximum. Actuellement, les images clés sont envoyées en nombre insuffisant, ce qui peut provoquer des mises en mémoire tampon. La fréquence d'images clés actuelle est de %(actual_gop).1f secondes. Notez que les erreurs d'ingestion peuvent entraîner des GOP (groupe d'images) incorrects.
gopSizeOver
Explication :Vérifiez les paramètres vidéo.
Description:Veuillez définir une fréquence d'images clés de quatre secondes au maximum. Actuellement, les images clés ne sont pas envoyées assez régulièrement, ce qui peut provoquer des mises en mémoire tampon. La fréquence d'images clés actuelle est de %(actual_gop).1f secondes. Notez que les erreurs d'ingestion peuvent entraîner des GOP (groupe d'images) incorrects.
gopSizeShort
Explication :Vérifiez les paramètres vidéo.
Description:Le GOP (groupe d'images) est de très petite taille, ce qui peut réduire la qualité des images. La fréquence d'images clés recommandée est de quatre secondes. La fréquence d'images clés actuelle est de %(actual_gop).1f secondes. Notez que les erreurs d'ingestion peuvent entraîner des GOP incorrects.
multipleAudioStreams
Explication :Vérifiez les paramètres audio.
Description:Le flux d'ingestion contient plusieurs flux audio, mais il doit en contenir uniquement un.
multipleVideoStreams
Explication :Paramètres vidéo incorrects.
Description:Le flux d'ingestion contient plusieurs flux vidéo, mais il doit en contenir uniquement un.
noAudioStream
Explication :Aucune piste audio
Description:Le flux d'ingestion ne contient aucun flux audio, mais il doit en contenir exactement un.
noVideoStream
Explication :Aucune vidéo.
Description:Le flux d'ingestion ne contient aucun flux vidéo, mais il doit en contenir exactement un.
openGop
Explication :Paramètres vidéo incorrects.
Description:Veuillez modifier la configuration de votre encodeur vidéo sur "GOP fermé". Il semble être défini sur "Open GOP", qui n'est pas compatible avec YouTube.
resolutionMismatch
Explication :Flux secondaire incorrect.
Description:Dans la configuration actuelle, le flux principal et le flux secondaire de la vidéo ont des résolutions différentes. Vous devez configurer les flux pour qu'ils aient la même résolution.
videoBitrateMismatch
Explication :Vérifiez le flux secondaire.
Description:Dans la configuration actuelle, le flux principal et le flux secondaire de la vidéo ont des débits vidéo différents. Vous devez configurer le même débit vidéo pour les flux.
videoCodec
Explication :Paramètres vidéo incorrects.
Description:La vidéo est encodée à l'aide d'un codec non compatible. Veuillez définir le codec vidéo pour le flux sur un codec compatible (H.264).
videoCodecMismatch
Explication :Flux secondaire incorrect.
Description:Dans la configuration actuelle, le flux principal et le flux secondaire de la vidéo utilisent des codecs vidéo différents. Vous devez configurer les flux pour qu'ils aient les mêmes codecs vidéo.
videoIngestionStarved
Explication :Sortie vidéo faible.
Description:YouTube ne reçoit pas suffisamment de vidéos pour garantir une diffusion fluide. Par conséquent, les utilisateurs pourront le mettre en mémoire tampon.
videoInterlaceMismatch
Explication :Flux secondaire incorrect.
Description:Dans la configuration actuelle, le flux principal et le flux secondaire de la vidéo ont des entrelacements différents. Vous devez configurer les flux pour qu'ils aient le même entrelacement.
videoProfileMismatch
Explication :Flux secondaire incorrect.
Description:Dans la configuration actuelle, le flux principal et le flux secondaire de la vidéo ont des profils différents. Vous devez configurer les flux pour qu'ils aient le même profil.
videoResolutionSuboptimal
Explication :Vérifiez la résolution.
Description:Veuillez vérifier la résolution de la vidéo. La résolution actuelle ((%(actual_w)dx%(actual_h)d)) n'est pas optimale.
videoResolutionUnsupported
Explication :Résolution non compatible.
Description:Il faut changer la résolution vidéo. La résolution actuelle ((%(actual_w)dx%(actual_h)d)) n'est pas compatible avec cette configuration. La résolution vidéo attendue est de (%(expected_w)dx%(expected_h)d).