自訂記錄

您可以實作您自己的記錄系統。

除了使用預先定義的通知進行記錄外,您還可以建置使用TVSDK產生之記錄訊息和訊息的記錄系統。 有關預定義通知的詳細資訊,請參閱通知系統。 您可以使用這些記錄檔來疑難排解您的播放器應用程式,並進一步瞭解播放和廣告工作流程。

自訂記錄使用PSDKPTLogFactory的共用單例項,此例項提供將訊息記錄至多個記錄程式的機制。 您可定義並新增(註冊)一或多個記錄程式至PTLogFactory。 這可讓您使用自訂實作來定義多個記錄程式,例如主控台記錄程式、網頁記錄程式或主控台歷史記錄程式。

TVSDK會針對其許多活動產生記錄訊息,而PTLogFactory會將這些訊息轉送至所有已註冊的記錄程式。 您的應用程式也可以產生自訂記錄訊息,這些訊息會轉送至所有已註冊的記錄程式。 每個記錄程式都可篩選訊息並採取適當動作。

PTLogFactory有兩種實現:

  • 用於監聽日誌。
  • 用於向PTLogFactory添加日誌。

監聽日誌

要註冊以監聽日誌:

  1. 實施遵循PTLogger協定的自定義類:

    @implementation PTConsoleLogger
    
    + (PTConsoleLogger *) consoleLogger {
        return [[[PTConsoleLogger alloc] init] autorelease];
    }
    
    - (void)logEntry:(PTLogEntry *)entry {
        //Log the message to the console using NSLog
        NSLog(@"[%@] %@", entry.tag, entry.message);
    }
    
    @end
    
  2. 要註冊實例以接收日誌條目,請將PTLogger實例添加到PTLoggerFactory:

    PTConsoleLogger *logger = [PTConsoleLogger consoleLogger];
    // Either use the addLogger method:
    [[PTLogFactory sharedInstance] addLogger:(logger)]
    
    //Or replace the preceding line with this macro for ease of use
    //PTLogAddLogger(logger);
    

以下是使用PTLogEntry類型篩選記錄檔的範例:

@implementation PTConsoleLogger

+ (PTConsoleLogger *) consoleLogger {
    return [[[PTConsoleLogger alloc] init] autorelease];
}

- (id) init {
    self = [super init];

    if (self) {
        self.logLevel = PTLogEntryTypeInfo;
    }

    return self;
}

- (void)logEntry:(PTLogEntry *) entry {
    //Filtering the entry by log level
    if (entry.type < _logLevel) {
        return;
    }

    //Log the message to the console using NSLog NSLog(@"[%@] %@", entry.tag, entry.message);
}

@end

添加新日誌消息

要註冊以監聽日誌:

  1. 建立新的PTLogEntry並將它新增至thePTLogFactory:

    您可以手動實例化PTLogEntry並將其添加到PTLogFactory共用實例,或使用其中一個宏完成同一任務。

    以下是使用PTLogDebug巨集進行記錄的範例:

// The following line creates an instance of PTLogEntry with type PTLogEntryDebug,
// tag "DEBUG_PLAYBACK", and message "Playback has started".
// Then the PTLogEntry is automatically added to the PTLogFactory

PTLogDebug(@"[DEBUG_PLAYBACK] Playback has started");

本頁內容