支持画中画

iOS 版媒体广告 (IMA) SDK。

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

前提条件

• 通读入门指南。

为应用添加画中画支持

自 SDK 版本 3.1.0 起，IMA 支持 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 对象

为了支持画中画，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 在视频以画中画模式播放时将广告插入到画中画窗口中：

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

进入画中画模式

如果您使用的是不含 AVPlayerViewController 的 AVPlayer，则需要添加自己的画中画按钮。我们在高级示例中实现了如下所示的自定义视图：

- (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 的本地句柄。