Supporto di Picture in picture

SDK Annunci multimediali (IMA) per iOS.

Questa guida è rivolta ai publisher IMA che vogliono aggiungere il supporto Picture in picture alla loro implementazione IMA esistente.

Prerequisiti

Aggiungere il supporto Picture in picture alla tua app

A partire dalla versione 3.1.0 dell'SDK, IMA supporta la modalità Picture in picture di Apple per iPad. Per aggiungere il supporto Picture in picture alla tua app, devi modificare alcune impostazioni e implementare alcune nuove classi IMA, come mostrato di seguito.

Aggiornare le impostazioni per consentire la riproduzione in background

La modalità Picture in picture richiede di consentire la riproduzione di contenuti multimediali in background nella tua app.

  1. Imposta Modalità in background su ON per Audio, AirPlay e Picture in picture come mostrato di seguito:

  2. Imposta le proprietà AVAudioSession per supportare la riproduzione in background, nonché per abilitare la riproduzione in background in 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;
}

Creare nuovi oggetti iOS e IMA per Picture in picture

Per supportare Picture in picture, Apple ha aggiunto le classi AVPictureInPictureController e AVPictureinPictureControllerDelegate. IMA, da parte sua, ha aggiunto IMAPictureInPictureProxy. Per incorporare queste classi nel tuo progetto, aggiungi le seguenti istruzioni al codice:

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

Modificare la richiesta di annunci

È necessario creare un altro nuovo oggetto: IMAAVPlayerVideoDisplay. Questo oggetto viene passato al costruttore IMAAdsRequest e consente all'SDK di inserire annunci nella finestra PiP quando il video viene riprodotto in modalità Picture in picture:

...
- (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];
}

Avviare gli annunci

Gli annunci dell'SDK IMA non possono essere avviati durante la modalità Picture in picture. Di conseguenza, devi assicurarti di chiamare [adsManager start] solo quando il video è in modalità di riproduzione standard:

...
- (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;
  }
}

Attivare la modalità Picture in picture

Se utilizzi un AVPlayer senza un AVPlayerViewController, devi aggiungere il tuo pulsante Picture in picture. Ne abbiamo implementato uno nel nostro Esempio Avanzato come segue:

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

Domande frequenti

Come faccio ad avviare gli annunci quando il video è in modalità Picture in picture?
Gli annunci non possono essere avviati mentre il video è in modalità Picture in picture; possono essere avviati solo in modalità di riproduzione standard.
La mia integrazione Picture in picture esistente deve impostare self.pictureInPictureController.delegate sulla mia classe. Come faccio a implementare gli annunci IMA in Picture in picture e a essere comunque il delegato?
L'SDK IMA deve anche ricevere i messaggi AVPictureinPictureControllerDelegate per abilitare la riproduzione degli annunci in modalità Picture in picture. Per questo motivo ti chiediamo di impostare il delegato per AVPictureinPictureController su un'istanza di IMAPictureInPicturyProxy. Questo oggetto proxy inoltra tutti i messaggi AVPictureinPictureControllerDelegate alla tua app, ma inoltra anche le chiamate a IMA per abilitare il supporto Picture in picture. Tieni presente che devi anche mantenere un handle locale per AVPlayerLayer.