错误代码

如果您遇到的问题未解决此页面,请参阅 Google Cast 支持页面,以寻求相关问题的解答。

Cast SDK 错误代码

与错误事件或媒体错误消息发送的 Cast SDK 相关的错误代码。

名称 代码 说明 解决方案
应用 900 个 当框架之外出现错误(例如,事件处理脚本抛出错误)时,系统会返回此回调函数。 调查投放框架之外的错误。
BREAK_CLIP_LOADING_ERROR 901 当中断片段加载拦截器失败时返回。 检查广告插播时间点剪辑的内容。
BREAK_SEEK_INTERCEPTOR_错误 902 当中断搜寻拦截器失败时返回。 检查以确保广告插播跳转拦截器正确无误。
图片 错误 903 当图片加载失败时返回。 验证图片网址是否指向正确的位置。
加载中断 904 加载被停点或其他加载中断。 检查是否是其他操作导致加载中断。
加载失败 905 加载命令失败。 验证加载请求是否已正确设置,并且媒体能够播放。
MEDIA_ERROR_MESSAGE 906 已向发件人发送错误消息。 检查网络接收器或发送方,了解错误信息。
常规 909 当发生未知错误时返回。 发生意外错误。这种情况很少见。

媒体播放器错误代码

由错误事件或媒体错误消息发送的 MPL 中与播放相关的错误消息。

名称 代码 说明 解决方案
Media_UNKNOWN 100 媒体元素遇到了平台触发的未知错误。 媒体元素遇到了错误,但指示它不是 MediaError.MEDIA_ERR_* 中的一个。这种情况很少见。
Media_ABORTED 101 媒体元素触发了 MediaError.MEDIA_ERR_ABORTED 错误。 应用户请求时取消了媒体资源的提取过程。这通常是因为堕胎所致。
Media_DECODE 102 媒体元素触发了 MediaError.MEDIA_ERR_DECODE 错误。 开发者应验证其数据流的编码参数。
Media_NETWORK 103 媒体元素触发了 MediaError.MEDIA_ERR_NETWORK 错误 下载媒体数据失败,因为 Cast 不使用媒体元素进行下载。 此问题可能是您的应用存在的问题;如有必要,请通过投射问题跟踪器进行报告。
MEDIA_SRC_NOT_受支持 104 媒体元素触发了 MediaError.MEDIA_ERR_SRC_NOT_SUPPORTED 错误。 验证开发者数据细分受众群,确保编解码器包含在支持 Cast 的格式中。
SOURCE_BUFFER_失败 110 Cast 无法将来源缓冲区添加到现有媒体来源。请参阅 Web 加密 通常,这可能是应用中清单上的编解码器流中指定的编解码器不正确。如果不是,请通过投射问题跟踪器报告。
MediaKEYS_NETWORK 201 使用媒体键中的 XhrIo 发布许可请求时,我们遇到了网络连接错误。 开发者验证其许可服务器。
MEDIAKEYS_不支持 202 这涉及两种情况:
  • 在使用媒体会话生成 EME 请求时,我们遇到了一个关键错误。
  • 未能初始化 EME 媒体键。
媒体数据下载失败,但由于 Cast 不使用媒体元素进行下载,因此请通过 Cast 问题跟踪器进行报告。
MediaKEYS_WEBCRYPTO 203 使用浏览器支持的内置网络加密功能时,我们发现错误。请参阅 Web Crypto API 请通过投射问题跟踪器进行报告。
NETWORK_UNKNOWN 300 个 提取未包含在 [301-399] 范围内的资源时发生常规网络错误 开发者必须确保提取的内容可访问,且服务器的响应格式正确无误。
SEGMENT_NETWORK 301* 未能从任何比特率检索到任何片段(三次重试指数退避算法)。 开发者需要验证其细分受众群确实可用。用户也可能会无法覆盖这些细分受众群。
HLS_NETWORK_MASTER_播放列表 311* 未能检索到三次重试的主播放列表 m3u8 文件。 开发者需要验证其播放列表是否确实可以使用。用户也可能无法到达播放列表。
HLS_NETWORK_PLAYLIST 312* 未能检索到三次重试的媒体(比特率)播放列表 m3u8 文件。 开发者需要验证其播放列表是否确实可以使用。用户也可能无法到达播放列表。
HLS_NETWORK_NO_KEY_响应 313 解密密钥请求未返回响应。 开发者需要验证其解密密钥服务。
HLS_NETWORK_KEY_加载 314* 用于请求 HLS 解密密钥的 XhrIO 失败。 开发者需要验证其解密密钥服务。
HLS_NETWORK_INVALID_细分 315 收到的用于处理的 HLS 片段既不是 TS 片段,也不是 mp4 AAC 片段。可能是 MPL bug 或 Web 接收器应用 bug 中的配置。 开发者需要验证其细分受众群是 TS 还是 AAC。
HLS_SEGMENT_PARSING 316 当 HLS 片段无法解析时返回。 开发者需要验证其细分受众群的格式是否正确。
DASH_NETWORK 321* XDASH 请求以获取 DASH 清单,但无响应。 如需了解与网络相关的错误诊断,请参阅星标部分。
DASH_NO_INIT 322 我们无法从第一个 DASH init 片段中提取初始化数据。 开发者需要验证其 DASH init 细分。
SMOOTH_NETWORK 331* XDASH 请求以获取 DASH 清单,但无响应。 如需了解网络相关错误诊断,请参阅星标部分。
SMOOTH_NO_MEDIA_数据 332 下载进行处理的细分受众群不包含任何媒体数据。 开发者需要验证其 Smooth 细分受众群。
HLS_MANIFEST_MASTER 411 未能解析 HLS 清单文件。或者 MPL 尚未在 m3u8 中理解的内容 检查清单网址的内容。
HLS_MANIFEST_PLAYLIST 412 未能解析媒体播放列表文件。或者 MPL 尚未在 m3u8 中理解的内容 检查媒体播放列表网址的内容。
DASH_MANIFEST_NO_时间段 421 在对 Dash 清单进行标准化处理时,我们发现它中没有句点。这属于异常情况。 开发者需要验证其 DASH 清单。
DASH_MANIFEST_NO_MIMETYPE 422 清单中的表示法没有 MIME 类型。 开发者需要为其表示法指定音频/视频/文本 MIME 类型。
DASH_INVALID_SEGMENT_信息 423 MPL 请求的细分受众群索引超出了清单中的表示法指定的可用细分受众群的长度。 使用 Google Cast 支持页面上的链接进行报告。
SMOOTH_MANIFEST 431 顺畅的清单不符合标准。 开发者需要解决以下任一问题:
  • 无 sps
  • 视频质量无效
  • 音频质量无效
  • 音频编解码器专用数据无效
  • 保护措施信息无效
  • 无质量级别
  • 未知媒体

Shaka 播放器错误代码

如需了解与 Shaka Player 有关的错误代码,请参阅 Shaka Player 错误类文档

常见网络连接错误

HTTP 错误 状态代码 说明 解决方案
BAD_REQUEST 400 由于语法格式错误,服务器无法理解该请求。客户端不应在未修改的情况下重复该请求。 网址存在问题。与应用开发者联系
未授权 401 请求需要用户身份验证 检查应用,查看是否有正确的身份验证信息。
未找到 404 客户端可以与服务器通信,但服务器找不到所请求的内容 开发者会检查网址资源并确保其存在。
REQUEST_TIMEOUT 408 在服务器准备好等待的时间内,客户端未生成请求。客户端可以在稍后随时修改该请求,而无需进行修改。 这可能是资源(服务器可伸缩性)或实际网络问题。
INTERNAL_SERVER_错误 500 服务器遇到了意外情况,导致请求无法完成。 开发者检查服务器问题。
BAD_GATEWAY 502 服务器作为网关或代理时,收到尝试处理请求时所访问的上游服务器的无效响应。 开发者可以检查其服务器配置。
服务不可用 503 由于服务器暂时过载或维护,服务器目前无法处理请求。这意味着,这是一个临时的条件,经过一段时间后会缓解。 开发者可以检查其服务器配置,尤其是其服务的可伸缩性。
GATEWAY_TIMEOUT 504 服务器作为网关或代理时,未及时收到 URI 指定的上游服务器的响应。 开发者会检查其服务器与源节点之间的服务器配置和连接情况。

备注

错误代码后跟星号 (*) 后可以对其附加错误代码。格式为:

{Error Code}{Closure Network Error Code}{HTTP Status Code}

如需了解详情,请参阅 HTTP 状态代码

示例 3016404 包含三个部分:

301 片段网络连接错误。
6 HTTP 错误。
404 “HTTP 未找到”状态。

网络连接错误的性质 - 其中一些错误是可作为行动依据的,而另外一些错误则是由网络操作的性质造成的。例如,错误 3018408 表示超时对用户而言可能意味着糟糕的连接,Cast 团队和开发者都无法做到这一点;请注意,这也意味着开发者的 CDN 也有问题。另一方面,错误 3116403 表示清单请求已成功发出,但服务器拒绝提供。这可能会是 CORS、身份验证,或者是开发者应该注意的任何其他服务器或集成问题。