播放器狀態、活動、錯誤和記錄的通知

PTNotification物件提供有關播放器狀態變更、警告和錯誤的資訊。 停止播放視訊的錯誤也會造成播放器狀態變更。

您的應用程式可以擷取通知和狀態資訊。 您也可以使用通知資訊，建立用於診斷和驗證的記錄系統。

TVSDK也有問題 PTMediaPlayerNewNotificationItemEntryNotification 問題發生時 PTNotification.

您可以實作事件接聽程式來擷取和回應事件。 許多事件提供 PTNotification 狀態通知。

通知內容

PTNotification提供與播放器狀態相關的資訊。

TVSDK提供以下專案的時間順序清單： PTNotification 通知。 每個通知都包含下列資訊：

• 時間戳記

• 包含下列元素的診斷中繼資料：

  • type：資訊、警告或錯誤。

  • code：通知的數字表示法。

  • name：人類看得懂的通知說明，例如SEEK_ERROR

  • metadata：包含通知相關資訊的索引鍵/值組。 例如，名為的索引鍵 URL 會提供一個值，該值為與通知相關的URL。

  • innerNotification：對另一個的參照 PTNotification 直接影響此通知的物件。

您可以將此資訊儲存在本機，以供日後分析使用，或傳送至遠端伺服器以供記錄及以圖形方式呈現。

通知設定

TVSDK會為基本通知設定播放器，不過您必須為自訂通知完成相同的設定。

有兩個針對的實作 PTNotification：

• 接聽
• 若要新增自訂通知至 PTNotificationHistory

若要收聽通知，TVSDK會將 PTNotification 類別並將其附加至 PTMediaPlayerItem，此元件已附加至PTMediaPlayer例項。 只有一個 PTNotificationHistory 執行個體依據 PTMediaPlayer.

聆聽通知

有兩種方式可監聽 PTNotification 中的通知 PTMediaPlayer：

1. 手動檢查 PTNotificationHistory 的 PTMediaPlayerItem 使用計時器並檢查差異：

   //Access to the PTMediaPlayerItem
   PTMediaPlayerItem *item = self.player.currentItem;
   PTNotificationHistory *notificationHistory = item.notificationHistory;
   
   //Get the list of notification events from the notification History
   NSArray *notifications = notificationHistory.notificationItems;
   

2. 使用已張貼的 NSNotification 的 PTMediaPlayerPTMediaPlayerNewNotificationEntryAddedNotification.

3. 報名 NSNotification 透過使用的例項 PTMediaPlayer 您要從中取得通知的來源：

   //Register to the NSNotification
   
   [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(onMediaPlayerNotification:)
     name:PTMediaPlayerNewNotificationEntryAddedNotification object:self.player];
   

實作通知回呼

您可以實作通知回呼。

1. 透過取得 PTNotification 從 NSNotification 使用者資訊並使用讀取其值 PTMediaPlayerNotificationKey：

   - (void) onMediaPlayerNotification:(NSNotification *) nsnotification {
       PTNotification *notification = [nsnotification.userInfo objectForKey:PTMediaPlayerNotificationKey];
       NSLog(@"Notification: %@", notification);
   }
   

新增自訂通知

新增自訂通知的方式：建立新的 PTNotification 並將其新增至 PTNotificationHistory 透過使用目前的 PTMediaPlayerItem：

//Access to the PTMediaPlayerItem
PTMediaPlayerItem *item = self.player.currentItem;
PTNotificationHistory *notificationHistory = item.notificationHistory;

//Create notification
PTNotification* notification = [[PTNotification notificationWithType:PTNotificationTypeWarning code:99999 description:@"Custom notification description"];

//Add notification
[notificationHistory addNotification:notification];