类：AdError

google.ima.广告错误

class public static

AdError 向用户显示有关广告加载或播放期间是否发生故障的信息。errorType 存取器可提供有关错误是在广告加载还是播放期间发生的信息。

扩展
错误

枚举

ErrorCode

常量 静态

number

加载或播放广告时可能出现的错误代码。 ErrorCodes 是数值，可位于以下任一范围内：

  • 符合 VAST 3 标准的广告错误代码使用的块数小于 1000。
  • SDK 特有错误代码： 高级别的一般性错误为 1000-1099 低级别一般性错误为 1100-1199 视频播放专用错误为 1200-1299

价值

VAST_MALFORMED_Response

广告响应未被识别为有效的 VAST 广告。 VAST 错误代码 100

VAST_SCHEMA_VALIDATION_ERROR

VAST 架构验证错误。 VAST 错误代码 101

VAST_UN_ED_VERSION

广告响应包含不受支持的 VAST 版本。 VAST 错误代码 102

VAST_TRAFFICKING_ERROR

广告投放管理错误。视频播放器收到的广告类型不符合预期且/或无法展示。 VAST 错误代码 200

VAST_UNEXPECTED_LINEARITY

广告线性与视频播放器的期望值不同。 VAST 错误代码 201

VAST_UNEXPECTED_DURATION_ERROR

VAST 时长与实际媒体文件的时长不同。 VAST 错误代码 202

VAST_WRAPPER_ERROR

发生了常规的 VAST 封装容器错误。 VAST 错误代码 300

VAST_LOAD_TIMEOUT

如视频播放器定义，所提供的 VAST URI 或在后续封装容器元素中提供的 VAST URI 不可用或超时。初始 VAST 请求和每个后续封装容器的超时时间均为 5 秒。 VAST 错误代码 301

VAST_TOO_MANY_REDIRECTS

已达到 VAST 封装容器重定向次数上限。 VAST 错误代码 302

VAST_NO_ADS_After_WRAPPER

一个或多个封装容器后没有广告 VAST 响应。 VAST 错误代码 303

VIDEO_PLAY_ERROR

播放视频广告时出错。 VAST 错误代码 400

VAST_MEDIA_LOAD_TIMEOUT

未能从 VAST 响应加载媒体素材资源。 媒体加载的默认超时为 8 秒。VAST 错误代码 402

VAST_LINEAR_ASSET_MISMATCH

在线性广告的 VAST 广告响应中找到的素材资源与视频播放器的功能均不匹配。 VAST 错误代码 403

VAST_PROBLEM_DISPLAYING_MEDIA_FILE

显示媒体文件时出现问题。目前用于因视频播放质量不佳而停止播放。VAST 错误代码 405

OVERLAY_AD_PLAYING_FAILED

重叠式广告无法呈现。 VAST 错误代码 500

新线上维度

无法展示非线性广告，因为广告素材尺寸与广告素材展示区域的尺寸不一致（例如，广告素材尺寸过大）。 VAST 错误代码 501

OVERLAY_AD_LOADING_FAILED

重叠式广告加载失败。 VAST 错误代码 502

VAST_NARAR_ASSET_MISMATCH

在 VAST 非线性广告响应中找到了素材资源，但与视频播放器的功能均不匹配。 VAST 错误代码 503

COMPANION_REQUIRED_ERROR

无法显示一个或多个必需的随播广告素材。主广告已被舍弃，因为无法显示所需的随播广告。VAST 错误代码 602

COMPANION_AD_LOADING_FAILED

无法加载或呈现随播广告。 VAST 错误代码 603

UNKNOWN_ERROR

发生意外错误，原因未知。如需了解详情，请参阅内部错误。 VAST 错误代码 900

VPAID 错误

发生了 VPAID 错误。如需了解详情，请参阅内部错误。 VAST 错误代码 901

FAILED_TO_REQUEST_ADS

从服务器请求广告时出现问题。IMA 错误代码 1005

VAST_资产

在 VAST 广告响应中未找到任何素材资源。 IMA 错误代码 1007

VAST_EMPTY_响应

包含单个 <VAST> 标记（无子标记）的 VAST 响应。 IMA 错误代码 1009

未知广告响应

无法识别和解析广告响应。 IMA 错误代码 1010

ADS_REQUEST_NETWORK_ERROR

从服务器请求广告时出现问题。IMA 错误代码 1012

无效广告标记

指定的广告代码网址无效。需要进行正确编码。 IMA 错误代码 1013

STREAM_INITIALIZATION_FAILED

服务器端广告插播期间，信息流初始化出错。 IMA 错误代码 1020

资产：FALLBACK_FAILED

素材资源回退出错。 IMA 错误代码 1021

无效

向 SDK 方法提供的参数无效。IMA 错误代码 1101

已停用自动播放

浏览器阻止了没有用户互动的播放。 IMA 错误代码 1205

CONSENT_MANAGEMENT_PROVIDER_NOT_READY

在网页上检测到意见征求管理提供程序，并表明意见征求尚不已知。 IMA 错误代码 1300

类型

常量 静态

字符串

可能在载入和播放广告时出现的错误类型。

价值

AD_LOAD

表示加载广告时遇到错误。 可能的原因：没有来自广告服务器的响应、返回的广告响应格式不正确，或广告请求参数无法通过验证。

AD_PLAY

表示错误是在广告播放期间（广告播放期间）发生。 可能的原因：无法加载广告素材资源，等等。

属性

ErrorCode

常量 静态

number

加载或播放广告时可能出现的错误代码。 ErrorCodes 是数值，可位于以下任一范围内：

  • 符合 VAST 3 标准的广告错误代码使用的块数小于 1000。
  • SDK 特有错误代码： 高级别的一般性错误为 1000-1099 低级别一般性错误为 1100-1199 视频播放专用错误为 1200-1299

价值

VAST_MALFORMED_Response

广告响应未被识别为有效的 VAST 广告。 VAST 错误代码 100

VAST_SCHEMA_VALIDATION_ERROR

VAST 架构验证错误。 VAST 错误代码 101

VAST_UN_ED_VERSION

广告响应包含不受支持的 VAST 版本。 VAST 错误代码 102

VAST_TRAFFICKING_ERROR

广告投放管理错误。视频播放器收到的广告类型不符合预期且/或无法展示。 VAST 错误代码 200

VAST_UNEXPECTED_LINEARITY

广告线性与视频播放器的期望值不同。 VAST 错误代码 201

VAST_UNEXPECTED_DURATION_ERROR

VAST 时长与实际媒体文件的时长不同。 VAST 错误代码 202

VAST_WRAPPER_ERROR

发生了常规的 VAST 封装容器错误。 VAST 错误代码 300

VAST_LOAD_TIMEOUT

如视频播放器定义，所提供的 VAST URI 或在后续封装容器元素中提供的 VAST URI 不可用或超时。初始 VAST 请求和每个后续封装容器的超时时间均为 5 秒。 VAST 错误代码 301

VAST_TOO_MANY_REDIRECTS

已达到 VAST 封装容器重定向次数上限。 VAST 错误代码 302

VAST_NO_ADS_After_WRAPPER

一个或多个封装容器后没有广告 VAST 响应。 VAST 错误代码 303

VIDEO_PLAY_ERROR

播放视频广告时出错。 VAST 错误代码 400

VAST_MEDIA_LOAD_TIMEOUT

未能从 VAST 响应加载媒体素材资源。 媒体加载的默认超时为 8 秒。VAST 错误代码 402

VAST_LINEAR_ASSET_MISMATCH

在线性广告的 VAST 广告响应中找到的素材资源与视频播放器的功能均不匹配。 VAST 错误代码 403

VAST_PROBLEM_DISPLAYING_MEDIA_FILE

显示媒体文件时出现问题。目前用于因视频播放质量不佳而停止播放。VAST 错误代码 405

OVERLAY_AD_PLAYING_FAILED

重叠式广告无法呈现。 VAST 错误代码 500

新线上维度

无法展示非线性广告，因为广告素材尺寸与广告素材展示区域的尺寸不一致（例如，广告素材尺寸过大）。 VAST 错误代码 501

OVERLAY_AD_LOADING_FAILED

重叠式广告加载失败。 VAST 错误代码 502

VAST_NARAR_ASSET_MISMATCH

在 VAST 非线性广告响应中找到了素材资源，但与视频播放器的功能均不匹配。 VAST 错误代码 503

COMPANION_REQUIRED_ERROR

无法显示一个或多个必需的随播广告素材。主广告已被舍弃，因为无法显示所需的随播广告。VAST 错误代码 602

COMPANION_AD_LOADING_FAILED

无法加载或呈现随播广告。 VAST 错误代码 603

UNKNOWN_ERROR

发生意外错误，原因未知。如需了解详情，请参阅内部错误。 VAST 错误代码 900

VPAID 错误

发生了 VPAID 错误。如需了解详情，请参阅内部错误。 VAST 错误代码 901

FAILED_TO_REQUEST_ADS

从服务器请求广告时出现问题。IMA 错误代码 1005

VAST_资产

在 VAST 广告响应中未找到任何素材资源。 IMA 错误代码 1007

VAST_EMPTY_响应

包含单个 <VAST> 标记（无子标记）的 VAST 响应。 IMA 错误代码 1009

未知广告响应

无法识别和解析广告响应。 IMA 错误代码 1010

ADS_REQUEST_NETWORK_ERROR

从服务器请求广告时出现问题。IMA 错误代码 1012

无效广告标记

指定的广告代码网址无效。需要进行正确编码。 IMA 错误代码 1013

STREAM_INITIALIZATION_FAILED

服务器端广告插播期间，信息流初始化出错。 IMA 错误代码 1020

资产：FALLBACK_FAILED

素材资源回退出错。 IMA 错误代码 1021

无效

向 SDK 方法提供的参数无效。IMA 错误代码 1101

已停用自动播放

浏览器阻止了没有用户互动的播放。 IMA 错误代码 1205

CONSENT_MANAGEMENT_PROVIDER_NOT_READY

在网页上检测到意见征求管理提供程序，并表明意见征求尚不已知。 IMA 错误代码 1300

类型

常量 静态

字符串

可能在载入和播放广告时出现的错误类型。

价值

AD_LOAD

表示加载广告时遇到错误。 可能的原因：没有来自广告服务器的响应、返回的广告响应格式不正确，或广告请求参数无法通过验证。

AD_PLAY

表示错误是在广告播放期间（广告播放期间）发生。 可能的原因：无法加载广告素材资源，等等。

方法

getErrorCode

getErrorCode() 返回数字

返回

number AdError.ErrorCode 中定义的错误代码。

getInnerError

getInnerError() 返回（null 或 Error）

返回导致此错误的错误。

返回

(null or non-null Error)：处理过程中发生的内部错误；如果此信息不可用，则为 null。此错误可能是原生错误，也可能是 AdError（原生错误的子类）。如果导致此错误的错误消息不可用，此方法可能会返回 null。

getMessage

getMessage() 返回字符串

返回

string 此错误消息。

getType

getType() 返回字符串

返回

string：AdError.Type 中定义的此错误的类型。

getVastErrorCode

getVastErrorCode() 返回数字

返回

number：如果 VAST 错误代码可用，则返回此代码，否则返回 AdError.ErrorCode.UNKNOWN_ERROR。

toString

公开

toString() 返回字符串

返回

string