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

以下说明为所有 2.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() 来关闭媒体跟踪会话。