全部產品
Search
文件中心

ApsaraVideo Live:SDK品質監控

更新時間:Feb 18, 2025

如果您的應用使用阿里雲播放器SDK播放視頻,您可以通過直播播放資料服務瞭解當前應用的播放服務品質。播放資料服務依賴阿里雲播放器SDK上報的埋點資料提供的播放成功率、秒開率、卡頓率等指標,協助您快速瞭解直播播放品質情況。本文介紹查看播放資料的操作方法。

工作原理

直播播放資料服務依賴阿里雲播放器SDK上報的埋點資料,埋點邏輯如下圖所示:

image.png

使用說明

  1. 請使用MediaBox音視頻SDK並確保License有效且開啟日期上報功能。

  2. 支援Native端播放器SDK 5.4.9.2及以上版本。

  3. 支援Web端播放器SDK 2.16.0及以上版本。

  4. 播放器SDK下載請參見SDK簡介與下載,SDK授權請參見License管理

查看播放資料

  1. 登入ApsaraVideo for Live控制台
  2. 在左側導覽列選擇資料中心 > 資料監控 > SDK品質監控

  3. 播放資料頁簽選擇應用程式名稱,單擊查詢

    說明

    應用程式名稱需與申請阿里雲播放器SDK License授權時配置的應用標題一致,否則無法查詢到相應資料。

    支援按以下維度篩選查詢資料:

    • 支援按終端類型、系統類別型、解析度、網路類型篩選查詢資料。

    • 支援查詢近1小時至近3日內的自訂時段資料,單次查詢時間範圍暫不支援跨日篩選。

    • 支援按SDK版本、編碼格式、視頻格式、是否硬解、電訊廠商、網域名稱、省份篩選查詢資料,通過單擊新增過濾條件實現,並可將常用的過濾規則儲存下來供後續直接選用。

  4. 應用概覽提供了QoS透視資料,QoS指標可以瞭解當前應用的播放服務品質。各指標項說明如下:

    說明

    平均播放幀率(fps)指標僅可使用視訊情境,其他指標支援音視頻或純音頻情境。

    指標項

    指標項說明

    平均首幀耗時(毫秒)

    使用者從發起播放請求到首幀完成播放的時間。

    時間長度卡頓率(%)

    播放過程中出現卡頓的總時間長度占播放時間長度比例,即卡頓時間長度/播放時間長度。

    平均播放幀率(fps)

    直播播放過程中視訊框架渲染的幀率。

    下行網路碼率(Kbps)

    直播播放過程中網路下行速率。

    秒開率(%)

    直播流1s內起播的佔比,即≤1s起播直播數/全部播放數。

    慢開率(%)

    直播流超過3s起播的佔比,即≥3s起播直播數/全部播放數。

    播放成功率(%)

    播放成功數佔全部播放數的比例,即播放成功數/全部播放數。

    cpu使用率(%)

    直播播放過程中CPU的使用率。

單點追查

使用阿里雲播放器SDK播放視頻發生異常時,您可以藉助單點追查功能對具體使用者或播放會話的異常行為進行全鏈路追蹤,快速診斷問題原因,改善播放體驗。

  1. 登入ApsaraVideo for Live控制台
  2. 在左側導覽列選擇資料中心 > 資料監控 > SDK品質監控,進入直播SDK品質監控頁面。

  3. 單擊單點追查頁簽,輸入建立播放器時透傳的TraceID或UUID進行查詢。

    image

  4. 單擊操作列的查看詳情,可查看播放會話的詳細資料。

相關文檔

播放器SDK