使用 JavaScript 3.x 跟踪体验质量 track-quality-of-experience-on-javascript

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

IMPORTANT
如果您实施的是 SDK 之前的版本,可以在此处下载开发人员指南:下载 SDK

实施 QOE

  1. 识别在媒体播放期间比特率发生更改的时间,并使用 QoE 信息创建 qoeObject 实例。

    QoEObject 变量:

    note tip
    TIP
    只有在您打算跟踪 QoS 的情况下,才需要使用这些变量。
    table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
    变量 类型 描述
    bitrate 数字 当前比特率
    startupTime 数字 开始时间
    fps 数字 FPS 值
    droppedFrames 数字 丢帧的数量

    QoE 对象创建:

    code language-js
    // Replace <bitrate>, <startuptime>, <fps> and
    // <droppeFrames> with the current playback QoE values.
    var qoeObject = ADB.Media.createQoEObject(<bitrate>,
                                                   <startuptime>,
                                                   <fps>,
                                                   <droppedFrames>);
    tracker.updateQoEObject(qoeObject);
    
  2. 在播放期间,当比特率发生更改时,在 MediaHeartbeat 实例中调用 BitrateChange 事件。

    code language-js
    _onBitrateChange = function() {
        // If the new bitrate value is available provide it to the tracker.
        var qoeObject = ADB.Media.createQoEObject(1000000, 2.4, 25, 10);
        tracker.updateQoEObject(qoeObject);
    
        tracker.trackEvent(ADB.Media.Event.BitrateChange);
    };
    
    note important
    IMPORTANT
    请更新 QoE 对象并在每次比特率发生更改时调用比特率更改事件。这样将可以提供最为准确的 QoE 数据。
  3. 确保调用 updateQoEObject() 方法以向 SDK 提供最新的 QoE 信息。

  4. 当媒体播放器遇到错误,并且错误事件可用于播放器 API 时,使用 trackError() 来捕获错误信息。(请参阅概述。)

    note tip
    TIP
    跟踪媒体播放器错误不会停止媒体跟踪会话。如果媒体播放器错误导致无法继续播放,请确保通过调用 trackSessionEnd() 后调用 trackError() 来关闭媒体跟踪会话。
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb