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