问题排查

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

本页面介绍了如何解决与 Live Stream API 相关的问题。本页面中显示的错误是 Live Stream API 特有的错误。如需了解各种 Google API 中的一般性错误,请参阅 Cloud API 错误页面。

输入流已被拒绝

如果您的编码器向输入端点发送输入流,但连接一直被拒绝,请检查以下可能的问题:

输入端点 URI 无效

如果您的编码器将输入流发送到无效的输入端点 URI,则会发生错误。

如需解决此问题,请检查编码器是否已配置为将输入流发送到具有正确的 IP 地址和 STREAM-ID 的输入端点 URI。

输入未附加到某个渠道

如果您的编码器将输入流发送到未连接到通道的输入端点 URI,则会发生错误。

如需解决此问题,请使用输入端点创建新渠道。如需检查输入端点是否已成功附加到通道,请获取通道详情,然后在 inputAttachments 字段中查找输入端点的名称。

无效渠道

如果您的编码器将输入流发送到未运行的通道,则会出现错误。

如需解决此问题,请检查渠道的状态,以确保其 streamingStateAWAITING_INPUT。如果频道的 streamingStateSTOPPED,请启动频道

另一个编码器已与同一输入端点连接

如果多个编码器尝试将输入流发送到同一输入端点,则会发生错误。每个输入端点 URI 一次只接受一个连接。

如需解决此问题,请检查渠道是否已处于 STREAMING 状态。如果是这样的话,您有以下几种选择:

  • 为第二个输入流创建单独的输入端点和通道。

  • 将第一个输入流停止,然后再向另一个输入端点发送另一个输入流。

编码器 IP 地址不在允许的 IP 范围内

如果您的编码器从为输入端点配置的指定 IP 地址范围之外的 IP 地址发送输入流,则会发生错误。

如需解决此问题,请获取输入端点的详细信息并检查 securityRules 字段。如果指定了 ipRanges,请确保您的编码器在这些 IP 范围内具有有效的 IP 地址。

Cloud Storage 存储桶中缺少输出文件

如果您的编码器成功地将输入流发送到输入端点,但 Cloud Storage 存储桶中未显示任何输出文件,请检查是否存在以下潜在问题:

Cloud Storage 存储桶不正确

如果您检查的是错误的 Cloud Storage 存储桶,则输出文件可能会缺失。

如需解决此问题,请获取直播的频道详情。检查 output.uri 字段是否有正确的 Cloud Storage 存储桶 URI。

输入视频/音频编解码器无效

如果您的编码器发送的视频或音频编解码器无效,则输出文件可能会丢失。

要解决此问题,请确保您的编码器仅发送 H264 视频和 AAC 音频编解码器。

Cloud Storage 权限被拒绝

默认情况下,Live Stream API 会创建一个服务帐号,该帐号可以访问托管 Live Stream API 资源的 Google Cloud 项目中的 Cloud Storage 存储分区。如果此服务帐号失去对 Cloud Storage 存储桶的访问权限,则输出文件可能缺失。

如需解决此问题,请确保服务帐号具有足够的权限。输出文件创建失败的原因如下:

  • 输出 Cloud Storage 存储桶所在的 Google Cloud 项目不同于频道和输入端点等 Live Stream API 资源。

  • 系统会撤消服务帐号的默认权限。

如需了解详情,请参阅访问 Cloud Storage

缺少音轨

如果您的编码器发送的输入流缺少音轨,输出文件可能会缺失。视频流水线会等待所有音轨到达,然后再开始处理。

如需解决此问题,请获取直播的频道详情。确保您的编码器发送的是在 ElementaryStream.audioStream.mapping (AudioMapping) 字段中配置的所有音轨。