在 Roku 上追蹤體驗品質

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

實作 QoS

1. 識別媒體播放期間位元速率是否變更，並且利用 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)
   

2. 當播放轉換位元速率時，請呼叫 trackEvent(BitrateChange)，通知 Media SDK 位元速率已變更。

   ADBMobile().mediaTrackEvent(ADBMobile().MEDIA_BITRATE_CHANGE)
   

   注意

   您必須使用更新的位元速率值來呼叫 updateQoSObject。

3. 當媒體播放器發生錯誤，且播放器 API 可使用錯誤事件時，請利用 trackError() 來擷取錯誤資訊(請參閱概觀)。

   秘訣

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