Cómo volver a una pausa publicitaria omitida

Como publicador de videos, es posible que quieras evitar que los usuarios adelanten los anuncios durante el video. Cuando un usuario busca más allá de una pausa publicitaria, puedes llevarlo de regreso al inicio de esa pausa y, luego, regresarlo a su ubicación de búsqueda una vez que se haya completado esa pausa. Esta función se llama “recuperación”.

Como ejemplo, consulta el siguiente diagrama. El usuario está mirando un video y decide adelantar desde el minuto 5 hasta el minuto 15. Sin embargo, hay una pausa publicitaria a los 10 minutos que quieres que miren antes de poder ver el contenido después de ella:

Para mostrar esta pausa publicitaria, sigue estos pasos:

1. Comprueba si el usuario realizó una búsqueda que omitió una pausa publicitaria sin mirar y, si es así, llévalo de regreso a la pausa publicitaria.
2. Una vez que se complete la pausa publicitaria, regrésalos a su búsqueda original.

En forma de diagrama, se ve así:

A continuación, se explica cómo implementar este flujo de trabajo en el SDK de DAI de IMA, como se hace en AdvancedExample.

Evita que se omita una pausa publicitaria sin mirar

Comprueba si el usuario realizó una búsqueda que pasó un corte comercial sin mirar y, si es así, llévalo de vuelta al corte comercial. En el SDK de Android, usa el objeto PlayerControl para detectar la búsqueda. Cuando el usuario busque, activa el método onSeek() del SampleHlsVideoPlayerCallback implementado por SampleAdsWrapper. Ese método (que se presenta a continuación) verifica el punto de referencia antes del tiempo de búsqueda del usuario. Si no se reprodujo, busca el inicio de esa pausa publicitaria en lugar del punto de búsqueda deseado inicial y guarda ese punto de búsqueda deseado en 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));
}

Regresa al usuario a su posición de búsqueda original

Ahora, cuando recibas un evento onAdBreakEnded, verifica si snapBackTime está configurado. Si es así, lleva al usuario a ese punto de la transmisión, ya que la pausa publicitaria que acaba de ver fue el resultado de la función de recuperación:

@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;
}