错误代码

如果您遇到本页未能解决的问题,请参阅 Google Cast 支持页面,获取有关您的问题的解答。

Cast SDK 错误代码

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

名称 代码 说明 解决方案
应用 900 个 在框架之外发生错误(例如,如果 处理程序抛出错误)。 调查类型转换框架之外的错误。
BREAK_CLIP_LOADING_ERROR 901 当广告插播片段加载拦截器失败时返回。 查看插播时间点的内容。
BREAK_SEEK_INTERCEPTOR_ERROR 902 当中断跳转拦截器失败时返回。 检查确保中断搜寻拦截器正确无误。
IMAGE_ERROR 903 当图片加载失败时返回。 验证图片网址指向正确的位置。
LOAD_INTERRUPTED 904 加载被停止或其他加载中断。 检查是否是其他操作导致加载中断。
LOAD_FAILED 905 加载命令失败。 验证加载请求的设置是否正确,以及媒体是否能够 。
MEDIA_ERROR_MESSAGE 906 向发件人发送了一条错误消息。 请检查网络接收器或发件人,了解错误的相关信息。
GENERIC 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 不使用媒体元素 下载。 此问题可能出自您的应用上;如有必要,请通过 Cast 问题跟踪器
MEDIA_SRC_NOT_SUPPORTED 104 媒体元素触发了 MediaError.MEDIA_ERR_SRC_NOT_SUPPORTED 错误。 验证开发者数据细分受众群,确保编解码器包含在 Cast 支持的格式中。
SOURCE_BUFFER_FAILURE 110 Cast 无法将源缓冲区添加到现有的媒体来源。 请参阅 Web Crypto 很多时候,这可能是编解码器中指定的错误编解码器 流式传输。如果不是,请通过 Cast 问题跟踪器
MEDIAKEYS_NETWORK 201 使用 Media Keys 中的 XhrIo 发布许可请求时, 我们遇到了网络错误。 开发者验证其许可服务器。
MEDIAKEYS_不受支持 202 这包括两种情况: <ph type="x-smartling-placeholder">
    </ph>
  • 使用媒体会话在 EME 上生成请求时, 遇到了关键错误。
  • 未能初始化 EME 媒体键。
由于 Cast 不使用媒体,因此未能下载媒体数据 元素进行下载,请通过 Cast 问题跟踪器
MEDIAKEYS_WEBCRYPTO 203 使用浏览器支持的内置 Web Crypto 时,我们在解密时遇到了错误。请参阅 Web Crypto API 请通过 Cast 问题跟踪器报告。
NETWORK_UNKNOWN 300 个 提取未涵盖的资源时遇到常规网络连接错误 在 [301-399] 范围内 开发者必须确保抓取的内容可供访问且 正确形成服务器响应
SEGMENT_NETWORK 301* 无法以任何比特率检索任何片段(重试三次 指数退避算法)。 开发者需要验证其细分受众群是否确实可用。它 用户也无法覆盖这些细分受众群
HLS_NETWORK_MASTER_PLAYLIST 311* 尝试三次后未能检索到主播放列表 m3u8 文件。 开发者需要验证其播放列表是否确实可用。它 也可能是用户无法访问播放列表
HLS_NETWORK_PLAYLIST 312* 无法检索包含三个 重试。 开发者需要验证其播放列表是否确实可用。它 也可能是用户无法访问播放列表
HLS_NETWORK_NO_KEY_RESPONSE 313 解密密钥的请求未返回响应。 开发者需要验证其解密密钥服务。
HLS_NETWORK_KEY_LOAD 314* 用于请求 HLS 解密密钥的 XhrIO 失败。 开发者需要验证其解密密钥服务。
HLS_NETWORK_INVALID_SEGMENT 315 收到的要处理的 HLS 片段既不是 TS 也不是 mp4 AAC 细分。可能是 MPL 错误或网络接收器应用错误配置。 开发者需要验证其细分是否为 TS 或 AAC。
HLS_SEGMENT_PARSING 316 当 HLS 片段无法解析时返回。 开发者需要验证其细分是否正确形成。
DASH_NETWORK 321* 获取 DASH 清单的 XHR 请求失败,无响应。 有关网络相关错误诊断,请参阅星标部分。
DASH_NO_INIT 322 我们无法从第一个 DASH init 片段中提取初始化数据。 开发者需要验证其 DASH init 片段。
SMOOTH_NETWORK 331* 获取 DASH 清单的 XHR 请求失败,无响应。 查看星标部分,查看与网络相关的错误诊断信息。
SMOOTH_NO_MEDIA_DATA 332 下载以进行处理的细分受众群未包含任何媒体数据。 开发者需要验证顺畅的细分受众群。
HLS_MANIFEST_MASTER 411 HLS 清单文件解析失败。或者,MPL 不会 在 m3u8 中 检查清单网址的内容。
HLS_MANIFEST_PLAYLIST 412 媒体播放列表文件解析失败。或者,MPL 不会 在 m3u8 中 检查媒体播放列表网址的内容。
DASH_MANIFEST_NO_PERIODS 421 对 Dash 清单进行标准化时,我们发现其中没有句点。这是 异常。 开发者需要验证其 DASH 清单。
DASH_MANIFEST_NO_MIMETYPE 422 清单中没有表示表示法的 MIME 类型。 开发者需要为其指定音频/视频/文字 MIME 类型 表示。
DASH_INVALID_SEGMENT_INFO 423 MPL 请求的片段索引超出了 由清单文件的表示法指定的任何细分。 使用网站上的链接进行举报 Google Cast 支持页面。
SMOOTH_MANIFEST 431 流畅清单不符合标准。 开发者需要解决以下任一问题:
  • 无 SPS
  • 视频画质无效
  • 音频质量无效
  • 音频编解码器私有数据无效
  • 无效保护措施信息
  • 无质量级别
  • 未知媒体

Shaka 播放器错误代码

如需了解与 Shaka 播放器相关的错误代码,请参阅 Shaka 播放器 错误类文档

常见的网络连接错误

HTTP 错误 状态代码 说明 解决方案
BAD_REQUEST 400 由于格式不正确,服务器无法理解该请求 语法。客户端不应在未修改的情况下重复请求。 网址有问题。与应用开发者联系
未获授权 401 请求需要用户身份验证 检查应用是否存在正确的身份验证信息。
NOT_FOUND 404 客户端可与服务器通信,但服务器找不到 已请求 开发者会检查网址资源,并确保它们存在。
REQUEST_TIMEOUT 408 在服务器加载期间,客户端没有生成请求 做好准备。客户端以后可以随时重复该请求,不做任何修改。 这可能是资源(服务器可伸缩性)或实际网络问题。
INTERNAL_SERVER_错误 500 服务器遇到了意外状况,阻止其 处理请求 开发者检查服务器问题。
BAD_GATEWAY 502 作为网关或代理的服务器,收到了无效的 从其访问的上游服务器发出的响应, 请求。 开发者会检查自己的服务器配置。
SERVICE_UNAVAILABLE 503 服务器目前无法处理请求, 服务器超载或维护这意味着,这是一个 暂时性的情况,经过一段时间后会减轻。 开发者会检查自己的服务器配置,尤其是可伸缩性 部分服务
GATEWAY_TIMEOUT 504 服务器作为网关或代理,没有及时收到 从 URI 指定的上游服务器发送响应。 开发者检查其边缘之间的服务器配置和连接 服务器和源节点

备注

错误代码后跟星号 (*) 可以进一步包含错误代码 。格式为:

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

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

示例 3016404 包含三个部分:

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

网络连接错误的性质 - 其中一些错误是可以处理的,而其他错误则不是 网络操作的性质例如,错误 3018408 表示 超时可能意味着用户的连接状况不佳, 团队和开发者都做不到太多事情;请注意,这也可能意味着 开发者的 CDN 也遇到了问题另一方面,系统会返回错误 3116403 表示清单请求已成功发出,但服务器拒绝 投放。这可能是 CORS、auth 或任何其他服务器或集成 开发者应该关注的问题