Вернуться к пропущенной рекламной паузе

Выберите платформу: HTML5 Android iOS tvOS Roku

Как видеоредактор, вы можете захотеть запретить зрителям перематывать видео после вставки рекламы. Когда пользователь перематывает видео после рекламной паузы, вы можете вернуть его к началу этой паузы, а затем снова вернуть к месту перемотки после её завершения. Эта функция называется «возврат к исходному положению».

В качестве примера рассмотрим диаграмму ниже. Зритель смотрит видео и решает перемотать его с 5-й минуты на 15-ю. Однако на 10-й минуте есть рекламная пауза, которую вы хотите, чтобы он посмотрел перед тем, как перейти к следующему контенту:

Для отображения этой рекламной паузы выполните следующие действия:

  1. Проверьте, не перескочил ли пользователь на непросмотренную рекламную паузу, и если да, верните его к этой рекламной паузе.
  2. После завершения рекламной паузы верните пользователей к исходному месту поиска.

В виде схемы это выглядит так:

Вот как реализовать этот рабочий процесс в SDK IMA DAI, как это сделано в AdvancedExample .

Предотвратите пропуск непросмотренной рекламы.

Если пользователь пытается пропустить рекламную паузу, плеер должен обнаружить этот переход и принудительно возобновить воспроизведение с начала данной рекламной паузы. Чтобы предотвратить пропуск непросмотренной рекламы, выполните следующие действия:

  1. Когда пользователь начинает взаимодействовать с ползуном прокрутки, запишите текущее время воспроизведения.
  2. После того, как пользователь перейдет к другому моменту в ленте, определите самый последний рекламный блок, расположенный перед этим временем.
  3. Если рекламная пауза начинается после указанного времени начала записи (что означает пропуск) и еще не была воспроизведена , перемотайте плеер к началу рекламной паузы.
  4. Включите флаг snapbackMode , чтобы отслеживать, что эта рекламная пауза была принудительной.

Objective-C 

- (IBAction)videoControlsTouchStarted:(id)sender {
  [NSObject cancelPreviousPerformRequestsWithTarget:self
                                            selector:@selector(hideFullscreenControls)
                                              object:self];

  self.currentlySeeking = YES;
  self.seekStartTime = self.contentPlayer.currentTime;
}

- (IBAction)videoControlsTouchEnded:(id)sender {
  if (self.fullscreen) {
    [self startHideControlsTimer];
  }
  self.currentlySeeking = NO;
  if (!self.adPlaying) {
    self.seekEndTime = CMTimeMake(self.progressBar.value, 1);
    IMACuepoint *lastCuepoint =
        [self.streamManager previousCuepointForStreamTime:CMTimeGetSeconds(self.seekEndTime)];
    if (!lastCuepoint.played && (lastCuepoint.startTime > CMTimeGetSeconds(self.seekStartTime))) {
      self.snapbackMode = YES;
      // Add 1 to the seek time to get the keyframe at the start of the ad to be our landing
      // place.
      [self.contentPlayer
          seekToTime:CMTimeMakeWithSeconds(lastCuepoint.startTime + 1, NSEC_PER_SEC)];
    }
  }
}
VideoViewController.m

Быстрый 

@IBAction func progressBarTouchStarted(_ sender: UISlider) {
  guard !isAdPlaying else { return }
  currentlySeeking = true
  seekStartTime = contentPlayer.currentTime().seconds
}

// MARK: Snapback Logic
@IBAction func progressBarTouchEnded(_ sender: UISlider) {
  guard !isAdPlaying else { return }
  if isFullScreen {
    startHideControlsTimer()
  }
  currentlySeeking = false
  seekEndTime = Float64(sender.value)

  guard let streamManager else { return }

  if let lastCuepoint = streamManager.previousCuepoint(forStreamTime: seekEndTime) {
    if !lastCuepoint.isPlayed, lastCuepoint.startTime > seekStartTime {
      logMessage(
        "Snapback to \(String(format: "%.2f", lastCuepoint.startTime)) from \(String(format: "%.2f", seekEndTime))"
      )
      snapbackMode = true
      contentPlayer.seek(
        to: CMTime(seconds: Double(sender.value), preferredTimescale: 1000))
    }
  }
}
VideoViewController.swift

Возобновить исходный поиск

После завершения воспроизведения принудительной рекламной паузы плеер перенаправляет пользователя к нужному контенту.

Чтобы возобновить поиск, выполненный пользователем, выполните следующие действия:

  1. Отслеживайте событие AD_BREAK_ENDED в вашем менеджере потоков.

  2. Проверьте, активен ли флаг snapbackMode , чтобы убедиться, что этот скачок происходит после принудительного просмотра рекламы.

  3. Если эта функция активна, перенаправьте игрока к сохраненному времени, чтобы вернуть пользователя к нужной временной метке.

В следующем примере система отслеживает завершение рекламной паузы и возвращает пользователя к исходной ссылке:

Objective-C 

case kIMAAdEvent_AD_BREAK_ENDED: {
  [self logMessage:@"Ad break ended"];
  self.adPlaying = NO;
  if (self.snapbackMode) {
    self.snapbackMode = NO;
    if (CMTimeCompare(self.seekEndTime, self.contentPlayer.currentTime)) {
      [self.contentPlayer seekToTime:self.seekEndTime];
    }
  }
  break;
}
VideoViewController.m

Быстрый 

case .AD_BREAK_ENDED:
  logMessage("Ad break ended")
  isAdPlaying = false
  progressBar.isUserInteractionEnabled = true
  if snapbackMode {
    snapbackMode = false
    if contentPlayer.currentTime().seconds < seekEndTime {
      contentPlayer.seek(to: CMTime(seconds: Double(seekEndTime), preferredTimescale: 1000))
    }
  } else if pendingBookmarkSeek, let time = bookmarkStreamTime {
    logMessage(String(format: "AD_BREAK_ENDED: Seeking to bookmark streamTime: %.2f", time))
    imaVideoDisplay.seekStream(toTime: time)
    pendingBookmarkSeek = false
    bookmarkStreamTime = nil
  }
  updatePlayHeadState(isPlaying: self.isContentPlaying)
VideoViewController.swift