使用JavaScript 2.x追蹤體驗品質

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

實作 QoS

1. 識別媒體播放期間位元速率是否變更，並且利用 QoS 資訊建立 MediaObject 例項。

   QoSObject 變數:

   秘訣

   唯有在您計劃追蹤 QoS 時，才須使用這些變數。

   變數	說明	必填
   bitrate	目前位元速率	是
   startupTime	啟動時間	是
   fps	FPS 值	是
   droppedFrames	掉格的數量	是

   QoS 物件建立:

   // Replace <bitrate>, <startuptime>, <fps> and
   // <droppeFrames> with the current playback QoS values.
   var qosObject = MediaHeartbeat.createQoSObject(<bitrate>,
                                                  <startuptime>,
                                                  <fps>,
                                                  <droppedFrames>);
   

2. 當播放轉換位元速率時，呼叫媒體心率例項中的 BitrateChange 事件:

   _onBitrateChange = function() {
       this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.BitrateChange, qosObject);
   };
   

   重要

   更新 QoS 物件，並在每次位元速率變更時呼叫位元速率變更事件。如此可提供最精確的 QoS 資料。

3. 請確定 getQoSObject() 方法會傳回最新的 QoS 資訊。

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

   秘訣

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