Android TV Buyer SDK'sı, belirli bir medya akışı içinde Reklam Araları için yerel destek ve tamamlayıcı reklamlar sunar.
Reklam Aralarının işleyiş şekli hakkında daha fazla bilgi için Web Alıcısı Reklam Aralarına Genel Bakış bölümüne bakın.
Reklam aralarıyla yükü yönetme
Android TV uygulamanızda ara aralar MediaLoadRequestData
öğesindedir.
Yükleme istekleri normal bir şekilde işlenebilir ve AdBreakClipInfo
ile AdBreakInfo
öğeleri MediaInfo
öğesinden alınabilir:
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; }); } }
Reklam araları güncelleniyor
Reklamlar oynatılmaya başladığında, uygulamanızın reklam oynatmaya başladığını bildirmek için MediaStatusModifier
üzerindeki AdBreakStatus
simgesini güncelleyin:
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);
Bir öğe yüklendikten sonra reklam aralarını da dinamik olarak değiştirebilirsiniz:
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});
Reklam atlama özelliğini etkinleştirme ve yönetme
Bir reklam arası oynatılırken gönderenler, geçerli reklam arası klibinin atlanabilir olması durumunda bu klibi atlamak için bir düğme gösterir. Kullanıcının bir reklam arası klibini atlama özelliğini etkinleştirmek için COMMAND_SKIP_AD
medya komutunu eklemek üzere MediaStatusModifier
öğesini kullanın:
mMediaManager.getMediaStatusModifier().setMediaCommandSupported(MediaStatus.COMMAND_SKIP_AD, true)
mMediaManager.getMediaStatusModifier().setMediaCommandSupported(MediaStatus.COMMAND_SKIP_AD, true);
SKIP_AD
komutunu işlemek için MediaCommandCallback
öğelerinize onSkipAd
geri çağırmasını uygulayın:
class MyMediaCommandCallback : MediaCommandCallback() { override fun onSkipAd(requestData: RequestData?): Task{ // Skip your ad ... return Tasks.forResult (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());
İstemci tarafı birleştirme
İstemci tarafı birleştirme, reklamların akışa yerleştirilmediği yerdir. Cast Connect için MediaStatusModifier
'te AdBreakStatus
değerini güncellemenin yanı sıra PlaybackStateCompat
üzerinde oynatma hızını 0 olarak ayarlamanız gerekir. Böylece gönderenler içerik zaman çizelgesi ilerleme durumunu dondurabilir.
// 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());
Reklam sona erdiğinde önceki oynatma hızına devam etmeniz gerekir.
Sunucu tarafı birleştirme
Sunucu tarafı birleştirme için reklamlar yerleştirilir. Böylece sunucunun hem içerik hem de reklamları içeren tek bir akış sağlaması beklenir. Bu durumda, zaman çizelgesi içeriğe ek olarak reklamın süresini içerdiğinden oynatma normal şekilde ilerlemeye devam edebilir.