在 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()，以確定媒體追蹤工作階段已關閉。