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

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

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

   ChapterObject 章節追蹤參考資料：

   注意

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

   變數名稱	說明	必填
   name	章節名稱	是
   position	章節位置	是
   length	章節長度	是
   startTime	章節開始時間	是

   章節物件：

   var chapterInfo =
     MediaHeartbeat.createChapterObject(<CHAPTER_NAME>,
                                        <POSITION>,
                                        <LENGTH>,
                                        <START_TIME>);
   

2. 如果您包含該章節的自訂中繼資料，請為中繼資料建立內容資料變數：

   var chapterCustomMetadata = {
       segmentType: "Sample segment type",
       segmentName: "Sample segment name",
       segmentInfo: "Sample segment info"
   };
   

3. 若要開始追蹤章節播放，請呼叫 ChapterStart 例項中的 MediaHeartbeat 事件：

   _onChapterStart = function() {
       this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.ChapterStart,
                                       chapterObject,
                                       chapterCustomMetadata);
   };
   

4. 當播放達到由您的自訂程式碼定義之章節結束界限時，請呼叫 ChapterComplete 例項中的 MediaHeartbeat 事件：

   _onChapterComplete = function() {
      this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.ChapterComplete);
   };
   

5. 如果因為使用者選擇略過章節而未完成章節播放 (例如，如果使用者搜尋超出章節界限)，請呼叫 MediaHeartbeat 例項中的 ChapterSkip 事件：

   _onChapterSkip = function() {
       this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.ChapterSkip);
   };
   

6. 如果有任何其他章節，請重複步驟 1 到 5。