Tracciare la riproduzione di base su Android track-core-playback-on-android

Configurazione del tracciamento iniziale

Identifica quando l’utente attiva l’intenzione di riproduzione (l’utente fa clic su play e/o l’esecuzione automatica è attiva) e crea un’istanza MediaObject.

API createMediaObject

StreamTypeCostanti:

MediaTypeCostanti:

MediaHeartbeat.createMediaObject(<MEDIA_NAME>,
  <MEDIA_ID>, <MEDIA_LENGTH>, <STREAM_TYPE>, <MEDIA_TYPE>);

Allega metadati

Facoltativamente, allega oggetti metadati standard e/o personalizzati alla sessione di tracciamento tramite variabili di dati di contesto.

• Metadati standard

  Implementazione dei metadati standard su Android

  note note
  NOTE
  Il collegamento dell’oggetto metadati standard all’oggetto multimediale è facoltativo.

  • Riferimento API per le chiavi di metadati multimediali - Chiavi metadati standard - Android
  • Vedi il set completo di metadati video disponibili qui: Parametri audio e video

• Metadati personalizzati

  Crea un dizionario per le variabili personalizzate e compilalo con i dati per questo file multimediale. Ad esempio:

  code language-java
  HashMap<String, String> mediaMetadata = new HashMap<String, String>(); mediaMetadata.put("isUserLoggedIn", "false"); mediaMetadata.put("tvStation", "Sample TV Station"); mediaMetadata.put("programmer", "Sample programmer");

Tracciare l’intenzione di avviare la riproduzione

Per iniziare a tracciare una sessione multimediale, chiama trackSessionStart sull’istanza Media Heartbeat. Ad esempio:

public void onVideoLoad(Observable observable, Object data) {
    _heartbeat.trackSessionStart(mediaInfo, mediaMetadata);
}

Tracciare l’inizio effettivo della riproduzione

Identifica l’evento dal lettore multimediale relativo all’inizio della riproduzione, dove viene eseguito il rendering del primo fotogramma del contenuto multimediale sullo schermo, e chiama trackPlay:

// Video is rendered on the screen) and call trackPlay.
public void onVideoPlay(Observable observable, Object data) {
    _heartbeat.trackPlay();
}

Tracciare il completamento della riproduzione

Identifica l’evento dal lettore multimediale relativo al completamento della riproduzione multimediale, in cui l’utente ha guardato il contenuto fino alla fine, e chiama trackComplete:

public void onVideoComplete(Observable observable, Object data) {
    _heartbeat.trackComplete();
}

Tracciare la fine della sessione

Identifica l’evento dal lettore multimediale relativo allo scaricamento/chiusura della riproduzione multimediale, in cui l’utente chiude il contenuto multimediale e/o il contenuto viene completato e scaricato, e chiama trackSessionEnd:

// Closes the media and/or the media completed and unloaded,
// and call trackSessionEnd().
public void onMainVideoUnload(Observable observable, Object data) {
    _heartbeat.trackSessionEnd();
}

Tracciare tutti i possibili scenari di pausa

Identifica l’evento dal lettore multimediale relativo alla sospensione del contenuto multimediale e chiama trackPause:

public void onVideoPause(Observable observable, Object data) {
    _heartbeat.trackPause();
}

Scenari di sospensione

Identifica uno scenario in cui il lettore video si interrompe e verifica che trackPause sia chiamato correttamente. I seguenti scenari richiedono tutti una chiamata trackPause() dall’app:

• L’utente mette esplicitamente in pausa l’app.
• Il lettore si mette in pausa da solo.
• (App per dispositivi mobili): l’utente mette l’applicazione in background, ma si desidera invece che l’app mantenga aperta la sessione.
• (App per dispositivi mobili) - Può verificarsi qualsiasi tipo di interruzione di sistema che porta l’applicazione in background. Ad esempio, l’utente riceve una chiamata oppure la notifica da un’altra applicazione, ma desideri che l’applicazione mantenga aperta la sessione per dare all’utente l’opportunità di riprendere l’elemento multimediale dal punto in cui è stato interrotto.

Identifica l’evento dal lettore relativo alla riproduzione e/o la ripresa di contenuti multimediali dalla sospensione e chiama trackPlay.

// trackPlay()
public void onVideoPlay(Observable observable, Object data) {
    _heartbeat.trackPlay();
}