類別：AdError

google.ima.AdError

class public 靜態

AdError 會向使用者顯示廣告載入或播放期間是否發生失敗的資訊。errorType 存取子提供有關載入廣告或廣告播放期間錯誤的資訊。

擴充
錯誤

列舉

ErrorCode

常數 靜態

數字

載入或播放廣告時可能引發的錯誤代碼。 ErrorCode 是數值，且可以是下列其中一個範圍：

  • 符合 VAST 3 標準的標準廣告錯誤代碼會使用 1000 以下的區塊。
  • SDK 專用錯誤代碼：1000-1099 代表高階一般錯誤 1100-1199：低階一般錯誤 1200-1299：影片播放問題相關錯誤

值

VAST_MALFORMED_QUESTION

系統會將廣告回應視為有效的 VAST 廣告。 VAST 錯誤代碼 100

VAST_SCHEMA_VALIDATION_ERROR

VAST 架構驗證錯誤。VAST 錯誤代碼 101

VAST_UNSUPPORTED_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

顯示 MediaFile 時發生問題。因為影片播放品質不佳而停止播放時，即適用這項設定。VAST 錯誤代碼 405

OVERLAY_AD_PLAYING_FAILED

系統無法顯示重疊廣告。 VAST 錯誤代碼 500

NOnlineAR_DIMENSIONS_ERROR

無法顯示非線性廣告，因為廣告素材尺寸與廣告素材顯示區域不符 (例如，廣告素材尺寸過大)。 VAST 錯誤代碼 501

OVERLAY_AD_LOADING_FAILED

無法載入重疊廣告。VAST 錯誤代碼 502

VAST_NOnlineAR_ASSET_MISMATCH

在 VAST 廣告回應中找到非線性廣告的素材資源，但這些素材資源都與影片播放器的功能不符。VAST 錯誤代碼 503

COMPANION_REQUIRED_ERROR

無法顯示一個或多個必要的隨播廣告。由於無法顯示必要的隨播廣告，因此系統會捨棄主要廣告。VAST 錯誤代碼 602

COMPANION_AD_LOADING_FAILED

無法載入或顯示隨播廣告。VAST 錯誤代碼 603

UNKNOWN_ERROR

發生未預期的錯誤，原因不明。詳情請參閱內部錯誤。 VAST 錯誤代碼 900

VPAID_ERROR

發生 VPAID 錯誤。詳情請參閱內部錯誤。 VAST 錯誤代碼 901

FAILED_TO_REQUEST_ADS

向伺服器請求廣告時發生問題。 IMA 錯誤代碼 1005

VAST_ASSET_NOT_FOUND

VAST 廣告回應找不到任何素材資源。 IMA 錯誤代碼 1007

VAST_EMPTY_QUESTION

內含一個不含子標記的單一 <VAST> 標記的 VAST 回應。 IMA 錯誤代碼 1009

UNKNOWN_AD_QUESTION

系統無法解讀廣告回應，因此無法剖析。IMA 錯誤代碼 1010

ADS_REQUEST_NETWORK_ERROR

向伺服器請求廣告時發生問題。 IMA 錯誤代碼 1012

INVALID_AD_TAG

指定的廣告代碼網址無效。必須正確編碼。 IMA 錯誤代碼 1013

STREAM_INITIALIZATION_FAILED

伺服器端廣告插播期間串流時發生錯誤。IMA 錯誤代碼 1020

ASSET_FALLBACK_FAILED

素材資源備用廣告發生錯誤。 IMA 錯誤代碼 1021

INVALID_ARGUMENTS

提供給 SDK 方法的引數無效。IMA 錯誤代碼 1101

AUTOPLAY_DISALLOWED

瀏覽器不允許播放，而無需與使用者互動。IMA 錯誤代碼 1205

CONSENT_MANAGEMENT_PROVIDER_NOT_READY

已在網頁上偵測到同意聲明管理供應商，並指出尚未取得同意聲明。IMA 錯誤代碼 1300

類型

常數 靜態

字串

廣告載入及播放的可能錯誤類型。

值

AD_LOAD

表示廣告載入時發生錯誤。 可能原因：廣告伺服器沒有回應、傳回了格式錯誤的廣告回應，或廣告請求參數未通過驗證。

AD_PLAY

指出廣告載入之後，在廣告播放期間發生的錯誤。可能的原因：無法載入廣告資產等。

屬性

ErrorCode

常數 靜態

數字

載入或播放廣告時可能引發的錯誤代碼。 ErrorCode 是數值，且可以是下列其中一個範圍：

  • 符合 VAST 3 標準的標準廣告錯誤代碼會使用 1000 以下的區塊。
  • SDK 專用錯誤代碼：1000-1099 代表高階一般錯誤 1100-1199：低階一般錯誤 1200-1299：影片播放問題相關錯誤

值

VAST_MALFORMED_QUESTION

系統會將廣告回應視為有效的 VAST 廣告。 VAST 錯誤代碼 100

VAST_SCHEMA_VALIDATION_ERROR

VAST 架構驗證錯誤。VAST 錯誤代碼 101

VAST_UNSUPPORTED_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

顯示 MediaFile 時發生問題。因為影片播放品質不佳而停止播放時，即適用這項設定。VAST 錯誤代碼 405

OVERLAY_AD_PLAYING_FAILED

系統無法顯示重疊廣告。 VAST 錯誤代碼 500

NOnlineAR_DIMENSIONS_ERROR

無法顯示非線性廣告，因為廣告素材尺寸與廣告素材顯示區域不符 (例如，廣告素材尺寸過大)。 VAST 錯誤代碼 501

OVERLAY_AD_LOADING_FAILED

無法載入重疊廣告。VAST 錯誤代碼 502

VAST_NOnlineAR_ASSET_MISMATCH

在 VAST 廣告回應中找到非線性廣告的素材資源，但這些素材資源都與影片播放器的功能不符。VAST 錯誤代碼 503

COMPANION_REQUIRED_ERROR

無法顯示一個或多個必要的隨播廣告。由於無法顯示必要的隨播廣告，因此系統會捨棄主要廣告。VAST 錯誤代碼 602

COMPANION_AD_LOADING_FAILED

無法載入或顯示隨播廣告。VAST 錯誤代碼 603

UNKNOWN_ERROR

發生未預期的錯誤，原因不明。詳情請參閱內部錯誤。 VAST 錯誤代碼 900

VPAID_ERROR

發生 VPAID 錯誤。詳情請參閱內部錯誤。 VAST 錯誤代碼 901

FAILED_TO_REQUEST_ADS

向伺服器請求廣告時發生問題。 IMA 錯誤代碼 1005

VAST_ASSET_NOT_FOUND

VAST 廣告回應找不到任何素材資源。 IMA 錯誤代碼 1007

VAST_EMPTY_QUESTION

內含一個不含子標記的單一 <VAST> 標記的 VAST 回應。 IMA 錯誤代碼 1009

UNKNOWN_AD_QUESTION

系統無法解讀廣告回應，因此無法剖析。IMA 錯誤代碼 1010

ADS_REQUEST_NETWORK_ERROR

向伺服器請求廣告時發生問題。 IMA 錯誤代碼 1012

INVALID_AD_TAG

指定的廣告代碼網址無效。必須正確編碼。 IMA 錯誤代碼 1013

STREAM_INITIALIZATION_FAILED

伺服器端廣告插播期間串流時發生錯誤。IMA 錯誤代碼 1020

ASSET_FALLBACK_FAILED

素材資源備用廣告發生錯誤。 IMA 錯誤代碼 1021

INVALID_ARGUMENTS

提供給 SDK 方法的引數無效。IMA 錯誤代碼 1101

AUTOPLAY_DISALLOWED

瀏覽器不允許播放，而無需與使用者互動。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) 處理期間發生內部錯誤，如果無法提供這項資訊，則會傳回空值。這項錯誤可能是原生錯誤或 AdError (原生錯誤的子類別)。如果導致這個錯誤發生，則可能會傳回空值。

getMessage

getMessage() 傳回字串

傳回

string 這個錯誤的訊息。

getType

getType() 傳回字串

傳回

string 這個錯誤的類型，如 AdError.Type 所定義。

getVastErrorCode

getVastErrorCode() 傳回數字

傳回

number 如果可以取得 VAST 錯誤代碼，請傳回，否則會傳回 AdError.ErrorCode.UNKNOWN_ERROR。

toString

public

toString() 傳回字串

傳回

string