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

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

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

TVSDK在發問PTNotification時也會發問PTMediaPlayerNewNotificationItemEntryNotification。

您實作事件監聽器以擷取並回應事件。 許多事件都提供PTNotification狀態通知。

通知內容

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

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

• 時間戳記

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

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

  • code:通知的數字表示。

  • name:通知的可人讀描述，例如SEEK_ERROR

  • metadata:包含通知相關資訊的金鑰／值配對。例如，名為URL的索引鍵提供與通知相關的URL值。

  • innerNotification:直接影響此通 PTNotification 知的對其它對象的引用。

您可以將這些資訊儲存在本機以供日後分析，或將它傳送至遠端伺服器以進行記錄和圖形表示。

通知設定

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

PTNotification有兩種實現：

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

若要監聽通知，TVSDK會執行個體化PTNotification類別，並將它附加至附加至PTMediaPlayer例項的PTMediaPlayerItem例項。 每個PTMediaPlayer只有一個PTNotificationHistory實例。

監聽通知

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

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

   //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. 使用PTMediaPlayerPTMediaPlayerNewNotificationEntryAddedNotification的已發佈NSNotification。

3. 使用您想要收到通知的PTMediaPlayer例項，註冊至NSNotification:

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

實施通知回呼

您可以實作通知回呼。

1. 從NSNotification使用者資訊取得PTNotification並使用PTMediaPlayerNotificationKey讀取其值，以實作通知回呼：

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

新增自訂通知

若要新增自訂通知：
建立新的PTNotification，並使用目前的PTMediaPlayerItem將其新增至PTNotificationHistory:

//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];

Business.Adobe.com 資源