使用廣告自訂播放

當播放達到廣告插播、通過廣告插播或結束廣告插播時,TVSDK會為目前播放點的位置定義一些預設行為。

秘訣

您可以覆寫預設行為,方法是使用 PTAdPolicySelector 類別。

預設行為會有所不同,具體取決於使用者在正常播放期間或透過在視訊中搜尋而經過廣告插播。

您可以透過下列方式自訂廣告播放行為:

  • 儲存使用者停止觀看視訊的位置,並在未來工作階段的相同位置繼續播放。

  • 如果向使用者呈現廣告插播,則會在數分鐘內不顯示其他廣告,即使使用者尋求新位置亦然。

  • 如果內容在幾分鐘後無法播放,請重新啟動資料流或容錯移轉至相同內容的不同來源。

    在容錯移轉播放工作階段上,若要允許使用者略過廣告並繼續至先前失敗的位置,您可以停用前段和/或中段廣告。 TVSDK提供啟用略過前段和中段廣告的方法。

廣告播放的API元素

TVSDK提供類別和方法,讓您可用於自訂包含廣告之內容的播放行為。
下列API元素對於自訂播放很有用:

API元素 支援廣告的內容
PTAdMetadata 控制廣告插播是否應標示為已由檢視者觀看,如果是,何時可標示為。 使用設定並取得watched原則 adBreakAsWatched 屬性。
ptadPolicySelector 允許自訂TVSDK廣告行為的通訊協定。
PTDefaultAdPolicySelector 實作預設TVSDK行為的類別。 您的應用程式可以覆寫此類別來自訂預設行為,而無需實作完整的介面。
PTMediaPlayer
  • localTime .

    這是播放的本機時間,不包括置入的廣告插播。

  • seekToLocaltime .

    在此處,搜尋會相對於資料流中的當地時間進行。

  • getTimeline.convertToLocalTime .

    時間軸上的虛擬位置會轉換為本機位置。

PTAdBreak iswatched 屬性。 指出檢視器是否已觀看廣告。

設定自訂播放

在您可以自訂或覆寫廣告行為之前,請先使用TVSDK註冊廣告原則執行個體。

若要自訂廣告行為,請執行下列任一項作業:

  • 遵守 PTAdPolicySelector 通訊協定,並實作所有必要的原則選取方法。

    如果您需要覆寫,建議使用此選項 全部 預設廣告行為。

  • 覆寫 PTDefaultAdPolicySelector 類別並提供僅用於需要自訂之行為的實作。

    如果您只需要覆寫,則建議使用此選項 部分 預設行為的URL。

針對這兩個選項,請完成下列作業:

  1. 透過使用者端Factory註冊TVSDK要使用的原則執行個體。

    注意

    在播放開始時註冊的自訂廣告原則會在以下情況時清除: PTMediaPlayer 執行個體已取消配置。 您的應用程式每次建立新的播放工作階段時,都必須註冊原則選擇器執行個體。

    例如:

    // Create an instance of the custom policy selector
    PTS5MinuteSkipBreakPolicySelector *adPolicySelector
         = [[[PTS5MinuteSkipBreakPolicySelector alloc] initWithMediaPlayer:self.player] autorelease];
    
    // register this instance
    [[PTDefaultMediaPlayerClientFactory defaultFactory] registerAdPolicySelector:adPolicySelector];
    
  2. 實施您的自訂。

略過一段時間的廣告插播

依預設,當使用者搜尋廣告插播時,TVSDK會強製播放廣告插播。 如果從前一個插播完成經過的時間是在特定分鐘數內,您可以自訂略過廣告插播的行為。

重要

當有要略過廣告的內部搜尋時,播放可能會稍微暫停。

以下自訂廣告原則選擇器的範例會在使用者觀看廣告插播後的五分鐘(牆上時鐘時間)內略過廣告。

  1. 透過使用者端Factory註冊TVSDK要使用的原則執行個體。

    // Create an instance of the custom policy selector
    PTS5MinuteSkipBreakPolicySelector *adPolicySelector
         = [[[PTS5MinuteSkipBreakPolicySelector alloc] initWithMediaPlayer:self.player] autorelease];
    
    // register this instance
    [[PTDefaultMediaPlayerClientFactory defaultFactory] registerAdPolicySelector:adPolicySelector];
    
  2. 實作您的自訂。

PTS5MinuteSkipBreakPolicySelector.h

#import "PTMediaPlayerNotifications.h"
#import "PTMediaPlayer.h"
#import "PTDefaultAdPolicySelector.h"

//  extend the default policy
selector@interface PTS5MinuteSkipBreakPolicySelector : PTDefaultAdPolicySelector

- (id)initWithMediaPlayer:(PTMediaPlayer *)player;

@end

PTS5MinuteSkipBreakPolicySelector.m

#import "PTS5MinuteSkipBreakPolicySelector.h"

double MIN_BREAK_INTERVAL  = 60 * 5; // 5 minutes

@implementation PTS5MinuteSkipBreakPolicySelector
{
    PTMediaPlayer *_player;
    NSTimeInterval _lastAdBreakPlayedTime;
}

- (id)initWithMediaPlayer:(PTMediaPlayer *)player
{
    if (self = [super init])
    {
        _lastAdBreakPlayedTime = 0;
        _player = [player retain];
        [self addobservers];
    }

    return self;
}

- (NSArray *)selectAdBreaksToPlay:(PTAdPolicyInfo *)info
{
    NSLog(@"%@ - selectAdBreaksToPlay (%f): %f", self,
        CMTimeGetSeconds(info.currentTime), _lastAdBreakPlayedTime);

    BOOL shouldPlay = [self shouldPlayAdBreaks];
    if (shouldPlay)
    {
        return [super selectAdBreaksToPlay:info];
    }

    return nil;
}

- (PTAdBreakPolicyType)selectPolicyForAdBreak:(PTAdPolicyInfo *)info
{
    NSLog(@"%@ - selectPolicyForAdBreak (%f): %f  %f", self,
            CMTimeGetSeconds(info.currentTime), _lastAdBreakPlayedTime,
            [[NSDate date] timeIntervalSince1970]);

    BOOL shouldPlay = [self shouldPlayAdBreaks];
    if (shouldPlay)
    {
        return [super selectPolicyForAdBreak:info];
    }

    return PTAdBreakPolicyTypeSkip;
}

- (BOOL)shouldPlayAdBreaks
{
    NSTimeInterval currentTime = [[NSDate date] timeIntervalSince1970];
    if (_lastAdBreakPlayedTime <= 0)
    {
        return YES;
    }

    if (_lastAdBreakPlayedTime > 0 && (currentTime - _lastAdBreakPlayedTime) > MIN_BREAK_INTERVAL)
    {
        return YES;
    }

    // don't play any ad break if 5 minutes hasn't elapsed
    return NO;
}

- (void) onMediaPlayerAdBreakStarted:(NSNotification *) notification
{
    NSLog(@"%@ - AdBreak Start", self);
}

- (void) onMediaPlayerAdBreakCompleted:(NSNotification *) notification
{
    _lastAdBreakPlayedTime = [[NSDate date] timeIntervalSince1970];
    NSLog(@"%@ - AdBreak Complete at: %f", self, _lastAdBreakPlayedTime);
}

- (void)addobservers
{
    [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(onMediaPlayerAdBreakStarted:)
                name:PTMediaPlayerAdBreakStartedNotification object:_player];
    [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(onMediaPlayerAdBreakCompleted:)
                name:PTMediaPlayerAdBreakCompletedNotification object:_player];
}

- (void)removeObservers
{
    [[NSNotificationCenter defaultCenter] removeObserver:self];
}

- (void)dealloc
{
    [self removeObservers];
    [_player release];
    [super dealloc];
}

@end

儲存視訊位置並在稍後繼續

您可以將目前的播放位置儲存在視訊中,並在未來的工作階段中於相同位置繼續播放。

動態插入的廣告會因使用者工作階段而異,因此會儲存位置 替換為 拼接廣告是指未來工作階段中的不同位置。 TVSDK提供的方法可擷取播放位置,同時忽略拼接的廣告。

  1. 當使用者結束視訊時,您的應用程式會擷取並儲存視訊中的位置。

    秘訣

    不包含廣告持續時間。

    由於廣告模式、頻率上限等原因,每個工作階段中的廣告插播可能會有所不同。 一個工作階段中目前的視訊時間,可能會與未來工作階段中的不同。 在視訊中儲存位置時,應用程式會擷取當地時間。 使用 localTime 屬性來讀取此位置,您可以將其儲存在裝置上或伺服器的資料庫中。

    例如,如果使用者在影片的第20分鐘處,且此位置包含五分鐘的廣告, currentTime 將會是1200秒,而 localTime 在此位置將為900秒。

    重要

    即時/線性資料流的當地時間和目前時間相同。 在這種情況下, convertToLocalTime 沒有效果。 對於VOD,播放廣告時當地時間保持不變。

    - (void) onMediaPlayerTimeChange:(NSNotification *)notification {
        CMTimeRange seekableRange = self.player.seekableRange;
    
        if (CMTIMERANGE_IS_VALID(seekableRange)) {
            double seekableRangeStart = CMTimeGetSeconds(seekableRange.start);
            double seekableRangeDuration = CMTimeGetSeconds(seekableRange.duration);
            double currentTime = CMTimeGetSeconds(self.player.currentTime); // includes ads
            double localTime = CMTimeGetSeconds(self.player.localTime); // no ads
        }
    }
    
  2. 若要在相同位置恢復視訊:若要從先前作業階段儲存的位置恢復播放視訊,請使用 seekToLocalTime

    秘訣

    此方法只會以本機時間值呼叫。 如果使用目前時間結果呼叫方法,則會發生錯誤行為。

    若要搜尋到目前的時間,請使用 seekToTime.

  3. 當您的應用程式收到 PTMediaPlayerStatusReady 狀態變更事件,尋找已儲存的當地時間。

    [self.player seekToLocalTime:CMTimeMake(900, 1) completionHandler:^(BOOL finished) {
        [self.player play];
    }];
    
  4. 提供廣告原則介面中指定的廣告插播。

  5. 透過擴充預設廣告原則選擇器,實作自訂廣告原則選擇器。

  6. 透過實作,提供必須展示給使用者的廣告插播 selectAdBreaksToPlay

    注意

    此方法包括前段廣告插播和當地時間位置之前的中段廣告插播。 您的應用程式可以決定播放前段廣告插播並繼續到指定的當地時間、播放中段廣告插播並繼續到指定的當地時間,或不播放任何廣告插播。

本頁內容