画中画

本指南面向希望在现有 IMA 实现中添加画中画功能的 IMA 发布商。

前提条件

为应用添加画中画支持

从 SDK 版本 3.1.0 开始，IMA 支持 iPad 的 Apple 画中画模式。 如需向应用添加画中画支持，您需要调整一些设置并实现一些新的 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 对象

为了支持画中画功能，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 的本地句柄。