自訂記錄

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

除了使用預先定義的通知進行記錄外，您還可以建置使用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

添加新日誌消息

要註冊以監聽日誌：

建立新的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");

本頁內容