當使用阿里云播放器SDK播放視頻發生異常時,可借助單點追查功能針對具體某個用戶或某次播放會話的異常播放行為進行全鏈路追蹤,以便您能快速診斷問題原因,可有效改善播放體驗治理效率。
前提條件
使用單點追查功能之前,您需要作如下準備:
僅支持下述版本的阿里云播放器SDK使用單點追查功能:5.4.9.2及以上版本的Android播放器SDK或iOS播放器SDK、2.16.0及以上版本的Web播放器SDK。最新版播放器SDK下載請參見播放器SDK。
Android播放器SDK或iOS播放器SDK需要獲取有效License,詳情請參見獲取License;Web播放器SDK需要申請開通播放質量監控增值服務后,再接入License,申請和接入License的方法請參見接口說明中的
license
屬性。請確保阿里云播放器SDK的埋點日志上報功能已開啟,正常情況下,阿里云播放器SDK的埋點日志上報功能為默認開啟的。
務必要在創建播放器時就透傳traceId,用于識別用戶身份,否則將無法使用單點追查功能。透傳方式請參見Android播放器基礎功能、iOS播放器基礎功能、Web播放器接口說明。
系統播放器、第三方(非阿里云)播放器、阿里云播放器非Android或iOS端或Web端均不支持單點追查功能。
使用限制
當前僅支持查詢最新10000條會話,超出部分則不會在控制臺顯示。
僅支持查詢最近3日內的播放數據。
操作步驟
登錄視頻點播控制臺。
在點播控制臺左側導航欄的數據中心區域,單擊單點追查,進入單點追查頁面。
查詢播放會話記錄。
在請輸入客戶追蹤號的輸入框中,輸入創建播放器時透傳的用于標識用戶的traceId,精確查詢某個用戶或某臺設備的播放會話記錄。
通過時間(最近3日內)、播放類型(點播和直播)、狀態(播放完成、播放中、播放異常)等篩選查詢播放會話記錄。
單擊查看詳情,查看播放會話的詳細信息。
相關文檔
更多關于使用阿里云播放器SDK的常見問題及修復建議,請參見播放器SDK常見問題。