Picture-in-picture

Panduan ini ditujukan untuk penayang IMA yang ingin menambahkan dukungan Picture in Picture ke penerapan IMA yang ada.

Prasyarat

• Selesaikan Panduan memulai.

Menambahkan dukungan picture-in-picture ke aplikasi Anda

Mulai SDK versi 3.1.0, IMA mendukung mode Picture in Picture Apple untuk iPad. Untuk menambahkan dukungan Picture in Picture ke aplikasi, Anda perlu menyesuaikan beberapa setelan dan menerapkan beberapa class IMA baru, seperti yang ditunjukkan di bawah.

Memperbarui setelan untuk mengizinkan pemutaran di latar belakang

Mode Picture in Picture mengharuskan Anda mengizinkan pemutaran media di latar belakang di aplikasi Anda.

1. Tetapkan Background Modes ke ON untuk Audio, AirPlay, dan Picture in Picture seperti yang ditunjukkan di bawah:

   

2. Tetapkan properti AVAudioSession untuk mendukung pemutaran di latar belakang, serta aktifkan pemutaran di latar belakang di 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;
   }

Membuat objek iOS dan IMA baru untuk picture-in-picture

Untuk mendukung Picture in Picture, Apple menambahkan class AVPictureInPictureController dan AVPictureinPictureControllerDelegate. IMA, pada bagiannya, menambahkan IMAPictureInPictureProxy. Untuk menggabungkan class ini dalam project Anda, tambahkan pernyataan berikut ke kode Anda:

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

Mengubah permintaan iklan

Ada satu objek baru lagi yang harus dibuat: IMAAVPlayerVideoDisplay. Ini diteruskan ke konstruktor IMAAdsRequest dan memungkinkan SDK menyisipkan iklan ke jendela PiP saat video Anda diputar dalam mode 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];
}

Memulai iklan

Iklan IMA SDK tidak dapat dimulai selama mode picture-in-picture. Akibatnya, Anda harus memastikan bahwa Anda hanya memanggil [adsManager start] saat video berada dalam mode pemutaran standar:

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

Memasuki mode picture-in-picture

Jika menggunakan AVPlayer tanpa AVPlayerViewController, Anda harus menambahkan tombol Picture in Picture Anda sendiri. Kita telah menerapkannya di Contoh Lanjutan seperti ini:

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

FAQ

Bagaimana cara memulai iklan saat video dalam mode Picture in Picture?

Iklan tidak dapat dimulai saat video dalam mode Picture in Picture; iklan hanya dapat dimulai dalam mode pemutaran standar.

Integrasi Picture in Picture yang ada harus menetapkan self.pictureInPictureController.delegate ke class saya sendiri. Bagaimana cara menerapkan iklan IMA dalam Picture in Picture dan tetap menjadi delegasi?

IMA SDK juga perlu menerima pesan AVPictureinPictureControllerDelegate untuk mengaktifkan pemutaran iklan dalam mode Picture in Picture. Itulah sebabnya kami meminta Anda untuk menetapkan delegasi untuk AVPictureinPictureController ke instance IMAPictureInPicturyProxy. Objek proxy ini meneruskan semua pesan AVPictureinPictureControllerDelegate ke aplikasi Anda, tetapi juga meneruskan panggilan ke IMA untuk mengaktifkan dukungan Picture in Picture. Perhatikan bahwa Anda juga harus mempertahankan handle lokal ke AVPlayerLayer.