文件Analytics串流媒體收集指南

在 Chromecast 上追蹤體驗品質 track-quality-of-experience-on-chromecast

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • 使用者
  • 管理員
  • 開發人員

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

IMPORTANT
若您正在實作 SDK 1.x 版，您可以在此處下載 1.x 開發人員指南：下載 SDK。

概觀 overview

體驗品質追蹤包含服務品質 (QoS) 和錯誤追蹤，此兩項皆為選用元素，且​ 不是 ​核心媒體追蹤實作的必要元素。您可以使用媒體播放器 API 識別 QoS 相關的變數以及錯誤追蹤。

播放器事件 player-events

所有位元速率變更事件

  • 建立/更新播放適用的 QoS 物件例項，qosObject
  • 呼叫 trackEvent(Media.Heartbeat.Event.BitrateChange, qosObject);

播放器錯誤

呼叫 trackError("media error id");

實作 implement

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

    code language-none 
    qosInfo = ADBMobile.media.createQoSObject(50000, 0, 24, 10);

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

    code language-none 
    ADBMobile.media.trackEvent(ADBMobile.media.Event.BitrateChange);
    note important
    IMPORTANT
    更新 QoS 物件，並在每次位元速率變更時呼叫位元速率變更事件。如此可提供最精確的 QoS 資料。

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

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

    note tip
    TIP
    追蹤媒體播放器錯誤將不會停止媒體追蹤工作階段。如果媒體播放器錯誤使得播放無法繼續，請透過在呼叫 trackError() 之後呼叫 trackSessionEnd()，以確定媒體追蹤工作階段已關閉。
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb