在 Roku 中跟踪体验质量

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

重要

如果您实施的是 1.x 版本的 SDK，可以在此处下载 1.x 开发人员指南：下载 SDK。

实施 QoS

识别在媒体播放期间比特率发生更改的时间，并使用 mediaUpdateQoS API 来更新 Media SDK 中的 QoS 信息。

QoSObject 变量：

小贴士

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

变量描述必需

bitrate 当前比特率是

startupTime 开始时间是

fps FPS 值是

droppedFrames 丢帧的数量是

例如：
```
bitrate = 200000
fps = 0
droppedFrames = 1
startupTime = 2
qosinfo = adb_media_init_qosinfo(bitrate, startupTime, fps, droppedFrames)

ADBMobile().mediaUpdateQoS(qosinfo)
```
当播放切换比特率时，调用 trackEvent(BitrateChange) 来通知 Media SDK 比特率已发生更改。
```
ADBMobile().mediaTrackEvent(ADBMobile().MEDIA_BITRATE_CHANGE)
```
注意

您需要使用更新的比特率值调用 updateQoSObject。
当媒体播放器遇到错误，并且错误事件可用于播放器 API 时，使用 trackError() 来捕获错误信息。（请参阅概述。）

小贴士

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