Configuration Issues for LiveStream Resources
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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). |
|
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2023/02/22 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2023/02/22 (UTC)."],[[["The `status.healthStatus.configurationIssues[]` object in a liveStream resource identifies configuration problems affecting the quality of live video streams, and is used for troubleshooting."],["The document lists various configuration issues that can affect live video streams, detailing the issue type, a brief error description, and an explanation of how to rectify it."],["Configuration issues are categorized into different types, including problems with audio, video, bitrate, framerate, codecs, keyframe frequencies, and inconsistencies between primary and backup streams."],["Many descriptions of the configuration issues include variables, like `%(actual)` or `%(expected)s`, which are customized to reflect the specific details of each live stream's errors."],["Resolutions are based on the \"issue type\", for example: `audioBitrateLow`, `bitrateHigh`, `gopSizeLong`, allowing developers to build solutions based on these type of errors."]]],["Live streams may have configuration issues that impact quality. The `configurationIssues` object lists these problems, detailing the issue type, a short description, and a longer explanation for resolution. Issues include bitrate, codec, sample rate, and channel problems for audio; and bitrate, framerate, GOP, resolution, and codec issues for video. Mismatches between primary and backup streams are also noted. Actions to take involve checking settings, ensuring correct formats, and matching properties between streams.\n"]]
