概述 overview
以下说明为所有 2.x SDK 实施提供了指南。
IMPORTANT
如果您实施的是 1.x 版本的 SDK，可以在此处下载 1.x 开发人员指南：下载 SDK。
体验质量跟踪包括服务质量 (QoS) 和错误跟踪，在核心媒体跟踪实施中，这两项跟踪都是可选元素，而 不是 必需元素。您可以使用媒体播放器 API 来识别与 QoS 和错误跟踪相关的变量。以下是体验质量跟踪的关键元素：
播放器事件 player-events
在任何 QoS 量度发生更改时：
为播放创建或更新 QoS 对象实例。QoS API 引用
在发生所有比特率更改事件时
调用 trackEvent(Media.Heartbeat.Event.BitrateChange);
实施QOS
-
识别在媒体播放期间任何 QoS 量度发生更改的时间，使用 QoS 信息创建
MediaObject，并更新新的 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开始时间 是 fpsFPS 值 是 droppedFrames丢帧的数量 是 -
确保
getQoSObject()方法返回最新的 QoS 信息。 -
在播放期间，当比特率发生更改时，在 MediaHeartbeat 实例中调用
BitrateChange事件。note important IMPORTANT 请更新 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);
};
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb