Imagen en imagen

Esta guía está destinada a los publicadores de IMA que desean agregar compatibilidad con la función Imagen dentro de imagen a su implementación existente de IMA.

Requisitos previos

• Completa la guía de introducción.

Cómo agregar compatibilidad con pantalla en pantalla a tu app

A partir de la versión 3.1.0 del SDK, IMA admite el modo de pantalla en pantalla de Apple para iPad. Para agregar compatibilidad con la función Pantalla en pantalla a tu app, debes ajustar algunos parámetros de configuración e implementar algunas clases IMA nuevas, como se muestra a continuación.

Actualiza la configuración para permitir la reproducción en segundo plano

El modo de pantalla en pantalla requiere que permitas la reproducción de contenido multimedia en segundo plano en tu app.

1. Establece Background Modes en ON para Audio, AirPlay y Picture in Picture, como se muestra a continuación:

   

2. Configura las propiedades AVAudioSession para admitir la reproducción en segundo plano y habilita la reproducción en segundo plano en IMASettings:

   ...
   – (void)viewDidLoad {
    [super viewDidLoad];
   
    self.playButton.layer.zPosition = MAXFLOAT;
   
    [[AVAudioSession sharedInstance] setActive:YES error:nil];
    [[AVAudioSession sharedInstance] setCategory:AVAudioSessionCategoryPlayback error:nil];
   
    [self setupAdsLoader];
    [self setUpContentPlayer];
   }
   
   – (void)setupAdsLoader {
    IMASettings *settings = [[IMASettings alloc] init];
    settings.enableBackgroundPlayback = YES;
    self.adsLoader = [[IMAAdsLoader alloc] initWithSettings:settings];
    self.adsLoader.delegate = self;
   }

Cómo crear nuevos objetos de iOS y IMA para la pantalla en pantalla

Para admitir la función Pantalla en pantalla, Apple agregó las clases AVPictureInPictureController y AVPictureinPictureControllerDelegate. IMA, por su parte, agregó IMAPictureInPictureProxy. Para incorporar estas clases en tu proyecto, agrega las siguientes instrucciones a tu código:

...
@interface VideoViewController () <AVPictureInPictureControllerDelegate,
                                   IMAAdsLoaderDelegate,
                                   IMAAdsManagerDelegate,
                                   UIAlertViewDelegate>
...
// PiP objects.
@property(nonatomic, strong) IMAPictureInPictureProxy *pictureInPictureProxy;
@property(nonatomic, strong) AVPictureInPictureController *pictureInPictureController;
...
@end

- (void)setUpContentPlayer {
  ...
  self.pictureInPictureProxy =
      [[IMAPictureInPictureProxy alloc] initWithAVPictureInPictureControllerDelegate:self];
  self.pictureInPictureController =
      [[AVPictureInPictureController alloc] initWithPlayerLayer:self.contentPlayerLayer];
  self.pictureInPictureController.delegate = self.pictureInPictureProxy;
}

Cómo modificar tu solicitud de anuncios

Hay un objeto nuevo más que crear: IMAAVPlayerVideoDisplay. Esto se pasa al constructor IMAAdsRequest y permite que el SDK inserte anuncios en la ventana de PIP cuando el video se reproduce en el modo de pantalla en pantalla:

...
- (void)requestAdsWithTag:(NSString *)adTagUrl {
  [self logMessage:@"Requesting ads"];
  // Create an ad request with our ad tag, display container, and optional user context.
  IMAAdsRequest *request = [[IMAAdsRequest alloc]
           initWithAdTagUrl:adTagUrl
         adDisplayContainer:[self createAdDisplayContainer]
       avPlayerVideoDisplay:[[IMAAVPlayerVideoDisplay alloc] initWithAVPlayer:self.contentPlayer]
      pictureInPictureProxy:self.pictureInPictureProxy
                userContext:nil];
  [self.adsLoader requestAdsWithRequest:request];
}

Inicio de anuncios

Los anuncios del SDK de IMA no se pueden iniciar durante el modo de pantalla en pantalla. Como resultado, debes asegurarte de llamar a [adsManager start] solo cuando el video esté en el modo de reproducción estándar:

...
- (void)adsManager:(IMAAdsManager *)adsManager didReceiveAdEvent:(IMAAdEvent *)event {
  [self logMessage:@"AdsManager event (%s).", AdEventNames[event.type]];
  // When the SDK notified you that ads have been loaded, play them.
  switch (event.type) {
    case kIMAAdEvent_LOADED:
      if (![self.pictureInPictureController isPictureInPictureActive]) {
        [adsManager start];
      }
      break;
    ...
    default:
      break;
  }
}

Cómo ingresar al modo de pantalla en pantalla

Si usas un AVPlayer sin un AVPlayerViewController, debes agregar tu propio botón de pantalla en pantalla. Implementamos uno en nuestro ejemplo avanzado de la siguiente manera:

- (IBAction)onPipButtonClicked:(id)sender {
  if ([self.pictureInPictureController isPictureInPictureActive]) {
    [self.pictureInPictureController stopPictureInPicture];
  } else {
    [self.pictureInPictureController startPictureInPicture];
  }
}

Preguntas frecuentes

¿Cómo inicio los anuncios cuando el video está en modo pantalla en pantalla?

Los anuncios no se pueden iniciar mientras el video está en el modo pantalla en pantalla, solo se pueden iniciar en el modo de reproducción estándar.

Mi integración existente de pantalla en pantalla debe establecer self.pictureInPictureController.delegate en mi propia clase. ¿Cómo puedo implementar anuncios de IMA en la función Pantalla en pantalla y seguir siendo el delegado?

El SDK de IMA también debe recibir mensajes AVPictureinPictureControllerDelegate para habilitar la reproducción de anuncios en el modo de imagen en imagen. Por eso, te pedimos que establezcas el delegado de AVPictureinPictureController en una instancia de IMAPictureInPicturyProxy. Este objeto de proxy reenvía todos los mensajes AVPictureinPictureControllerDelegate a tu app, pero también reenvía las llamadas a IMA para habilitar la compatibilidad con la función Picture in Picture. Ten en cuenta que también debes mantener un control local de tu AVPlayerLayer.