Snapback

En tant qu'éditeur de vidéos, vous souhaitez peut-être empêcher les internautes de rechercher vos annonces mid-roll. Lorsqu'un utilisateur recherche après une coupure publicitaire, vous pouvez le ramener au début de celle-ci, puis le renvoyer à son emplacement de recherche une fois la coupure publicitaire terminée. Cette fonctionnalité s'appelle "snapback".

À titre d'exemple, consultez le schéma ci-dessous. Lorsqu'un spectateur regarde une vidéo, il décide de s'étendre sur une période allant de 5 minutes à 15 minutes. En revanche, vous souhaitez qu'ils regardent une coupure publicitaire au bout de 10 minutes avant de pouvoir regarder le contenu suivant:

Pour diffuser cette coupure publicitaire, procédez comme suit:

1. Vérifiez si l'utilisateur a exécuté une recherche qui a dépassé une coupure publicitaire non visionnée et, le cas échéant, renvoyez-le à la coupure.
2. Une fois la coupure publicitaire terminée, rétablissez la recherche d'origine.

Sous forme de diagramme, cela ressemble à ceci:

Voici comment implémenter ce workflow dans le SDK IMA DAI, comme indiqué dans l'AdvancedExample.

Empêcher une recherche de laisser une coupure publicitaire non visionnée

Vérifiez si l'utilisateur a effectué une recherche après une coupure publicitaire non visionnée et, le cas échéant, redirigez-le vers la coupure. Pour l'exemple avancé d'iOS, utilisez l'interaction de l'utilisateur avec votre interface utilisateur pour détecter à quel moment il a exécuté une recherche. Conservez l'heure de début de la recherche pour vérifier s'il a dépassé une coupure publicitaire non lue. Lorsque l'utilisateur libère les commandes vidéo, comparez l'heure actuelle à celle de la coupure publicitaire la plus récente. Si la coupure publicitaire tombe après l'heure de début de la recherche (c'est-à-dire que l'utilisateur est passé au-delà) et qu'elle n'a pas encore été lue, recherchez-la jusqu'au début de la coupure. Définissez également un indicateur de retour à la ligne pour le vérifier ultérieurement dans votre gestionnaire de coupure publicitaire complète:

- (IBAction)videoControlsTouchStarted:(id)sender {
  self.seekStartTime = self.contentPlayer.currentTime;
}

- (IBAction)videoControlsTouchEnded:(id)sender {
  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 your landing place.
    [self.contentPlayer seekToTime:CMTimeMakeWithSeconds(lastCuepoint.startTime + 1, NSEC_PER_SEC)];
  }
}

Revenir à la recherche initiale de l'utilisateur

Dans le gestionnaire de coupures publicitaires, vérifiez si la coupure précédente a été lue suite au retour rapide. Si tel est le cas, renvoyez l'utilisateur à l'endroit qu'il cherchait initialement (à condition qu'il ne s'agisse pas du milieu de la coupure publicitaire qui vient d'être diffusée):

- (void)streamManager:(IMAStreamManager *)streamManager didReceiveAdEvent:(IMAAdEvent *)event {
  switch (event.type) {
    case kIMAAdEvent_AD_BREAK_ENDED: {
      if (self.snapbackMode) {
        self.snapbackMode = NO;
        if (CMTimeCompare(self.seekEndTime, self.contentPlayer.currentTime)) {
          [self.contentPlayer seekToTime:self.seekEndTime];
        }
      }
      break;
    }
  }
}