스냅백

동영상 게시자는 시청자가 미드롤 광고를 시청해 보지 못하도록 하는 것이 좋습니다. 사용자가 광고 시점을 지나 탐색하면 광고 시점의 시작 부분으로 돌아가고 광고 시간이 끝나면 탐색 위치로 돌아갈 수 있습니다. 이 기능을 '스냅백'이라고 합니다.

아래 다이어그램에서 예시를 참조하세요. 시청자가 동영상을 시청하다가 5분부터 15분까지 동영상을 탐색합니다. 그러나 10분 표시에 광고 시점이 주어지면 시청자가 그 이후에 콘텐츠를 볼 수 있습니다.

이 광고 시점을 표시하려면 다음 단계를 따르세요.

1. 사용자가 시청하지 않은 광고 시간을 지나 뛰어넘은 탐색을 실행했는지 확인하고, 탐색되었다면 광고 시점으로 돌아갑니다.
2. 광고 시간이 끝나면 원래 탐색으로 돌아갑니다.

다이어그램 형식은 다음과 같습니다.

AdvancedExample에서와 같이 Android IMA SDK에서 이 워크플로를 구현하는 방법은 다음과 같습니다.

탐색이 광고 시간을 시청하지 않은 상태로 남겨두지 않도록 방지

사용자가 시청하지 않은 광고 시점을 지나 탐색을 실행했는지 확인하고, 탐색되었다면 광고 시점으로 돌아갑니다. Android SDK에서 PlayerControl 객체를 사용하여 탐색을 감지합니다. 사용자가 탐색하면 SampleAdsWrapper로 구현된 SampleHlsVideoPlayerCallback의 onSeek() 메서드를 트리거합니다. 이 메서드 (아래 참고)는 사용자의 탐색 시간 전에 큐 포인트를 확인합니다. 재생되지 않은 경우 처음에 원하는 탐색 지점 대신 광고 시점의 시작 부분을 탐색하고 원하는 탐색 지점을 snapBackTime에 저장합니다.

@Override
public void onSeek(int timeMillis) {
  double timeToSeek = timeMillis;
  if (streamManager != null) {
    CuePoint cuePoint =
        streamManager.getPreviousCuePointForStreamTime(timeMillis / 1000);
    if (cuePoint != null && !cuePoint.isPlayed()) {
      snapBackTime = timeToSeek / 1000.0; // Update snapback time.
      // Missed cue point, so snap back to the beginning of cue point.
      timeToSeek = cuePoint.getStartTime() * 1000;
      videoPlayer.seek(Math.round(timeToSeek));
      videoPlayer.setCanSeek(false);
      return;
    }
  }
  videoPlayer.seek(Math.round(timeToSeek));
}

사용자를 원래 탐색으로 되돌리기

이제 onAdBreakEnded 이벤트가 발생하면 snapBackTime가 설정되었는지 확인합니다. 그렇다면 방금 시청한 광고 시점은 스냅백의 결과이므로 사용자를 스트림의 지점으로 안내합니다.

@Override
public void onAdBreakEnded() {
  // Re-enable player controls.
  videoPlayer.setCanSeek(true);
  videoPlayer.enableControls(true);
  if (snapBackTime > 0) {
    videoPlayer.seek(Math.round(snapBackTime * 1000));
  }
  snapBackTime = 0;
}