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	原因： 检查音频设置 说明： 音频的声道数量超过了两个，但系统仅支持 1 个（单声道）或 2 个（立体声）声道。请更正音频的声道数量。
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)。