Configuration Issues for LiveStream Resources

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).