광고 시점

Android TV 수신기 SDK는 광고 시점 및 컴패니언을 기본적으로 지원합니다. 광고를 게재할 수 있습니다.

웹 수신기 광고 시점 개요를 참조하세요. 를 참조하세요.

광고 시점으로 로드 처리

Android TV 앱에서는 휴식 시간이 MediaLoadRequestData 로드 요청은 정상적으로 처리될 수 있으며 AdBreakClipInfo초 및 AdBreakInfo초 에서 가져올 수 있습니다. MediaInfo:

Kotlin
class MyMediaLoadCommandCallback : MediaLoadCommandCallback() {
  override fun onLoad( senderId: String?, loadRequestData: MediaLoadRequestData
   ): Task {
    return Tasks.call {
      // Resolve the entity into your data structure and load media.
      val mediaInfo = loadRequestData.mediaInfo
      ...
      myPrepareAdBreaks(mediaInfo.adBreakClips, mediaInfo.adBreaks)
      // Update media metadata and state (this clears all previous status
      // overrides).
      castReceiverContext.getMediaStatusModifier()
          .setDataFromLoad(mediaInfo) // Ad breaks are set on the modifier.
      castReceiverContext.getMediaManager().broadcastMediaStatus()
      // Return the resolved MediaLoadRequestData to indicate load success.
      return loadRequestData
    }
  }
}
드림
<ph type="x-smartling-placeholder">
</ph>
자바
public class MyMediaLoadCommandCallback extends MediaLoadCommandCallback {
  @Override
  public Task onLoad(String senderId, MediaLoadRequestData loadRequestData) {
    return Tasks.call(() -> {
        // Resolve the entity into your data structure and load media.
        MediaInfo mediaInfo = loadRequestData.getMediaInfo();
        ...
        myPrepareAdBreaks(mediaInfo.getAdBreakClips(), mediaInfo.getAdBreaks());
        // Update media metadata and state (this clears all previous status
        // overrides).
        castReceiverContext.getMediaStatusModifier()
            .setDataFromLoad(mediaInfo); // Ad breaks are set on the modifier.
        castReceiverContext.getMediaManager().broadcastMediaStatus();
        // Return the resolved MediaLoadRequestData to indicate load success.
        return loadRequestData;
    });
    }
}

광고 시점 업데이트

광고 재생이 시작되면 AdBreakStatus 드림 에 MediaStatusModifier 를 사용하여 앱에서 광고 재생을 시작했음을 브로드캐스트할 수 있습니다.

Kotlin
val breakStatus = AdBreakStatus.Builder()
        .setBreakId("b1")
        .setBreakClipId("bc1")
        .setCurrentBreakClipTimeInMs(breakClipProgress)
        .setCurrentBreakTimeInMs(breakProgress)
        .setWhenSkippableInMs(5000) // Set this field so that the ad break clip is skippable
        .build()

castReceiverContext.getMediaStatusModifier()
        .setAdBreakStatus(breakStatus)
드림
<ph type="x-smartling-placeholder">
</ph>
자바
AdBreakStatus breakStatus =
    new AdBreakStatus.Builder()
        .setBreakId("b1")
        .setBreakClipId("bc1")
        .setCurrentBreakClipTimeInMs(breakClipProgress)
        .setCurrentBreakTimeInMs(breakProgress)
        .setWhenSkippableInMs(5000)  // Set this field so that the ad break clip is skippable
        .build();

castReceiverContext.getMediaStatusModifier()
    .setAdBreakStatus(breakStatus);

항목이 로드된 후 광고 시점을 동적으로 수정할 수도 있습니다.

Kotlin
var breakClip1: AdBreakClipInfo = ...
var breakClip2: AdBreakClipInfo = ...
var breakClip3: AdBreakClipInfo = ...

var break1: AdBreakInfo = ...
var break2: AdBreakInfo = ...

mediaManager.getMediaStatusModifier().getMediaInfoModifier()
    .setAdBreakClips({breakClip1, breakClip2, breakClip3})
    .setAdBreaks({break1, break2})
드림
<ph type="x-smartling-placeholder">
</ph>
자바
AdBreakClipInfo breakClip1 = ...
AdBreakClipInfo breakClip2 = ...
AdBreakClipInfo breakClip3 = ...

AdBreakInfo break1 = ...
AdBreakInfo break2 = ...

mediaManager.getMediaStatusModifier().getMediaInfoModifier()
    .setAdBreakClips({breakClip1, breakClip2, breakClip3})
    .setAdBreaks({break1, break2});

광고 건너뛰기 사용 설정 및 처리

광고 시점이 재생 중일 때 발신자는 현재 시점을 건너뛸 수 있는 버튼을 표시합니다. 광고 시점 클립을 선택합니다. 사용자가 광고를 건너뛸 수 있도록 하기 위해 브레이크 클립을 사용하려면 MediaStatusModifier 드림 를 사용하여 COMMAND_SKIP_AD media 명령어:

Kotlin
mMediaManager.getMediaStatusModifier().setMediaCommandSupported(MediaStatus.COMMAND_SKIP_AD, true)
드림
<ph type="x-smartling-placeholder">
</ph>
자바
mMediaManager.getMediaStatusModifier().setMediaCommandSupported(MediaStatus.COMMAND_SKIP_AD, true);

SKIP_AD 명령어를 처리하려면 다음을 구현합니다. onSkipAd 콜백을 MediaCommandCallback:

Kotlin
class MyMediaCommandCallback : MediaCommandCallback() {
    override fun onSkipAd(requestData: RequestData?): Task<Void?> {
        // Skip your ad
        ...
        return Tasks.forResult<Any?>(null)
    }
}

val mediaManager = CastReceiverContext.getInstance().mediaManager
mediaManager.setMediaCommandCallback(MyMediaCommandCallback())
드림
<ph type="x-smartling-placeholder">
</ph>
자바
public class MyMediaCommandCallback extends MediaCommandCallback {
  @Override
  public Task onSkipAd(RequestData requestData) {
    // Skip your ad
    ...
    return Tasks.forResult(null);
  }
}

MediaManager mediaManager =
    CastReceiverContext.getInstance().getMediaManager();
mediaManager.setMediaCommandCallback(new MyMediaCommandCallback());

클라이언트 측 병합

클라이언트 측 병합 에서는 스트림에 광고가 삽입되지 않습니다. Cast Connect의 경우 업데이트 중 AdBreakStatus 드림 에 MediaStatusModifier 먼저 동영상 플레이어에서 재생 속도를 0으로 PlaybackStateCompat 콘텐츠 타임라인 진행을 동결해야 합니다.

Kotlin
// Playback speed should be 0 if content is not playing.
if (adIsPlaying) {
    playbackSpeed = 0.0f
}
val stateBuilder = PlaybackStateCompat.Builder()
    .setActions(AVAILABLE_MEDIA_ACTIONS)
stateBuilder.setState(playbackStateCompat, position, playbackSpeed)
mediaSession.setPlaybackState(stateBuilder.build())
드림
<ph type="x-smartling-placeholder">
</ph>
자바
// Playback speed should be 0 if content is not playing.
if (adIsPlaying) {
    playbackSpeed = 0.0f;
}
PlaybackStateCompat.Builder stateBuilder = new PlaybackStateCompat.Builder()
    .setActions(AVAILABLE_MEDIA_ACTIONS);
stateBuilder.setState(playbackStateCompat, position, playbackSpeed);
mediaSession.setPlaybackState(stateBuilder.build());

광고가 완료되면 이전 재생 속도를 다시 시작해야 합니다.

서버 측 병합

대상 서버 측 병합 광고가 삽입되므로 서버는 하나의 스트림을 콘텐츠와 광고가 모두 포함됩니다. 이 경우 동영상을 계속 재생할 수 있습니다. 타임라인에는 광고의 길이뿐 아니라 있습니다.