รองรับการแสดงภาพซ้อนภาพ

SDK โฆษณาสื่อ (IMA) สำหรับ iOS

คู่มือนี้มีไว้สำหรับผู้เผยแพร่โฆษณา IMA ที่ต้องการเพิ่มการรองรับภาพในภาพลงในการติดตั้งใช้งาน IMA ที่มีอยู่

ข้อกำหนดเบื้องต้น

• ทำตามคู่มือเริ่มต้นใช้งาน

การเพิ่มการรองรับการแสดงภาพซ้อนภาพลงในแอป

ตั้งแต่ SDK เวอร์ชัน 3.1.0 เป็นต้นไป IMA รองรับโหมดภาพซ้อนภาพของ Apple สำหรับ iPad หากต้องการเพิ่มการรองรับโหมดภาพซ้อนภาพในแอป คุณต้องปรับแต่งการตั้งค่าบางอย่างและใช้คลาส IMA ใหม่ 2-3 คลาสตามที่แสดงด้านล่าง

การอัปเดตการตั้งค่าเพื่ออนุญาตการเล่นขณะล็อกหน้าจอหรือขณะใช้แอปอื่น

โหมดการแสดงภาพซ้อนภาพกำหนดให้คุณต้องอนุญาตการเล่นสื่อในเบื้องหลังในแอป

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

การแก้ไขคำขอโฆษณา

คุณต้องสร้างออบเจ็กต์ใหม่อีก 1 รายการคือ 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 ด้วย