Configuration Issues for LiveStream Resources
Stay organized with collections
Save and categorize content based on your preferences.
In a liveStream resource, the status.healthStatus.configurationIssues[] object contains a list of configuration issues affecting the stream. This information is intended to help you identify, diagnose, and resolve issues affecting the quality of your live video streams.
This document lists the types of configuration issues that might be referenced in an API response. Each issue specifies the issue type, a short description of the error, and a longer description that often contains information explaining how to fix the error.
Configuration Issues
The table below lists configuration issues that can affect live video streams. The left column identifies the type of issue and the right column provides additional detail about how to resolve it.
Note that some descriptions contain variables, which will be populated to reflect data about your actual live stream. In the descriptions below, text in <code> style, such as %(actual_gop).1f, identifies a portion of an error message that is customized to each live stream. Your code should be keyed off of the issue types, which are in the left column.
| Configuration issues |
audioBitrateHigh |
| Reason: | Check audio settings |
| Description: | The audio stream's current bitrate of %(actual) is higher than the recommended bitrate. We recommend that you use an audio stream bitrate of %(expected)s. |
|
audioBitrateLow |
| Reason: | Check audio settings |
| Description: | The audio stream's current bitrate (%(actual)s) is lower than the recommended bitrate. We recommend that you use an audio stream bitrate of %(expected)s. |
|
audioBitrateMismatch |
| Reason: | Check secondary stream |
| Description: | In the current configuration, the video's primary and backup streams have different audio bitrates. You need to configure the streams to have the same audio bitrate. |
|
audioCodec |
| Reason: | Check audio settings |
| Description: | The audio stream is encoded with an unsupported codec. Please set the audio codec for the stream to a supported codec (AAC, MP3). |
|
audioCodecMismatch |
| Reason: | Bad secondary stream |
| Description: | In the current configuration, the video's primary and backup streams use different audio codecs. You need to configure the streams to use the same audio codec. |
|
audioSampleRate |
| Reason: | Check audio settings |
| Description: | The current sample rate is %(actual). The recommended sample rates are 44.1kHz and 48kHz. |
|
audioSampleRateMismatch |
| Reason: | Bad secondary stream |
| Description: | In the current configuration, the video's primary and backup streams have different audio sample rates. You need to configure the streams to have the same audio sample rate. |
|
audioStereoMismatch |
| Reason: | Bad secondary stream |
| Description: | In the current configuration, the video's primary and backup streams use different audio channels. You need to configure the streams to have the same audio channel. |
|
audioTooManyChannels |
| Reason: | Check audio settings |
| Description: | The audio has more than two channels, but only one (mono) or two (stereo) channels are supported. Please correct the number of audio channels. |
|
badContainer |
| Reason: | Bad video settings |
| Description: | Please change the video's container format. The current container format is not correct for this configuration. |
|
bitrateHigh |
| Reason: | Check video settings |
| Description: | The stream's current bitrate (%(actual)s) is higher than the recommended bitrate. We recommend that you use a stream bitrate of %(expected)s. |
|
bitrateLow |
| Reason: | Video output low |
| Description: | The stream's current bitrate (%(actual)s) is lower than the recommended bitrate. We recommend that you use a stream bitrate of %(expected)s. |
|
framerateMismatch |
| Reason: | Check secondary stream |
| Description: | In the current configuration, the video's primary and backup streams have different framerates. You need to configure the streams to have the same framerate. |
|
frameRateHigh |
| Reason: | Framerate high |
| Description: | The current framerate is too high. Please set the framerate to %(framerate)s fps or less. |
|
gopMismatch |
| Reason: | Bad secondary stream |
| Description: | In the current configuration, the video's primary and backup streams have different keyframe frequencies. You need to configure the streams to have the same keyframe frequency. |
|
gopSizeLong |
| Reason: | Bad video settings |
| Description: | Please use a keyframe frequency of four seconds or less. Currently, keyframes are not being sent often enough, which will cause buffering. The current keyframe frequency is %(actual_gop).1f seconds. Note that ingestion errors can cause incorrect GOP (group of pictures) sizes. |
|
gopSizeOver |
| Reason: | Check video settings |
| Description: | Please use a keyframe frequency of four seconds or less. Currently, keyframes are not being sent often enough, which can cause buffering. The current keyframe frequency is %(actual_gop).1f seconds. Note that ingestion errors can cause incorrect GOP (group of pictures) sizes. |
|
gopSizeShort |
| Reason: | Check video settings |
| Description: | The GOP (group of pictures) size is very small, which can reduce image quality. The recommended keyframe frequency is four seconds. The current keyframe frequency is %(actual_gop).1f seconds. Note that ingestion errors can cause incorrect GOP sizes. |
|
multipleAudioStreams |
| Reason: | Check audio settings |
| Description: | The ingestion stream contains multiple audio streams, but it must only contain one audio stream. |
|
multipleVideoStreams |
| Reason: | Bad video settings |
| Description: | The ingestion stream contains multiple video streams, but it must only contain one video stream. |
|
noAudioStream |
| Reason: | No audio |
| Description: | The ingestion stream does not contain any audio streams, but it must contain exactly one audio stream. |
|
noVideoStream |
| Reason: | No video |
| Description: | The ingestion stream does not contain any video streams, but it must contain exactly one video stream. |
|
openGop |
| Reason: | Bad video settings |
| Description: | Please change your video encoder's configuration to "closed group of pictures (GOP)." It appears to be set to "open GOP," which YouTube does not support. |
|
resolutionMismatch |
| Reason: | Bad secondary stream |
| Description: | In the current configuration, the video's primary and backup streams have different resolutions. You need to configure the streams to have the same resolution. |
|
videoBitrateMismatch |
| Reason: | Check secondary stream |
| Description: | In the current configuration, the video's primary and backup streams have different video bitrates. You need to configure the streams to have the same video bitrate. |
|
videoCodec |
| Reason: | Bad video settings |
| Description: | The video is encoded with an unsupported codec. Please set the video codec for the stream to a supported codec (H.264). |
|
videoCodecMismatch |
| Reason: | Bad secondary stream |
| Description: | In the current configuration, the video's primary and backup streams use different video codecs. You need to configure the streams to have the same video codecs. |
|
videoIngestionStarved |
| Reason: | Video output low |
| Description: | YouTube is not receiving enough video to maintain smooth streaming. As such, viewers will experience buffering. |
|
videoInterlaceMismatch |
| Reason: | Bad secondary stream |
| Description: | In the current configuration, the video's primary and backup streams have different interlacing. You need to configure the streams to have the same interlacing. |
|
videoProfileMismatch |
| Reason: | Bad secondary stream |
| Description: | In the current configuration, the video's primary and backup streams have different profiles. You need to configure the streams to have the same profile. |
|
videoResolutionSuboptimal |
| Reason: | Check resolution |
| Description: | Please check the video resolution. The current resolution is (%(actual_w)dx%(actual_h)d), which is not optimal. |
|
videoResolutionUnsupported |
| Reason: | Unsupported resolution |
| Description: | You need to change the video resolution. The current resolution is (%(actual_w)dx%(actual_h)d), which is not supported for this configuration. The expected video resolution is (%(expected_w)dx%(expected_h)d). |
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2022-11-04 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2022-11-04 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"]]
