Configuration Issues for LiveStream Resources

liveStream 资源中,status.healthStatus.configurationIssues[] 对象包含影响数据流的配置问题列表。此信息旨在帮助您发现、诊断和解决影响直播视频质量的问题。

本文档列出了 API 响应中可能引用的配置问题类型。每个问题都会指定问题类型、错误的简短说明,以及通常包含如何修正错误的信息的详细说明。

配置问题

下表列出了会影响直播视频流的配置问题。左列表示问题的类型,右列提供了关于如何解决该问题的其他详细信息。

请注意,某些说明包含变量,系统会填充这些变量来反映与您的实际直播相关的数据。在以下说明中,<code> 样式的文本(例如 %(actual_gop).1f)用于标识为每场直播自定义的错误消息的一部分。您的代码应符合左侧列中的问题类型。

配置问题
audioBitrateHigh
原因:检查音频设置
说明:音频流当前的比特率 %(actual) 高于建议的比特率。我们建议您使用%(expected)s的音频流比特率。
audioBitrateLow
原因:检查音频设置
说明:音频流当前的比特率 (%(actual)s) 低于建议的比特率。我们建议您使用%(expected)s的音频流比特率。
audioBitrateMismatch
原因:检查辅助视频流
说明:在当前配置下,视频的主视频流和备用视频流的音频比特率不同。您需要为这些音频流配置相同的音频比特率。
audioCodec
原因:检查音频设置
说明:音频流编码所用的编解码器不受支持。请将音频流的音频编解码器设置为受支持的编解码器(AAC、MP3)。
audioCodecMismatch
原因:辅助视频流有误
说明:在当前配置下,视频的主视频流和备用视频流采用不同的音频编解码器。您需要将这些视频流配置为使用相同的音频编解码器。
audioSampleRate
原因:检查音频设置
说明:当前采样率为 %(actual)。建议的采样率为 44.1kHz 和 48kHz。
audioSampleRateMismatch
原因:辅助视频流有误
说明:在当前配置下,视频的主视频流和备用视频流的音频采样率不同。您需要为这些音频流配置相同的音频采样率。
audioStereoMismatch
原因:辅助视频流有误
说明:在当前配置下,视频的主视频流和备用视频流所使用的声道不同。您需要将这两种视频流配置为使用相同的声道。
audioTooManyChannels
原因:检查音频设置
说明:音频具有两个以上的声道,但仅支持一个(单声道)或两个(立体声)声道。请更正声道的数量。
badContainer
原因:视频设置有误
说明:请更改视频的容器格式。此容器的当前容器格式不正确。
bitrateHigh
原因:检查视频设置
说明:当前音频/视频流的比特率 (%(actual)s) 高于建议的比特率。我们建议您使用 %(expected)s 的流比特率。
bitrateLow
原因:视频输出率低
说明:当前音频/视频流的比特率 (%(actual)s) 低于建议的比特率。我们建议您使用 %(expected)s 的流比特率。
framerateMismatch
原因:检查辅助视频流
说明:在当前配置下,视频的主视频流和备用视频流的帧速率不同。您需要将这两个视频流配置为相同的帧速率。
frameRateHigh
原因:帧速率过高
说明:当前帧速率过高。请将帧速率设为 %(framerate)s fps 或更低。
gopMismatch
原因:辅助视频流有误
说明:在当前配置下,视频的主视频流和备用视频流的关键帧频率不同。您需要将这两种视频流配置为相同的关键帧频率。
gopSizeLong
原因:视频设置有误
说明:请使用不超过 4 秒的关键帧频率。当前的关键帧发送频率不够高,这会使视频流进入缓冲状态。当前的关键帧频率为 %(actual_gop).1f 秒。注意,如果发生提取错误,则会造成画面组 (GOP) 尺寸错误。
gopSizeOver
原因:检查视频设置
说明:请使用不超过 4 秒的关键帧频率。当前的关键帧发送频率不够高,这会使视频流进入缓冲状态。当前的关键帧频率为 %(actual_gop).1f 秒。注意,如果发生提取错误,则会造成画面组 (GOP) 尺寸错误。
gopSizeShort
原因:检查视频设置
说明:画面组 (GOP) 尺寸太小,这会降低画面质量。建议的关键帧频率为 4 秒。当前的关键帧频率为 %(actual_gop).1f 秒。注意,如果发生提取错误,则会造成 GOP 尺寸错误。
multipleAudioStreams
原因:检查音频设置
说明:提取流包含多个音频流,但它只能包含一个音频流。
multipleVideoStreams
原因:视频设置有误
说明:提取流包含多个视频流,但它只能包含一个视频流。
noAudioStream
原因:无音频
说明:提取流未包含任何音频流,但它必须包含(且只能包含)一个音频流。
noVideoStream
原因:无视频
说明:提取流未包含任何视频流,但它必须包含(且只能包含)一个视频流。
openGop
原因:视频设置有误
说明:请将您的视频编码器配置改为“封闭画面组 (GOP)”。它似乎设置为“开放 GOP”,YouTube 不支持。
resolutionMismatch
原因:辅助视频流有误
说明:在当前配置下,视频的主视频流和备用视频流的分辨率不同。您需要将视频流配置为相同的分辨率。
videoBitrateMismatch
原因:检查辅助视频流
说明:在当前配置下,视频的主视频流和备用视频流的视频比特率不同。您需要将这两个视频流配置为相同的视频比特率。
videoCodec
原因:视频设置有误
说明:视频编码所用的编解码器不受支持。请将视频流的视频编解码器设置为受支持的编解码器 (H.264)。
videoCodecMismatch
原因:辅助视频流有误
说明:在当前配置下,视频的主视频流和备用视频流的视频编解码器不同。您需要将这两个视频流配置为具有相同的视频编解码器。
videoIngestionStarved
原因:视频输出率低
说明:YouTube 未收到足够的视频来维持流畅的流式传输。因此,观看者会遇到缓冲问题。
videoInterlaceMismatch
原因:辅助视频流有误
说明:在当前配置下,视频的主视频流和备用视频流的隔行扫描方式不同。您需要将这两个流配置为具有相同的交错。
videoProfileMismatch
原因:辅助视频流有误
说明:在当前配置下,视频的主视频流和备用视频流的配置文件不同。您需要将这些数据流配置为具有相同的配置文件。
videoResolutionSuboptimal
原因:检查分辨率
说明:请检查视频分辨率。当前的分辨率是 (%(actual_w)dx%(actual_h)d),这不是最佳分辨率。
videoResolutionUnsupported
原因:分辨率不受支持
说明:您需要更改视频分辨率。当前的分辨率是 (%(actual_w)dx%(actual_h)d),此配置不支持该分辨率。预期的视频分辨率为 (%(expected_w)dx%(expected_h)d)