画中画

本指南面向希望为现有 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 添加了 AVPictureInPictureControllerAVPictureinPictureControllerDelegate 类。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 的本地句柄。