布萊特灣玩家錯誤參考
錯誤類型
本節將簡要描述六種主要的錯誤類型。您可以按一下錯誤類型,查看每種類型的特定錯誤 (如果適用)。
- 從錯誤插件分發的標準錯誤:這些錯誤名稱以MEDIA_ERR。
- 由Brightcove定義並從錯誤插件分發的自定義錯誤:這些錯誤名稱以PLAYER_ERR。
- 從視頻雲目錄中分發的錯誤:這些錯誤名稱以VIDEO_CLOUD_ERR。當然, Brightcove播放器客戶將永遠不會看到這些錯誤。
- 從HLS插件分發的錯誤:所有這些錯誤的類型相同, APPEND_BUFFER_ERR,然後從瀏覽器的本機錯誤中檢索該消息。
- 瀏覽器開發工具控制台中報告的錯誤:這些錯誤是面向開發人員的,因為它們只會在瀏覽器的控制台中看到。
- 用戶定義並由錯誤插件調度的自定義錯誤:這些錯誤名稱由用戶定義,例如AGE_GATE_ERROR。
- 網絡安全錯誤
標準錯誤
通常情況下,當試圖檢索或播放媒體出現問題時,會發生媒體錯誤。舉例來說,如果您的網路連線中斷,或是您收到無法解密的加密視訊,您將會收到媒體錯誤。有關完整的詳細信息,請參見標準錯誤的部分顯示錯誤消息插件文件。
代碼 | 類型 | 標題 | 訊息 |
---|---|---|---|
1 | MEDIA_ERR_ABORTED |
視訊下載已取消 | 您中止媒體播放。 |
2 | MEDIA_ERR_NETWORK |
視訊連線中斷,請確認您已連線至網際網路 | 網絡錯誤導致媒體下載部分失敗。當前對MP4和/或漸進式下載視頻格式最有幫助。見已知的問題的部分顯示錯誤消息插件有關詳細信息的文檔。 |
3 | MEDIA_ERR_DECODE |
視頻不正確或格式無法在瀏覽器中播放 | 由於損壞問題或瀏覽器不支持所使用的媒體功能,媒體播放被中止。 |
4 | MEDIA_ERR_SRC_NOT_SUPPORTED |
該視頻不可用或此瀏覽器不支持該視頻 | 無法載入媒體,可能是因為伺服器或網路故障或是因為不支援的格式所致。 |
5 | MEDIA_ERR_ENCRYPTED |
您嘗試觀看的視頻已加密,我們不知道如何解密 | 您嘗試觀看的影片已經加密,我們不知道如何解密。 |
未知 | MEDIA_ERR_UNKNOWN |
N/A | 遇到意想不到的問題,請稍後再次檢查,然後再試一次。 |
自訂錯誤
通常情況下,播放器錯誤發生在視頻載入時,由於某些原因無法播放。舉例來說,如果網域、地理位置或 IP 限制無法觀看影片,就會發生播放器錯誤。有關完整的詳細信息,請參見自定義錯誤的部分顯示錯誤消息插件文件。
代碼 | 訊息 | 描述 |
---|---|---|
-+1 | PLAYER_ERR_NO_SRC |
未載入任何視訊。 |
-+2 | PLAYER_ERR_TIMEOUT |
無法下載視頻,默認超時為 45 秒。 |
未設定 | PLAYER_ERR_DOMAIN_RESTRICTED |
此影片僅限於您目前的網域上播放。 |
未設定 | PLAYER_ERR_IP_RESTRICTED |
此影片僅限於您目前的 IP 位址。 |
未設定 | PLAYER_ERR_GEO_RESTRICTED |
此影片僅限於您目前的地理區域播放。 |
目錄錯誤
一般來說,當檢索或初始播放視頻或播放清單時出現問題時,目錄會拋出錯誤。舉例來說,如果您使用不存在的 ID,或是來自播放程式存在的其他帳戶中的 ID,若要擷取視訊,則會出現目錄錯誤。有關完整的詳細信息,請參見目錄錯誤的部分玩家目錄文件。
目錄錯誤 | 描述 |
---|---|
VIDEO_CLOUD_ERR_ACCOUNT_NOT_FOUND
|
播放器已設定為無效的視訊雲端帳號 ID。 |
VIDEO_CLOUD_ERR_RESOURCE_NOT_FOUND
|
預設播放清單 ID 無效。 |
VIDEO_CLOUD_ERR_VIDEO_NOT_FOUND
|
預設視訊無效。 |
VIDEO_CLOUD_ERR_NOT_PLAYABLE |
無法播放 Video Cloud 視訊。 導致此錯誤的常見原因包括何時停用視頻ID或預定的可用性已過期。 |
HLS 外掛程式錯誤
有關完整的詳細信息,請參見失誤的部分HLS插件文件。
HLS 外掛程式錯誤 | 描述 |
---|---|
APPEND_BUFFER_ERR |
流覽器拋出一個錯誤播放 HLS 視頻。 |
播放限制錯誤
有關與 Brightcove 播放限制相關的錯誤,請參閱播放限制錯誤參考文檔。
如果您不熟悉播放限制,請參閱概述:布萊特灣播放限制文件。
主控台錯誤
這些錯誤會出現在控制台中,看起來像這樣:
主控台訊息 | 解決方案 |
---|---|
VIDEOJS: ERROR: videojs-contrib-ads初始化5秒後未看到loadstart事件,但存在源。這表明視頻聯絡人廣告已初始化為時已晚。它必須在同一個刻度的 video.js 之後立即初始化。因此,部分廣告將無法播放,部分媒體活動也會不正確。如需詳細資訊,請參閱 https://github.com/videojs/videojs-contrib-ads#important-note-about-initialization
|
你看到這一點是因為 IM3 插件才能正常工作,它需要在播放器初始化後立即加載,然後再初始化任何其他插件。見使用代碼實施的部分IMA3插件解決方案的文檔。 |
自訂使用者錯誤
有關完整的詳細信息,請參見添加自定義錯誤的部分顯示錯誤消息插件文件。沒有標準的自訂使用者錯誤。
網絡安全錯誤
當您的網路安全性封鎖某些 Brightcove 網域和連接埠時,就會發生這些錯誤。
錯誤代碼 | 描述 |
---|---|
FLASHLS_ERR_CROSS_DOMAIN |
無法載入視訊:跨網域存取遭拒。 您可能需要一個crossdomain.xml文件位於播放列表文件的根目錄,該文件允許您請求的域(或'*')。 |
偵聽錯誤
您還可以使用在()
方法,使用以下方法:
myPlayer.on('error'), function () {
...
}
如果你正在播放廣告並且想捕獲所有錯誤,你需要使用這個:
myPlayer.on(['error','aderror')], function () {
...
}