在 iPad 上支持多个窗口

从 iOS 13 开始，应用可以在 iPad 上支持多个窗口，这意味着用户可以同时与应用界面的多个并发副本进行交互。每个窗口都可以创建不同尺寸，并且可以随时调整大小，这会影响广告的加载和展示方式。

本指南旨在向您展示在 iPad 多窗口场景中正确呈现广告的最佳实践。

前提条件

在广告请求中设置场景

为了接收适合特定窗口的广告，您需要将视图的 windowScene 传递给广告请求。Google 移动广告 SDK 会返回尺寸适合该场景的广告。

Swift

func loadInterstitial() {
  let request = GADRequest()
  request.scene = view.window?.windowScene

  GADInterstitialAd.load(withAdUnitID: "[AD_UNIT_ID]",
      request: request) { ad, error in }
}

Objective-C

- (void)loadInterstitial {
  GADRequest *request = [GADRequest request];
  request.scene = self.view.window.windowScene;

  [GADInterstitialAd loadWithAdUnitID:@"[AD_UNIT_ID]"
      request:request
      completionHandler:^(GADInterstitialAd *ad, NSError *error) {}];
}

在测试模式下，如果您的多场景应用请求广告而不传递场景，则广告请求将失败并显示以下错误：

<Google> Invalid Request. The GADRequest scene property should be set for
applications that support multi-scene. Treating the unset property as an error
while in test mode.

在生产模式下，广告请求会进行填充，但如果广告在非全屏窗口中展示，则将无法展示广告。在这种情况下，错误消息为：

<Google> Ad cannot be presented. The full screen ad content size exceeds the current window size.

在 viewDidAppear 中构建广告请求：

在多窗口模式下，需要有一个用于发送广告请求的窗口场景。由于视图尚未添加到 viewDidLoad: 中的窗口，因此您应在当时设置窗口场景的 viewDidAppear: 中构建广告请求。

请注意，在应用的生命周期内，可以多次调用 viewDidAppear:。我们建议您将广告请求初始化代码封装在一个标记中，以表明相应初始化代码是否已完成。

Swift

override func viewDidAppear(_ animated: Bool) {
  super.viewDidAppear(animated)
  if !requestInitialized {
    loadInterstitial()
    requestInitialized = true
  }
}

Objective-C

- (void)viewDidAppear:(BOOL)animated {
  [super viewDidAppear:animated];
  if (!_requestInitialized) {
    [self loadInterstitial];
    _requestInitialized = YES;
  }
}

处理大小调整

用户可以随时拖动场景，在发出广告请求后更改窗口大小。调整大小时，您可以请求新的广告。 以下示例代码使用 viewWillTransitionToSize:withTransitionCoordinator: 在根视图控制器的窗口旋转或调整大小时收到通知，但您也可以监听 windowScene:didUpdateCoordinateSpace:interfaceOrientation:traitCollection:，了解窗口场景特定变化。

插页式广告和激励广告

Google 移动广告 SDK 提供了 canPresentFromViewController:error: 方法来确定插页式广告或激励广告是否有效，让您能够检查是否需要在每次窗口大小发生变化时刷新全屏广告。

Swift

override func viewWillTransition(to size: CGSize,
    with coordinator: UIViewControllerTransitionCoordinator) {
  super.viewWillTransition(to: size, with: coordinator)

  coordinator.animate(alongsideTransition: nil) { [self] context in
    do {
      try interstitial?.canPresent(fromRootViewController: self)
    } catch {
      loadInterstitial()
    }
  }
}

Objective-C

- (void)viewWillTransitionToSize:(CGSize)size
    withTransitionCoordinator:(id)coordinator {
  [super viewWillTransitionToSize:size withTransitionCoordinator:coordinator];

  [coordinator animateAlongsideTransition:nil
      completion:^(id _Nonnull context) {
    if (![self.interstitial canPresentFromRootViewController:self error:nil]) {
      [self loadInterstitial];
    }
  }];
}

您可以像处理窗口旋转一样处理窗口大小调整。您的应用应负责确保横幅广告适合新的窗口大小。

下例就创建了一个采用新窗口宽度的新自适应横幅广告：

Swift

override func viewWillTransition(to size: CGSize,
    with coordinator: UIViewControllerTransitionCoordinator) {
  super.viewWillTransition(to: size, with: coordinator)

  coordinator.animate(alongsideTransition: nil) { [self] context in
    loadBanner()
  }
}

func loadBanner() {
  let bannerWidth = view.frame.size.width

  bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(bannerWidth)

  let request = GADRequest()
  request.scene = view.window?.windowScene
  bannerView.load(request)
}

Objective-C

- (void)viewWillTransitionToSize:(CGSize)size
    withTransitionCoordinator:(id)coordinator {
  [super viewWillTransitionToSize:size withTransitionCoordinator:coordinator];

  [coordinator animateAlongsideTransition:nil
      completion:^(id _Nonnull context) {
    [self loadBannerAd];
  }];
}

- (void)loadBannerAd {
  CGFloat bannerWidth = self.view.frame.size.width;

  self.bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(bannerWidth);

  GADRequest *request = [GADRequest request];
  request.scene = self.view.window.windowScene;
  [self.bannerView loadRequest:request];
}

原生广告

您可以控制原生广告的呈现，并负责确保原生广告在调整过的视图内呈现（与应用内容的其余部分类似）。

已知问题

目前，仅在纵向模式下支持多窗口广告和分屏广告。 在横屏模式下请求广告时，您会收到以下日志消息。

<Google> Ad cannot be presented. The full screen ad content size exceeds the
current window size.