고급 연동(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가 있어야 합니다.

   코드 예시:

   제한 사항

   컨테이너 크기는 최소 300dp × 160dp여야 합니다.

   <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로 Yandex Advertising Network 인터페이스의 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();
    }