使用單點追查快速診斷視頻播放異常原因 - ApsaraVideo VOD

當使用阿里雲播放器SDK播放視頻發生異常時，可藉助單點追查功能針對具體某個使用者或某次播放會話的異常播允許存取為進行全鏈路追蹤，以便您能快速診斷問題原因，可有效改善播放體驗治理效率。

前提條件

使用單點追查功能之前，您需要作如下準備：

僅支援下述版本的阿里雲播放器SDK使用單點追查功能：5.4.9.2及以上版本的Android播放器SDK或iOS播放器SDK、2.16.0及以上版本的Web播放器SDK。立即下載播放器SDK。
Android、iOS、Web播放器SDK需要擷取有效License，詳情請參見擷取License。
請確保阿里雲播放器SDK的埋點日誌上報功能已開啟，正常情況下，阿里雲播放器SDK的埋點日誌上報功能為預設開啟的。
務必要在建立播放器時就透傳traceId，用於識別使用者身份，否則將無法使用單點追查功能。透傳方式請參見Android播放器基礎功能、iOS播放器基礎功能、Web播放器介面說明。

重要

系統播放器、第三方（非阿里雲）播放器、阿里雲播放器非Android或iOS端或Web端均不支援單點追查功能。

登入ApsaraVideo for VOD控制台。
在點播控制台左側導覽列的数据中心地區，單擊单点追查，進入單點追查頁面。
查詢播放會話記錄。
- 在請輸入客戶追蹤號的輸入框中，輸入建立播放器時透傳的用於標識使用者的traceId，精確查詢某個使用者或某台裝置的播放會話記錄。
- 通過時間（最近3日內）、播放類型（點播和直播）、狀態（播放完成、播放中、播放異常）等篩選查詢播放會話記錄。
單擊查看详情，查看播放會話的詳細資料。

播放詳情頁麵包含三個地區：基礎資訊地區展示應用程式名稱、播放時間、用戶端IP、裝置系統、網路類型、裝置類型、SessionId、SDK版本號碼等欄位；播放資訊地區展示首幀時間長度、網路卡頓次數、網路卡頓時間長度、狀態、編碼通訊協定、是否硬解、關閉前播放進度、解析度、幀率、視頻檔案碼率等指標；底部事件列表按時間軸記錄播放過程中的各類事件，包含主題、事件、耗時（毫秒）、發生時間、詳細資料等列。