Eventi e notifiche consentono di gestire gli aspetti asincroni dell’applicazione video.
Gli oggetti MediaPlayerStatus forniscono informazioni sulle modifiche allo stato del lettore. Gli oggetti di notifica forniscono informazioni su avvisi ed errori. Gli errori che arrestano la riproduzione del video provocano anche una modifica dello stato del lettore. Implementa listener di eventi per acquisire e rispondere agli eventi (oggetti MediaPlayerEvent).
L'applicazione può recuperare le notifiche e le informazioni sullo stato. Utilizzando queste informazioni, puoi anche creare un sistema di registrazione per la diagnostica e la convalida.
MediaPlayerNotification
fornisce informazioni relative allo stato del lettore.
TVSDK fornisce un elenco cronologico delle notifiche MediaPlayerNotification
e ogni notifica contiene le seguenti informazioni:
Un timestamp
Metadati diagnostici costituiti dai seguenti elementi:
type
: INFORMAZIONI, AVVERTENZA o ERRORE.
code
: Una rappresentazione numerica della notifica.
name
: Una descrizione leggibile della notifica, ad esempio SEEK_ERROR
metadata
: Coppie chiave/valore che contengono informazioni rilevanti sulla notifica. Ad esempio, una chiave denominata URL
fornisce un valore corrispondente a un URL correlato alla notifica.
innerNotification
: Riferimento a un altro MediaPlayerNotification
oggetto che influisce direttamente su questa notifica.
Puoi archiviare queste informazioni localmente per analisi successive o inviarle a un server remoto per la registrazione e la rappresentazione grafica.
Puoi ascoltare le notifiche.
Il nucleo del sistema di notifica di Primetime Player è la classe Notification
che rappresenta una notifica autonoma.
Per ricevere le notifiche, ascolta le notifiche come segue:
Implementa il callback NotificationEventListener.onNotification()
.
TVSDK passa un oggetto NotificationEvent
al callback.
I tipi di notifiche sono enumerati nell'enum Notification.Type
:
ERROR
INFO
WARNING
Puoi utilizzare le notifiche per implementare la registrazione in tempo reale nella tua applicazione video.
Il sistema di notifica consente di raccogliere informazioni di registrazione e debug per scopi diagnostici e di convalida senza stress del sistema.
Il back-end di registrazione non fa parte di una configurazione di produzione e non deve gestire il traffico ad alto carico. Se l’implementazione non deve essere completa, considera l’efficienza della trasmissione dei dati per evitare di sovraccaricare il sistema.
Ecco un esempio di come recuperare le notifiche:
Crea un thread di esecuzione basato su timer per l'applicazione video che esegue periodicamente query sui dati raccolti dal sistema di notifica TVSDK.
Se l'intervallo del timer è troppo grande e le dimensioni dell'elenco eventi sono troppo piccole, l'elenco degli eventi di notifica si sovrapporrà.
Per evitare questo overflow, effettuare una delle seguenti operazioni:
Serializza le voci dell'evento di notifica più recenti in formato JSON e invia le voci a un server remoto per la post-elaborazione.
Il server remoto può visualizzare graficamente i dati forniti in tempo reale.
Per rilevare la perdita degli eventi di notifica, cerca le lacune nella sequenza di valori di indice degli eventi.