事件和通知可協助您管理視訊應用程式的非同步層面。
MediaPlayerStatus物件提供有關播放器狀態變更的資訊。 通知物件提供警告和錯誤的相關資訊。 停止播放視訊的錯誤也會造成播放器狀態變更。 您可以實作事件接聽程式來擷取和回應事件(MediaPlayerEvent物件)。
您的應用程式可以擷取通知和狀態資訊。 使用此資訊,您也可以建立用於診斷和驗證的記錄系統。
MediaPlayerNotification
提供與播放器狀態相關的資訊。
TVSDK提供以下專案的時間順序清單: MediaPlayerNotification
通知,而每個通知都包含下列資訊:
時間戳記
包含下列元素的診斷中繼資料:
type
:資訊、警告或錯誤。
code
:通知的數字表示法。
name
:人類看得懂的通知說明,例如SEEK_ERROR
metadata
:包含通知相關資訊的索引鍵/值組。 例如,名為的索引鍵 URL
會提供一個值,該值為與通知相關的URL。
innerNotification
:對另一個的參照 MediaPlayerNotification
直接影響此通知的物件。
您可以將此資訊儲存在本機,以供日後分析使用,或傳送至遠端伺服器以供記錄及以圖形方式呈現。
您可以接聽通知。
Primetime播放器通知系統的核心為 Notification
類別,代表獨立通知。
若要接收通知,請接聽如下通知:
實作 NotificationEventListener.onNotification()
回撥。
TVSDK傳遞 NotificationEvent
物件至回呼。
通知型別列於 Notification.Type
列舉:
ERROR
INFO
WARNING
您可以使用通知在視訊應用程式中實作即時記錄。
通知系統可讓您收集記錄和偵錯資訊,以進行診斷和驗證,而不需增加系統壓力。
記錄後端不屬於生產設定,且預期不會處理高負載流量。 如果您的實作不需要完全完成,請考慮資料傳輸效率,以避免系統超載。
以下是如何擷取通知的範例:
為您的視訊應用程式建立以計時器為基礎的執行執行緒,以定期查詢TVSDK通知系統所收集的資料。
如果計時器的間隔太大,而事件清單太小,則通知事件清單將會溢位。
若要避免此溢位,請執行下列任一項作業:
序列化JSON格式的最新通知事件專案,並將這些專案傳送至遠端伺服器以供後續處理。
遠端伺服器可以圖形化方式即時顯示提供的資料。
若要偵測通知事件遺失,請尋找事件索引值順序中的間隙。