Поддержка картинка в картинке

Это руководство предназначено для издателей IMA, которые хотят добавить поддержку «картинка в картинке» к своей существующей реализации IMA.

Предпосылки

• Заполните руководство по началу работы .

Добавление поддержки «картинка в картинке» в ваше приложение

Начиная с версии SDK 3.1.0, IMA поддерживает режим «картинка в картинке» Apple для iPad. Чтобы добавить поддержку «картинки в картинке» в свое приложение, вам нужно настроить несколько параметров и реализовать несколько новых классов IMA, как показано ниже.

Обновление настроек для разрешения фонового воспроизведения

Для использования режима «Картинка в картинке» необходимо разрешить фоновое воспроизведение мультимедиа в вашем приложении.

1. Установите для фоновых режимов значение «ВКЛ.» для аудио, AirPlay и «Картинка в картинке» , как показано ниже:

   

2. Настройте свойства AVAudioSession для поддержки фонового воспроизведения, а также включите фоновое воспроизведение в 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;
   }

Создание новых объектов iOS и IMA для «картинки в картинке»

Для поддержки Picture in Picture компания Apple добавила классы AVPictureInPictureController и AVPictureinPictureControllerDelegate . IMA, со своей стороны, добавила IMAPictureInPictureProxy . Чтобы включить эти классы в свой проект, добавьте в свой код следующие операторы:

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

Изменение вашего запроса на рекламу

Осталось создать еще один новый объект: IMAAVPlayerVideoDisplay . Он передается в ваш конструктор IMAAdsRequest и позволяет SDK вставлять рекламу в окно PiP, когда ваше видео воспроизводится в режиме «картинка в картинке»:

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

Запуск рекламы

Реклама IMA SDK не может быть запущена в режиме «картинка в картинке» . В результате вам необходимо убедиться, что вы вызываете [adsManager start] только тогда, когда ваше видео находится в стандартном режиме воспроизведения:

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

Вход в режим «картинка в картинке»

Если вы используете AVPlayer без AVPlayerViewController , вам нужно добавить собственную кнопку «картинка в картинке». Мы реализовали ее в нашем расширенном примере следующим образом:

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

Часто задаваемые вопросы

Как запустить рекламу, если видео находится в режиме «картинка в картинке»?

Реклама не может быть запущена, пока видео находится в режиме «картинка в картинке»; ее можно запустить только в стандартном режиме воспроизведения.

Моя существующая интеграция «картинка в картинке» должна установить self.pictureInPictureController.delegate для моего собственного класса. Как я могу реализовать рекламу IMA в «картинке в картинке» и при этом оставаться делегатом?

IMA SDK также должен получать сообщения AVPictureinPictureControllerDelegate для включения воспроизведения рекламы в режиме «картинка в картинке». Вот почему мы просим вас установить делегата для AVPictureinPictureController на экземпляр IMAPictureInPicturyProxy . Этот прокси-объект пересылает все сообщения AVPictureinPictureControllerDelegate в ваше приложение, но также пересылает вызовы в IMA для включения поддержки «картинка в картинке». Обратите внимание, что вы также должны поддерживать локальный дескриптор для вашего AVPlayerLayer.