Compatibilidad con pantalla en pantalla

SDK de anuncios multimedia interactivos (IMA) para iOS.

Esta guía está dirigida a los publicadores de IMA que desean agregar compatibilidad con la función de pantalla en pantalla a su implementación existente de IMA.

Requisitos previos

Cómo agregar compatibilidad con la función de 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 de pantalla en pantalla a tu app, debes ajustar algunos parámetros de configuración y, luego, implementar algunas clases nuevas de IMA, como se muestra a continuación.

Cómo actualizar 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 Modos en segundo plano en ACTIVADO para Audio, AirPlay y pantalla en pantalla como se muestra a continuación:

  2. Establece las propiedades de AVAudioSession para admitir la reproducción en segundo plano y habilitar 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 objetos nuevos de iOS y de IMA para la función de pantalla en pantalla

Para admitir la función de pantalla en pantalla, Apple agregó las clases AVPictureInPictureController y AVPictureinPictureControllerDelegate. Por su parte, IMA 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 para crear: IMAAVPlayerVideoDisplay. Este se pasa a tu constructor IMAAdsRequest y permite que el SDK inserte anuncios en la ventana de PiP cuando se reproduce el video 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];
}

Cómo iniciar 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 nuestra Muestra Avanzada 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 el modo de pantalla en pantalla?
Los anuncios no se pueden iniciar mientras el video está en el modo de 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 de 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 pantalla en pantalla. Por eso, te pedimos que establezcas el delegado para AVPictureinPictureController en una instancia de IMAPictureInPicturyProxy. Este objeto 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 de pantalla en pantalla. Ten en cuenta que también debes mantener un controlador local en tu AVPlayerLayer.