Show Menu
主题×

在 JavaScript 中跟踪体验质量

下面的说明为所有 2.x SDK 实施提供了指南。如果您实施的是 1.x 版本的 SDK,可以在此处下载 1.x 开发人员指南: 下载 SDK

实施 QoS

  1. 识别在媒体播放期间比特率发生更改的时间,并使用 QoS 信息创建
    MediaObject
    实例。
    QoSObject 变量:
    只有在您打算跟踪 QoS 的情况下,才需要使用这些变量。
    变量
    描述
    必需
    bitrate
    当前比特率
    startupTime
    开始时间
    fps
    FPS 值
    droppedFrames
    丢帧的数量
    QoS 对象创建:
    // Replace <bitrate>, <startuptime>, <fps> and // <droppeFrames> with the current playback QoS values. var qosObject = MediaHeartbeat.createQoSObject(<bitrate>, <startuptime>, <fps>, <droppedFrames>);
  2. 在播放期间,当比特率发生更改时,在 MediaHeartbeat 实例中调用
    BitrateChange
    事件。
    _onBitrateChange = function() { this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.BitrateChange, qosObject); };
    请更新 QoS 对象并在每次比特率发生更改时调用比特率更改事件。这样将可以提供最为准确的 QoS 数据。
  3. 确保
    getQoSObject()
    方法返回最新的 QoS 信息。
  4. 当媒体播放器遇到错误,并且错误事件可用于播放器 API 时,使用
    trackError()
    来捕获错误信息。(请参阅 概述 。)
    跟踪媒体播放器错误不会停止媒体跟踪会话。如果媒体播放器错误导致无法继续播放,请确保通过调用
    trackSessionEnd()
    后调用
    trackError()
    来关闭媒体跟踪会话。