خرابی های تبلیغاتی

کیت توسعه نرم‌افزاری گیرنده تلویزیون اندروید (Android TV Receiver SDK) از پشتیبانی بومی برای نمایش تبلیغات لحظه‌ای (Ad Breaks) و تبلیغات همراه در یک جریان رسانه‌ای مشخص برخوردار است.

برای اطلاعات بیشتر در مورد نحوه عملکرد Ad Breakها، به مرور کلی Ad Breakهای گیرنده وب مراجعه کنید.

مدیریت بار با وقفه‌های تبلیغاتی

در برنامه Android TV شما، وقفه‌ها در MediaLoadRequestData گنجانده شده‌اند. درخواست‌های بارگذاری می‌توانند به طور عادی پردازش شوند و AdBreakClipInfo و AdBreakInfo را می‌توان از 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 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 به‌روزرسانی کنید تا اعلام شود که برنامه شما شروع به پخش تبلیغات کرده است:

کاتلین

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

همچنین می‌توانید پس از بارگذاری یک آیتم، به صورت پویا، نمایش تبلیغات را تغییر دهید:

کاتلین

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

فعال کردن و مدیریت رد کردن تبلیغات

وقتی یک تبلیغ در حال پخش است، اگر کلیپ تبلیغ قابل رد شدن باشد، فرستندگان دکمه‌ای را برای رد کردن آن نشان می‌دهند. برای فعال کردن امکان رد کردن یک کلیپ تبلیغ، از MediaStatusModifier برای اضافه کردن دستور رسانه COMMAND_SKIP_AD استفاده کنید:

کاتلین

mMediaManager.getMediaStatusModifier().setMediaCommandSupported(MediaStatus.COMMAND_SKIP_AD, true)

جاوا

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

برای مدیریت دستور SKIP_AD ، تابع فراخوانی onSkipAd را در MediaCommandCallback خود پیاده‌سازی کنید:

کاتلین

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 Task onSkipAd(RequestData requestData) {
    // Skip your ad
    ...
    return Tasks.forResult(null);
  }
}

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

دوخت سمت کلاینت

دوخت سمت کلاینت جایی است که تبلیغات در جریان جاسازی نمی‌شوند. برای Cast Connect، علاوه بر به‌روزرسانی AdBreakStatus در MediaStatusModifier ، باید سرعت پخش را در PlaybackStateCompat روی ۰ تنظیم کنید تا فرستندگان بدانند که باید پیشرفت جدول زمانی محتوا را متوقف کنند.

کاتلین

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

پس از پایان تبلیغ، باید سرعت پخش قبلی را از سر بگیرید.

دوخت سمت سرور

برای دوخت سمت سرور ، تبلیغات جاسازی می‌شوند، بنابراین انتظار می‌رود سرور یک جریان واحد ارائه دهد که شامل محتوا و تبلیغات باشد. در این حالت، پخش می‌تواند به طور عادی ادامه یابد زیرا جدول زمانی علاوه بر محتوا، مدت زمان تبلیغ را نیز شامل می‌شود.