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단계를 반복합니다.

이 페이지에서는