Android TV Receiver SDK có tính năng hỗ trợ gốc cho các Điểm chèn quảng cáo và quảng cáo đi kèm trong một luồng nội dung nghe nhìn nhất định.
Hãy xem phần Tổng quan về điểm chèn quảng cáo của Web Receiver để 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 quảng cáo xen giữa
Trong ứng dụng Android TV, các điểm chèn quảng cáo được đưa vào phần MediaLoadRequestData.
Các yêu cầu tải có thể được xử lý bình thường và AdBreakClipInfo cũng như AdBreakInfo có thể được truy xuất từ MediaInfo:
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 } } }
public class MyMediaLoadCommandCallback extends MediaLoadCommandCallback { @Override public TaskonLoad(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 để phát đi thông báo rằng ứng dụng của bạn đã bắt đầu phát quảng cáo:
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)
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ể sửa đổi các điểm chèn quảng cáo một cách linh hoạt sau khi một mục được tải:
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})
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 đoạn quảng cáo đang phát, người gửi sẽ cho thấy một nút để bỏ qua đoạn quảng cáo hiện tại nếu đoạn quảng cáo đó có thể bỏ qua. Để cho phép người dùng bỏ qua một đoạn quảng cáo, hãy dùng MediaStatusModifier để thêm lệnh COMMAND_SKIP_AD cho nội dung nghe nhìn:
mMediaManager.getMediaStatusModifier().setMediaCommandSupported(MediaStatus.COMMAND_SKIP_AD, true)
mMediaManager.getMediaStatusModifier().setMediaCommandSupported(MediaStatus.COMMAND_SKIP_AD, true);
Để xử lý lệnh SKIP_AD, hãy triển khai lệnh gọi lại onSkipAd trong MediaCommandCallback của bạn:
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())
public class MyMediaCommandCallback extends MediaCommandCallback { @Override public TaskonSkipAd(RequestData requestData) { // Skip your ad ... return Tasks.forResult(null); } } MediaManager mediaManager = CastReceiverContext.getInstance().getMediaManager(); mediaManager.setMediaCommandCallback(new MyMediaCommandCallback());
Ghép hình phía máy khách
Ghép ở phía máy khách là trường hợp quảng cáo không được nhúng vào luồng phát. Đối với Cast Connect, ngoài việc cập nhật AdBreakStatus trên MediaStatusModifier, bạn phải đặt tốc độ phát thành 0 trên PlaybackStateCompat để người gửi biết cách tạm dừng tiến trình dòng thời gian nội dung.
// 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())
// 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 khôi phục tốc độ phát trước đó.
Ghép phía máy chủ
Đối với tính năng kết hợp phía máy chủ, quảng cáo được nhúng để 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 diễn ra bình thường vì dòng thời gian có thời lượng của quảng cáo ngoài nội dung.