概述

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

体验质量跟踪包括服务质量 (QoS) 和错误跟踪，在核心媒体跟踪实施中，这两项跟踪都是可选元素，而​不是​必需元素。您可以使用媒体播放器 API 来识别与 QoS 和错误跟踪相关的变量。以下是体验质量跟踪的关键元素：

播放器事件

在任何 QoS 量度发生更改时：

为播放创建或更新 QoS 对象实例。QoS API 引用

在发生所有比特率更改事件时

调用 trackEvent(Media.Heartbeat.Event.BitrateChange);

实施 QoS

1. 识别在媒体播放期间任何 QoS 量度发生更改的时间，使用 QoS 信息创建 MediaObject，并更新新的 QoS 信息。

   QoSObject 变量：

   小贴士

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

   变量	描述	必需
   bitrate	当前比特率	是
   startupTime	开始时间	是
   fps	FPS 值	是
   droppedFrames	丢帧的数量	是

2. 确保 getQoSObject() 方法返回最新的 QoS 信息。

3. 在播放期间，当比特率发生更改时，在 MediaHeartbeat 实例中调用 BitrateChange 事件。

   重要

   请更新 QoS 对象并在每次比特率发生更改时调用比特率更改事件。这样将可以提供最为准确的 QoS 数据。

以下代码示例为 HTML5 媒体播放器使用 JavaScript 2.x SDK。您应该结合使用此代码与核心媒体播放代码。

var mediaDelegate = new MediaHeartbeatDelegate();
...

// This is called periodically by MediaHeartbeat instance
mediaDelegate.prototype.getQoSObject = function() {
    return this.qosInfo;
};

if (e.type == "qos_update") {
    var qosInfo = MediaHeartbeat.createQoSObject(<BITRATE>,<STARTUP_TIME>,<FPS>,<DROPPED_FRAMES>);
    mediaDelegate.qosInfo = qosInfo;
};

if (e.type == "bitrate_change") {
    this.mediaHeartbeat.trackEvent(MediaHeartbeat.Event.BitrateChange, qosObject);
};

Business.Adobe.com 资源