概觀 overview
下列指示提供所有 2.x SDK 之間實作的指引。
IMPORTANT
若您正在實作 SDK 1.x 版，您可以在此處下載 1.x 開發人員指南：下載 SDK。
體驗品質追蹤包含服務品質 (QoS) 和錯誤追蹤，此兩項皆為選用元素，且 不是 核心媒體追蹤實作的必要元素。您可以使用媒體播放器 API 識別 QoS 相關的變數以及錯誤追蹤。以下為追蹤體驗品質的重要元素：
播放器事件 player-events
對於任何 QoS 量度變更：
建立或更新播放適用的 QoS 物件例項。QoS API 參考資料
所有位元速率變更事件
呼叫 trackEvent(Media.Heartbeat.Event.BitrateChange);
實作QOS
-
識別媒體播放中何時有任何 QoS 量度變更，並利用 QoS 資訊建立
MediaObject，以及更新新的 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啟動時間 是 fpsFPS 值 是 droppedFrames掉格的數量 是 -
請確定
getQoSObject()方法會傳回最新的 QoS 資訊。 -
當播放轉換位元速率時，呼叫媒體心率例項中的
BitrateChange事件。note important IMPORTANT 更新 QoS 物件，並在每次位元速率變更時呼叫位元速率變更事件。如此可提供最精確的 QoS 資料。
以下程式碼範例將 JavaScript 2.x SDK 用於 HTML5 媒體播放器。您應該將此程式碼與核心媒體播放程式碼一起使用。
var mediaDelegate = new MediaHeartbeatDelegate();
...
// This is called periodically by MediaHeartbeat instance
mediaDelegate.prototype.getQoSObject = function() {
return this.qosInfo;
};
if (e.type == "qos_update") {
var qosInfo = MediaHeartbeat.createQoSObject(<BITRATE>,<STARTUP_TIME>,<FPS>,<DROPPED_FRAMES>);
mediaDelegate.qosInfo = qosInfo;
};
if (e.type == "bitrate_change") {
this.mediaHeartbeat.trackEvent(MediaHeartbeat.Event.BitrateChange, qosObject);
};
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb