在 iOS 上追蹤章節和區段

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

重要

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

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

    ChapterObject 章節追蹤參考資料：

    注意

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

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

    章節物件：

    id chapterObject =
  [ADBMediaHeartbeat createChapterObjectWithName:[CHAPTER_NAME]
                     position:[POSITION]
                     length:[LENGTH]
                     startTime:[START_TIME]];

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

    NSMutableDictionary *chapterDictionary = [[NSMutableDictionary alloc] init];
[chapterDictionary setObject:@"Sample segment type" forKey:@"segmentType"];
[chapterDictionary setObject:@"Sample segment name" forKey:@"segmentName"];
[chapterDictionary setObject:@"Sample segment info" forKey:@"segmentInfo"];

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

    - (void)onChapterStart:(NSNotification *)notification {
    [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventChapterStart
                     mediaObject:chapterObject
                     data:chapterDictionary];
}

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

    - (void)onChapterComplete:(NSNotification *)notification {
    [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventChapterComplete
                     mediaObject:nil
                     data:nil];
}

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

    - (void)onChapterSkip:(NSNotification *)notification {
    [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventChapterSkip
                     mediaObject:nil
                     data:nil];
}

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

本頁內容