在 Roku 上追蹤體驗品質 track-quality-of-experience-on-roku
下列指示提供所有 2.x SDK 之間實作的指引。
IMPORTANT
若您正在實作 SDK 1.x 版,您可以在此處下載 1.x 開發人員指南:下載 SDK。
實作 QoS
-
識別媒體播放期間位元速率是否變更,並且利用
mediaUpdateQoS
API 更新 Media SDK 上的 QoS 資訊。QoSObject 變數:
note tip TIP 只有在追蹤 QoS 時,才須使用這些變數。 table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 3-align-center 7-align-center 11-align-center 15-align-center 19-align-center 變數 說明 必填 bitrate
目前位元速率 是 startupTime
啟動時間 是 fps
FPS 值 是 droppedFrames
掉格的數量 是 例如:
code language-none bitrate = 200000 fps = 0 droppedFrames = 1 startupTime = 2 qosinfo = adb_media_init_qosinfo(bitrate, startupTime, fps, droppedFrames) ADBMobile().mediaUpdateQoS(qosinfo)
-
當播放轉換位元速率時,請呼叫
trackEvent(BitrateChange)
,通知 Media SDK 位元速率已變更。code language-none ADBMobile().mediaTrackEvent(ADBMobile().MEDIA_BITRATE_CHANGE)
note note NOTE 您必須使用更新的位元速率值來呼叫 updateQoSObject
。 -
當媒體播放器發生錯誤,且播放器 API 可使用錯誤事件時,請利用
trackError()
來擷取錯誤資訊(請參閱概觀)。note tip TIP 追蹤媒體播放器錯誤將不會停止媒體追蹤工作階段。如果媒體播放器錯誤使得播放無法繼續,請透過在呼叫 trackError()
之後呼叫trackSessionEnd()
,以確定媒體追蹤工作階段已關閉。
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb