全部產品
Search
文件中心

ApsaraVideo VOD:如何使用Web播放器SDK診斷工具

更新時間:May 21, 2026

當您使用Web播放器SDK播放視頻出現播放失敗、播放卡頓等播放異常現象時,您可以使用診斷工具輔助您排查原因,診斷工具診斷項覆蓋視頻播放的基礎資訊、網路資訊以及播放日誌等維度。本文為您介紹如何使用Web播放器SDK提供的診斷工具進行視頻診斷。

前提條件

為了視頻播放診斷更準確,需要進行以下設定:

  • 開啟視頻播放網域名稱的Refer防盜鏈,並將player.alicdn.com網域名稱添加到白名單。詳細操作,請參見配置IP黑白名單

    說明

    player.alicdn.com為Aliplayer播放器的固定地址,請務必將此地址加入到白名單。

    Refer防盜鏈設定彈窗中,允許通過瀏覽器地址欄直接存取資源URL複選框保持未勾選狀態,即不允許空 Referer 欄位訪問 CDN 資源。

  • 在視頻播放網域名稱的HTTP訊息頭,添加允許跨域訪問的Access-Control-Allow-Origin。詳細操作,請參見關於跨域訪問配置說明

操作步驟

  1. 開啟診斷工具。

    您可以通過以下兩種方式開啟Aliplayer播放器的診斷工具:

    • 當播放視頻出錯時,單擊診斷,跳轉到診斷工具頁面當播放器出現播放錯誤時(如提示"擷取地址出錯啦"),錯誤介面會顯示重試診斷兩個按鈕,單擊診斷按鈕即可開啟診斷工具。診斷介面會展示錯誤碼(code)、視頻 ID(vid)、uuidrequestId 及播放時間等資訊,用於排查問題。

    • 直接存取診斷工具:診斷工具

  2. 基礎資訊診斷。

    診斷資訊頁,將顯示使用者環境的作業系統、瀏覽器、IP地址和電訊廠商等。診斷結果頁麵包含診斷資訊視頻播放兩個Tab。基礎資訊區塊展示系統(Windows NT 10.0)、瀏覽器(Chrome 90.0.4430.93)等欄位;網路資訊區塊展示圖片CDN狀態(成功)、指令碼CDN狀態(成功)、Local DNS、電訊廠商、Local IP、IP電訊廠商等欄位。

  3. 視頻播放診斷。

    1. 視頻播放頁,選擇類型,即視頻的播放方式,提供了原生H5阿里雲H5阿里雲Flash這三種播放方式。

    2. 填寫Source參數(視頻播放地址),單擊播放,即可開始診斷。如果沒有Source參數,也可填寫Vid和playAuth參數。

      說明

      Source參數的優先順序最高。

    3. 開始診斷時,播放頁面會顯示播放日誌。播放後,視頻地區左側會疊加顯示診斷事件日誌,包括開始播放(play)、等待資料(waiting)、開始請求資料(loadstart)、正在請求資料(progress)、來源資料載入完成(loadedmetadata)、當前幀的資料已載入(loadeddata)、載入部分可以播放(canplay)、全部載入完畢(canplaythrough)、暫停播放(pause)、播放結束(ended)等事件及對應時間戳記。

相關文檔

錯誤碼