使用JavaScript 3.x追蹤章節和區段

下列指示提供使用 3.x SDK 實作的指引。

重要

若您正在實作任何舊版SDK,您可以在此處下載開發人員指南:下載SDK。

  1. 識別章節開始事件何時發生,並使用章節資訊建立 ChapterObject 例項。

    ChapterObject 章節追蹤參考資料:

    注意

    唯有在您計劃追蹤章節時,才須使用這些變數。

    變數名稱 類型 說明
    name 字串 表示章節名稱的非空字串。
    position 數字 章節在內容內的位置,從1開始。
    length 數字 表示章節長度的正數。
    startTime 數字 章節開始時的播放點值。

    章節物件:

    var chapterObject =
      ADB.Media.createChapterObject.createChapterObject(<CHAPTER_NAME>,
                                         <POSITION>,
                                         <LENGTH>,
                                         <START_TIME>);
    
  2. 如果您包含該章節的自訂中繼資料,請為中繼資料建立內容資料變數:

    var chapterMetadata = {};
    chapterMetadata["segmentType"] = "Sample segment type";
    
  3. 若要開始追蹤章節播放,請呼叫 ChapterStart 例項中的 MediaHeartbeat 事件:

    _onChapterStart = function() {
      tracker.trackEvent(ADB.Media.Event.ChapterStart, chapterObject, chapterMetadata);
    
    };
    
  4. 當播放達到由您的自訂程式碼定義之章節結束界限時,請呼叫 ChapterComplete 例項中的 MediaHeartbeat 事件:

    _onChapterComplete = function() {
       tracker.trackEvent(ADB.Media.Event.ChapterComplete);
    };
    
  5. 如果因為使用者選擇略過章節而未完成章節播放 (例如,如果使用者搜尋超出章節界限),請呼叫 MediaHeartbeat 例項中的 ChapterSkip 事件:

    _onChapterSkip = function() {
        tracker.trackEvent(ADB.Media.Event.ChapterSkip);
    };
    
  6. 如果有任何其他章節,請重複步驟 1 到 5。

本頁內容