דף זה תורגם על ידי Cloud Translation API.

הפסקות למודעות

‫Android TV Receiver SDK כולל תמיכה מובנית בהפסקות פרסומיות ובמודעות נלוות בתוך סטרימינג של מדיה.

מידע נוסף על אופן הפעולה של הפסקות הפרסום זמין במאמר סקירה כללית על הפסקות פרסום ב-Web Receiver.

איך לטפל בעומס באמצעות הפסקות למודעות

באפליקציית Android TV, ההפסקות כלולות בMediaLoadRequestData. אפשר לעבד בקשות טעינה כרגיל, ואפשר לאחזר את AdBreakClipInfos ואת AdBreakInfos מ-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;
    });
    }
}

עדכון של הפסקות למודעות

כשמודעות מתחילות לפעול, צריך לעדכן את הערך של 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)

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

אפשר גם לשנות באופן דינמי את ההפסקות למודעות אחרי שטוענים פריט:

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

הפעלה של דילוג על מודעות וטיפול בדילוג

במהלך הפסקת פרסומות, השולחים יציגו לחצן לדילוג על קטע הפרסומות הנוכחי אם אפשר לדלג עליו. כדי לאפשר למשתמש לדלג על קטע של הפסקת פרסומות, משתמשים בפקודה MediaStatusModifier כדי להוסיף את פקודת המדיה COMMAND_SKIP_AD:

Kotlin

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

Java

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

כדי לטפל בפקודה SKIP_AD, מטמיעים את הקריאה החוזרת (callback) 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())

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

חיבור בצד הלקוח

הצמדת מודעות בצד הלקוח היא מצב שבו המודעות לא מוטמעות בסטרימינג. ב-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())

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

אחרי שהמודעה מסתיימת, צריך להחזיר את מהירות ההפעלה הקודמת.

שילוב נתונים בצד השרת

במקרה של הצמדה בצד השרת, המודעות מוטמעות כך שהשרת אמור לספק סטרימינג יחיד שמכיל גם את התוכן וגם את המודעות. במקרה כזה, ההפעלה יכולה להימשך כרגיל כי ציר הזמן כולל את משך המודעה בנוסף לתוכן.

המתנה בתור

כלי לאימות סשנים במדיה

הפסקות למודעות קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

איך לטפל בעומס באמצעות הפסקות למודעות

עדכון של הפסקות למודעות

הפעלה של דילוג על מודעות וטיפול בדילוג

חיבור בצד הלקוח

שילוב נתונים בצד השרת

הפסקות למודעות