Effectuer le suivi de la lecture principale sur Android track-core-playback-on-android

Configuration initiale du suivi

Déterminez le moment où l’utilisateur déclenche l’intention de lecture (l’utilisateur clique sur le bouton de lecture et/ou la lecture automatique est activée) et créez une instance MediaObject.

API createMediaObject

StreamTypeConstantes :

MediaTypeConstantes :

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

Ajout de métadonnées

Vous pouvez joindre des métadonnées standard et/ou de publicité à la session de suivi par le biais de variables de données contextuelles.

• Métadonnées standard

  Mise en œuvre de métadonnées standard sur Android

  note note
  NOTE
  Il est facultatif de joindre un objet de métadonnées standard à l’objet multimédia.

  • Référence de l’API des clés de métadonnées multimédia - Clés de métadonnées standard - Android
  • Consultez la liste complète des métadonnées vidéo disponibles dans la rubrique Paramètres audio et vidéo.

• Métadonnées personnalisées

  Créez un dictionnaire pour les variables personnalisées et renseignez les données de ce média. Par exemple :

  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");

Suivi de l’intention de démarrer la lecture

Pour commencer le suivi d’une session multimédia, appelez trackSessionStart sur l’instance Media Heartbeat. Par exemple :

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

Suivi du début réel de la lecture

Identifiez l’événement du lecteur multimédia correspondant au début de la lecture du média, où la première image du média s’affiche à l’écran, et appelez trackPlay :

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

Suivi de la fin de la lecture

Identifiez l’événement du lecteur multimédia correspondant à la fin de la lecture du média, où l’utilisateur a visionné le contenu jusqu’à la fin, et appelez trackComplete :

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

Suivi de la fin de la session

Identifiez l’événement du lecteur multimédia correspondant au déchargement/à la fermeture de la lecture du média, où l’utilisateur ferme la vidéo et/ou le contenu média est terminé et déchargé, et appelez trackSessionEnd :

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

Suivi de tous les scénarios de mise en pause possibles

Identifiez l’événement du lecteur multimédia pour la mise en pause et l’appel multimédia trackPause :

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

Scénarios de mise en pause

Identifiez tous les scénarios dans lesquels le lecteur vidéo sera interrompu et assurez-vous que trackPause est correctement appelé. Les scénarios suivants exigent tous que votre application appelle trackPause() :

• L’utilisateur appuie délibérément sur pause dans l’application.
• Le lecteur se met en pause.
• (Applications mobiles) : l’utilisateur place l’application en arrière-plan, mais vous souhaitez que l’application conserve la session ouverte.
• (Applications mobiles) : tout type d’interruption système qui entraîne la mise en arrière-plan d’une application. Par exemple, l’utilisateur reçoit un appel ou une fenêtre contextuelle provenant d’une autre application apparaît, mais vous souhaitez que l’application conserve la session ouverte pour donner à l’utilisateur la possibilité de reprendre le média à partir du point d’interruption.

Identifiez l’événement du lecteur correspondant à la lecture multimédia et/ou à la reprise multimédia après une interruption et appelez trackPlay.

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