PIP 모드

본 가이드는 기존 IMA 구현에 PIP 모드 지원을 추가하려는 IMA 게시자를 대상으로 합니다.

기본 요건

앱에 PIP 모드 지원 추가

SDK 버전 3.1.0부터 IMA는 iPad용 Apple의 PIP 모드를 지원합니다. 앱에 PIP 모드 지원을 추가하려면 아래와 같이 몇 가지 설정을 조정하고 새로운 IMA 클래스를 구현해야 합니다.

백그라운드 재생을 허용하도록 설정 업데이트

PIP 모드를 사용하려면 앱에서 백그라운드 미디어 재생을 허용해야 합니다.

  1. 아래와 같이 오디오, AirPlay, PIP 모드의 Background Modes를 ON으로 설정합니다.

  2. 백그라운드 재생을 지원하고 IMASettings에서 백그라운드 재생을 사용 설정하도록 AVAudioSession 속성을 설정합니다.

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

PIP 모드를 위한 새 iOS 및 IMA 객체 만들기

PIP 모드를 지원하기 위해 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 생성자에 전달되며 동영상이 PIP 모드로 재생될 때 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 광고는 PIP 모드 중에 시작할 수 없습니다. 따라서 동영상이 표준 재생 모드일 때만 [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;
  }
}

PIP 모드로 들어가기

AVPlayerViewController 없이 AVPlayer를 사용 중인 경우 PIP 모드 버튼을 직접 추가해야 합니다. 고급 샘플에서 다음과 같이 이를 구현했습니다.

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

FAQ

동영상이 PIP 모드일 때 광고를 시작하려면 어떻게 해야 하나요?
동영상이 PIP 모드일 때는 광고를 시작할 수 없습니다. 표준 재생 모드에서만 시작할 수 있습니다.
기존 PIP 통합에서 self.pictureInPictureController.delegate를 내 클래스로 설정해야 합니다. PIP 모드에서 IMA 광고를 구현하고 대리인이 되려면 어떻게 해야 하나요?
PIP 모드에서 광고 재생을 사용 설정하려면 IMA SDK에서 AVPictureinPictureControllerDelegate 메시지를 수신해야 합니다. 따라서 AVPictureinPictureController의 대리자를 IMAPictureInPicturyProxy의 인스턴스로 설정해야 합니다. 이 프록시 객체는 모든 AVPictureinPictureControllerDelegate 메시지를 앱으로 전달하지만 PIP 모드 지원을 사용 설정하기 위해 IMA에 호출도 전달합니다. AVPlayerLayer의 로컬 핸들도 유지해야 합니다.