當您使用Web播放器SDK播放視頻出現播放失敗、播放卡頓等播放異常現象時,您可以使用診斷工具輔助您排查原因,診斷工具診斷項覆蓋視頻播放的基礎資訊、網路資訊以及播放日誌等維度。本文為您介紹如何使用Web播放器SDK提供的診斷工具進行視頻診斷。
前提條件
為了視頻播放診斷更準確,需要進行以下設定:
-
開啟視頻播放網域名稱的Refer防盜鏈,並將
player.alicdn.com網域名稱添加到白名單。詳細操作,請參見配置IP黑白名單。說明player.alicdn.com為Aliplayer播放器的固定地址,請務必將此地址加入到白名單。在Refer防盜鏈設定彈窗中,允許通過瀏覽器地址欄直接存取資源URL複選框保持未勾選狀態,即不允許空 Referer 欄位訪問 CDN 資源。
-
在視頻播放網域名稱的HTTP訊息頭,添加允許跨域訪問的Access-Control-Allow-Origin。詳細操作,請參見關於跨域訪問配置說明。
操作步驟
-
開啟診斷工具。
您可以通過以下兩種方式開啟Aliplayer播放器的診斷工具:
-
當播放視頻出錯時,單擊診斷,跳轉到診斷工具頁面。當播放器出現播放錯誤時(如提示"擷取地址出錯啦"),錯誤介面會顯示重試和診斷兩個按鈕,單擊診斷按鈕即可開啟診斷工具。診斷介面會展示錯誤碼(
code)、視頻 ID(vid)、uuid、requestId及播放時間等資訊,用於排查問題。 -
直接存取診斷工具:診斷工具。
-
-
基礎資訊診斷。
在診斷資訊頁,將顯示使用者環境的作業系統、瀏覽器、IP地址和電訊廠商等。診斷結果頁麵包含診斷資訊和視頻播放兩個Tab。基礎資訊區塊展示系統(Windows NT 10.0)、瀏覽器(Chrome 90.0.4430.93)等欄位;網路資訊區塊展示圖片CDN狀態(成功)、指令碼CDN狀態(成功)、Local DNS、電訊廠商、Local IP、IP電訊廠商等欄位。
-
視頻播放診斷。
-
在視頻播放頁,選擇類型,即視頻的播放方式,提供了原生H5、阿里雲H5、阿里雲Flash這三種播放方式。
-
填寫Source參數(視頻播放地址),單擊播放,即可開始診斷。如果沒有Source參數,也可填寫Vid和playAuth參數。
說明Source參數的優先順序最高。
-
開始診斷時,播放頁面會顯示播放日誌。播放後,視頻地區左側會疊加顯示診斷事件日誌,包括開始播放(play)、等待資料(waiting)、開始請求資料(loadstart)、正在請求資料(progress)、來源資料載入完成(loadedmetadata)、當前幀的資料已載入(loadeddata)、載入部分可以播放(canplay)、全部載入完畢(canplaythrough)、暫停播放(pause)、播放結束(ended)等事件及對應時間戳記。
-