Điểm chèn quảng cáo

SDK Bộ thu Android TV có hỗ trợ riêng cho Điểm chèn quảng cáo và Quảng cáo đồng hành quảng cáo trong một luồng phương tiện truyền thông nhất định.

Xem Tổng quan về điểm chèn quảng cáo của trình thu nhận web để biết thêm thông tin về cách hoạt động của Điểm chèn quảng cáo.

Xử lý lượt tải bằng điểm chèn quảng cáo

Trên ứng dụng Android TV, điểm chèn quảng cáo có trong MediaLoadRequestData. Yêu cầu tải có thể được xử lý bình thường và AdBreakClipInfo giây và AdBreakInfo giây có thể truy xuất được từ 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
    }
  }
}
Java
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;
    });
    }
}

Cập nhật điểm chèn quảng cáo

Khi quảng cáo bắt đầu phát, hãy cập nhật AdBreakStatus trên MediaStatusModifier để truyền tin rằng ứng dụng của bạn đã bắt đầu phát quảng cáo:

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)
Java
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);

Bạn cũng có thể tự động sửa đổi điểm chèn quảng cáo sau khi tải một mục:

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})
Java
AdBreakClipInfo breakClip1 = ...
AdBreakClipInfo breakClip2 = ...
AdBreakClipInfo breakClip3 = ...

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

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

Bật và xử lý việc bỏ qua quảng cáo

Khi một điểm chèn quảng cáo đang phát, người gửi sẽ hiển thị một nút để bỏ qua quảng cáo hiện tại đoạn video chèn quảng cáo nếu có thể bỏ qua. Để cho phép người dùng bỏ qua quảng cáo ngắt đoạn video, sử dụng MediaStatusModifier để thêm COMMAND_SKIP_AD lệnh đa phương tiện:

Kotlin
mMediaManager.getMediaStatusModifier().setMediaCommandSupported(MediaStatus.COMMAND_SKIP_AD, true)
Java
mMediaManager.getMediaStatusModifier().setMediaCommandSupported(MediaStatus.COMMAND_SKIP_AD, true);

Để xử lý lệnh SKIP_AD, hãy triển khai phương thức onSkipAd cuộc gọi lại trong 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())
Java
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());

Ghép phía máy khách

Ghép phía máy khách là nơi quảng cáo không được nhúng vào luồng. Đối với Cast Connect, ngoài đang cập nhật AdBreakStatus trên MediaStatusModifier bạn phải đặt tốc độ phát là 0 trên PlaybackStateCompat để người gửi biết cần cố định tiến trình của dòng thời gian nội dung.

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())
Java
// 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());

Sau khi quảng cáo kết thúc, bạn nên tiếp tục tốc độ phát trước đó.

Ghép phía máy chủ

Cho ghép phía máy chủ, quảng cáo được nhúng, nên máy chủ dự kiến sẽ cung cấp một luồng duy nhất chứa cả nội dung và quảng cáo. Trong trường hợp này, quá trình phát có thể tiếp tục đang diễn ra bình thường vì dòng thời gian còn chứa thời lượng của quảng cáo vào nội dung.