使用JavaScript 3.x跟踪体验质量

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

重要

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

实施QOE

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

    QoEObject变量:

    小贴士

    只有在您打算跟踪 QoS 的情况下,才需要使用这些变量。

    变量 类型 描述
    bitrate 数字 当前比特率
    startupTime 数字 开始时间
    fps 数字 FPS 值
    droppedFrames 数字 丢帧的数量

    QoE对象创建:

    // 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 事件。

    _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);
    };
    
    重要

    更新QoE对象,并在每次比特率更改时调用比特率更改事件。 这可提供最准确的QoE数据。

  3. 确保调用updateQoEObject()方法以向SDK提供最新的QoE信息。

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

    小贴士

    跟踪媒体播放器错误不会停止媒体跟踪会话。如果媒体播放器错误导致无法继续播放,请确保通过调用 trackSessionEnd() 后调用 trackError() 来关闭媒体跟踪会话。

在此页面上