在 Roku 中跟踪体验质量 track-quality-of-experience-on-roku

以下说明为所有 2.x SDK 实施提供了指南。

IMPORTANT
如果您实施的是 1.x 版本的 SDK,可以在此处下载 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
    跟踪媒体播放器错误不会停止媒体跟踪会话。如果媒体播放器错误导致无法继续播放,请确保通过调用 trackSessionEnd() 后调用 trackError() 来关闭媒体跟踪会话。
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb