使用 JavaScript 2.x 追蹤體驗品質 track-quality-of-experience-on-javascript
下列指示提供所有 2.x SDK 之間實作的指引。
IMPORTANT
若您正在實作 SDK 1.x 版,您可以在此處下載 1.x 開發人員指南:下載 SDK。
實作 QoS
-
識別媒體播放期間位元速率是否變更,並且利用 QoS 資訊建立
MediaObject
例項。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
掉格的數量 是 QoS 物件建立:
code language-js // Replace <bitrate>, <startuptime>, <fps> and // <droppeFrames> with the current playback QoS values. var qosObject = MediaHeartbeat.createQoSObject(<bitrate>, <startuptime>, <fps>, <droppedFrames>);
-
當播放轉換位元速率時,呼叫媒體心率例項中的
BitrateChange
事件:code language-js _onBitrateChange = function() { this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.BitrateChange, qosObject); };
note important IMPORTANT 更新 QoS 物件,並在每次位元速率變更時呼叫位元速率變更事件。如此可提供最精確的 QoS 資料。 -
請確定
getQoSObject()
方法會傳回最新的 QoS 資訊。 -
當媒體播放器發生錯誤,且播放器 API 可使用錯誤事件時,請利用
trackError()
來擷取錯誤資訊(請參閱概觀)。note tip TIP 追蹤媒體播放器錯誤將不會停止媒體追蹤工作階段。如果媒體播放器錯誤使得播放無法繼續,請透過在呼叫 trackError()
之後呼叫trackSessionEnd()
,以確定媒體追蹤工作階段已關閉。
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb