InStream API 통합

In/Pause-Roll API는 PlayerView에서 동영상 광고의 렌더링을 직접 제어하지 않습니다. 동영상 광고는 In/Pause-Roll로 전송된 플레이어 인터페이스의 신호를 기반으로 앱 측에서 재생되어야 합니다. In/Pause-Roll은 InstreamAdBreakDelegate.instreamAdBreakDidStart()를 호출하여 광고 시점의 시작을 신호하고 InstreamAdBreakDelegate.instreamAdBreakDidComplete() 또는 InstreamAdBreakDelegate.instreamAdBreakDidError()를 호출하여 끝을 신호합니다.

앱 측에서 InstreamAdBreakDelegate.instreamAdBreakDidStart()를 호출할 때는 메인 동영상 제어를 숨기고 메인 동영상을 일시 중지해야 합니다. 광고 SDK 측에서는 메서드를 호출한 후 InstreamAdView 컨테이너 내에 광고 제어가 표시되고 InstreamAdPlayer.playAd() 메서드를 호출하여 동영상 광고 재생을 시작합니다.

앱 측에서 InstreamAdBreakDelegate.instreamAdBreakDidComplete() 또는 InstreamAdBreakDelegate.instreamAdBreakDidError()를 호출할 때, 메인 동영상 제어를 반환하고 메인 동영상 재생을 재개해야 합니다. 광고 SDK 측에서는 메서드를 호출하기 전에 InstreamAdView 컨테이너에서 광고 제어를 제거합니다.

1. InstreamAdPlayer 인터페이스를 구현합니다.

   참조는 메서드와 그 구현에 대한 자세한 정보를 제공합니다. 또한 테스트 구현 예시를 참조하세요.

   Совет

   더 간편하게 실행하려면 다른 플레이어 인스턴스를 사용하여 동영상 광고와 콘텐츠를 재생하는 것을 권장합니다.

2. InstreamAdView를 앱의 View 계층에 추가합니다. 동영상 광고를 재생하려면 InstreamAdView에 PlayerView를 포함해야 합니다.

   Важно

   컨테이너의 크기는 최소 300dpx160dp여야 합니다.

3. InstreamAdLoader를 사용하여 파트너 인터페이스의 Page ID를 사용해 InstreamAd 객체를 로드합니다.

4. InstreamAd 객체는 다양한 유형의 광고 시점 세트를 포함합니다. In-roll 광고 시점을 얻으려면 InrollQueueProvider를 사용하세요. InrollQueueProvider 대기열을 통해 표시 순서대로 In-roll 객체를 수신할 수 있습니다.

   func instreamAdLoader(_ instreamAdLoader: InstreamAdLoader, didLoad ad:
   InstreamAd) {
       inrollQueue = InrollQueueProvider(ad: ad).queue()
   }
   

5. 수신한 In-roll 객체를 실행하려면 이를 준비해야 합니다. 준비되지 않은 In-roll 동영상 광고는 시작되지 않습니다. In-roll 동영상 광고 준비 상태를 추적하려면, InstreamAdBreakDelegate를 설정하고, Inroll.prepare(with: adPlayer)를 호출하고, InstreamAdPlayer 구현의 인스턴스를 전달합니다.

   private func prepareNextAd() {
       currentInroll = inrollQueue?.poll()
       currentInroll?.delegate = self
       currentInroll?.prepare(with: adPlayer)
   }
   

6. In-roll 동영상 광고가 준비되면 InstreamAdBreakDelegate.instreamAdBreakDidPrepare()가 호출됩니다. 준비된 In-roll 동영상 광고를 재생할 준비가 되었습니다.

   Совет

   InrollQueue에서 받은 순서대로 동영상 광고를 재생합니다. 받은 In-roll 동영상 광고가 다른 순서로 재생되면, 앱 수익화 효과가 감소할 수 있습니다.

7. 준비된 In-roll 동영상 광고를 재생하려면, Inroll.play(with adView: InstreamAdView)를 호출하고 이전에 View 계층 구조에 추가된 InstreamAdView를 매개변수로 전달합니다.

   func instreamAdBreakDidPrepare(_ adBreak: InstreamAdBreak) {
       currentInroll?.play(instreamAdView)
   }
   

8. 광고 시점이 재생되기 시작하면 InstreamAdBreakDelegate.instreamAdBreakDidStart() 메서드가 호출됩니다. 이 메서드를 호출한 후, 메인 동영상을 일시 중지하고 제어를 숨김 처리합니다.

   func instreamAdBreakDidStart(_ adBreak: InstreamAdBreak) {
       contentVideoPlayer?.pauseVideo()
   }
   

9. 광고 시점이 재생된 후, 메인 동영상 재생을 재개합니다. 동영상 광고는 재생에 성공하거나 실패할 수 있습니다. 두 상황 모두 처리해야 합니다.

   func instreamAdBreakDidComplete(_ adBreak: InstreamAdBreak) {
       handleAdBreakCompleted()
   }
   func instreamAdBreakDidError(_ adBreak: InstreamAdBreak) {
       handleAdBreakCompleted()
   }
   private fun handleAdBreakCompleted() {
       currentInroll = null
       contentVideoPlayer?.resumeVideo()
   }
   

10. 현재 In-roll 동영상 광고의 재생이 완료되면 InrollQueue에서 다음 In-roll 동영상 광고를 위해 재생 대기열을 확인합니다.

    private func prepareNextAd() {
        currentInroll = inrollQueue?.poll()
        currentInroll?.delegate = self
        currentInroll?.prepare(with: adPlayer)
    }
    

11. In-roll 동영상 광고 사용을 중지할 때 그 상태를 재설정합니다.

    deinit {
        currentInroll?.invalidate()
    }