在 Roku 上追蹤體驗品質 track-quality-of-experience-on-roku

下列指示提供所有 2.x SDK 之間實作的指引。

IMPORTANT
若您正在實作 SDK 1.x 版,您可以在此處下載 1.x 開發人員指南:下載 SDK

實作 QoS

  1. 識別媒體播放期間位元速率是否變更,並且利用 mediaUpdateQoS API 更新 Media SDK 上的 QoS 資訊。

    QoSObject 變數:

    note tip
    TIP
    只有在追蹤 QoS 時,才須使用這些變數。
    table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 3-align-center 7-align-center 11-align-center 15-align-center 19-align-center
    變數 說明 必填
    bitrate 目前位元速率
    startupTime 啟動時間
    fps FPS 值
    droppedFrames 掉格的數量

    例如:

    code language-none
    bitrate = 200000
    fps = 0
    droppedFrames = 1
    startupTime = 2
    qosinfo = adb_media_init_qosinfo(bitrate, startupTime, fps, droppedFrames)
    
    ADBMobile().mediaUpdateQoS(qosinfo)
    
  2. 當播放轉換位元速率時,請呼叫 trackEvent(BitrateChange),通知 Media SDK 位元速率已變更。

    code language-none
    ADBMobile().mediaTrackEvent(ADBMobile().MEDIA_BITRATE_CHANGE)
    
    note note
    NOTE
    您必須使用更新的位元速率值來呼叫 updateQoSObject
  3. 當媒體播放器發生錯誤,且播放器 API 可使用錯誤事件時,請利用 trackError() 來擷取錯誤資訊(請參閱概觀)。

    note tip
    TIP
    追蹤媒體播放器錯誤將不會停止媒體追蹤工作階段。如果媒體播放器錯誤使得播放無法繼續,請透過在呼叫 trackError() 之後呼叫 trackSessionEnd(),以確定媒體追蹤工作階段已關閉。
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb