고급 통합(InStream API)

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

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

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

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

   메서드와 그 구현에 대한 자세한 내용은 Package com.yandex.mobile.ads.instream.player.ad 참조 섹션을 확인하세요. 또한 테스트 구현 예시를 참조하세요.

   Совет

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

2. InstreamAdView를 앱의 레이아웃에 추가합니다. 동영상 광고를 재생하려면 InstreamAdView에 PlayerView를 포함해야 합니다.

   코드 예시:

   제약 조건

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

   <com.yandex.mobile.ads.instream.player.ad.InstreamAdView
       android:id="@+id/instream_ad_view"
       android:layout_width="match_parent"
       android:layout_height="wrap_content">
   
           <PlayerView
               android:id="@+id/player_view"
               android:layout_width="match_parent"
               android:layout_height="wrap_content"/>
   
   </com.yandex.mobile.ads.instream.player.ad.InstreamAdView>
   

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

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

   Kotlin

   Java

   fun onInstreamAdLoaded(instreamAd: InstreamAd) {
       val inrollQueueProvider = InrollQueueProvider(context, instreamAd)
       instreamAdBreakQueue = inrollQueueProvider.queue
   }
   

   public void onInstreamAdLoaded(@NonNull final InstreamAd instreamAd) {
       final InrollQueueProvider inrollQueueProvider = new InrollQueueProvider(context, instreamAd);
       mInstreamAdBreakQueue = inrollQueueProvider.getQueue();
   }
   

5. 수신한 In-roll 동영상 광고를 실행하려면 이를 준비해야 합니다. 준비되지 않은 In-roll 동영상 광고는 시작되지 않습니다.

   In-roll 동영상 광고를 준비하려면, 인터페이스 Inroll.prepare(instreamAdPlayer)를 호출하고 생성된 InstreamAdPlayer 구현의 인스턴스를 전달합니다. 광고 시점의 상태를 추적하려면 InstreamAdBreakEventListener를 설정하세요.

   Kotlin

   Java

   fun prepare(instreamAdPlayer: SampleInstreamAdPlayer) {
       currentInroll = instreamAdBreakQueue.poll()?.apply {
           setListener(InrollListener())
           instreamAdPlayer.let(::prepare)
       }
   }
   

   public void prepare(instreamAdPlayer) {
       currentInroll = mInstreamAdBreakQueue.poll();
       currentInroll.setListener(new InrollListener());
       currentInroll.prepare(instreamAdPlayer);
   }
   

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

   Совет

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

7. 준비된 In-roll 동영상 광고를 재생하려면, Inroll.play()를 호출하고 InstreamAdView를 매개변수로 전달합니다.

   Kotlin

   Java

   fun onInstreamAdBreakPrepared() {
       currentInroll?.play(instreamAdView)
   }
   

   public void onInstreamAdBreakPrepared() {
       if (currentInroll != null) {
           currentInroll.play(instreamAdView);
       }
   }
   

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

   Kotlin

   Java

   fun onInstreamAdBreakStarted() {
       contentVideoPlayer?.pauseVideo()
   }
   

   public void onInstreamAdBreakStarted() {
       if (contentVideoPlayer != null) {
           contentVideoPlayer.pauseVideo();
       }
   }
   

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

   Kotlin

   Java

   override fun onInstreamAdBreakCompleted() {
       handleAdBreakCompleted()
   }
   
   override fun onInstreamAdBreakError(reason: String) {
       handleAdBreakCompleted()
   }
   
   private fun handleAdBreakCompleted() {
       currentInroll = null
       contentVideoPlayer?.resumeVideo()
   }
   

   @Override
   public void onInstreamAdBreakCompleted() {
       handleAdBreakCompleted();
   }
   
   @Override
   public void onInstreamAdBreakError(@NonNull final String reason) {
       handleAdBreakCompleted();
   }
   
   private void handleAdBreakCompleted() {
       currentInroll = null;
       if (contentVideoPlayer != null) {
           contentVideoPlayer.resumeVideo();
       }
   }
   

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

    Kotlin

    Java

    fun prepareNextAd() {
        currentInroll = mInstreamAdBreakQueue.poll()
        currentInroll?.prepareInroll(currentInroll)
    }
    

    public void prepareNextAd() {
        currentInroll = mInstreamAdBreakQueue.poll();
        if (currentInroll != null) {
            prepareInroll(currentInroll);
        }
    }
    

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

    Kotlin

    Java

    override fun onDestroy() {
        currentInroll?.apply {
            invalidate()
            setListener(null)
        }
        super.onDestroy()
    }
    

    public void onDestroy() {
        if (currentInroll != null) {
            currentInroll.invalidate();
            currentInroll.setListener(null);
        }
        super.onDestroy();
    }