在 Roku 上追蹤體驗品質

下列指示提供所有 2.x SDK 之間實作的指引。

重要

若您正在實作 SDK 1.x 版，您可以在此處下載 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() 來擷取錯誤資訊(請參閱概述)。

秘訣

追蹤媒體播放器錯誤將不會停止媒體追蹤工作階段。如果媒體播放器錯誤使得播放無法繼續，請透過在呼叫 trackError() 之後呼叫 trackSessionEnd()，以確定媒體追蹤工作階段已關閉。