Suivre les chapitres et les segments sur Android

Les instructions suivantes fournissent des conseils pour la mise en œuvre à l’aide des kits SDK 2.x.

Mise en œuvre du suivi des chapitres

1. Identifiez le moment où a lieu l’événement de début de chapitre et créez l’instance ChapterObject à l’aide des informations de chapitre.

   ChapterObject référence de suivi de chapitre :

   REMARQUE

   Ces variables ne sont nécessaires que si vous envisagez d’effectuer le suivi des chapitres.

   Nom de variable	Description	Obligatoire
   name	Nom du chapitre	Oui
   position	Position du chapitre	Oui
   length	Durée du chapitre	Oui
   startTime	Heure de début du chapitre	Oui

   Objet de chapitre :

   MediaObject chapterDataInfo =
     MediaHeartbeat.createChapterObject(<CHAPTER_NAME>,
                                        <POSITION>,
                                        <LENGTH>,
                                        <START_TIME>);
   

2. Si vous incluez des métadonnées personnalisées pour le chapitre, créez les variables de données contextuelles pour les métadonnées :

   HashMap<String, String> chapterMetadata =
     new HashMap<String,String>();
   chapterMetadata.put("segmentType", "Sample Segment Type");
   chapterMetadata.put("segmentName", "Sample Segment Name");
   chapterMetadata.put("segmentInfo", "Sample Segment Info");
   

3. Pour lancer le suivi de la lecture du chapitre, appelez l’événement ChapterStart dans l’instance MediaHeartbeat :

   public void onChapterStart(Observable observable, Object data) {
       _heartbeat.trackEvent(MediaHeartbeat.Event.ChapterStart,
                             chapterDataInfo,
                             chapterMetadata);
   }
   

4. Lorsque la lecture atteint la limite de fin du chapitre, comme défini par votre code personnalisé, appelez l’événement ChapterComplete dans l’instance MediaHeartbeat :

   public void onChapterComplete(Observable observable, Object data) {
       _heartbeat.trackEvent(MediaHeartbeat.Event.ChapterComplete, null, null);
   }
   

5. Si la lecture du chapitre ne s’est pas terminée car l’utilisateur a choisi d’ignorer le chapitre (par exemple, si l’utilisateur effectue une recherche en dehors de la limite du chapitre), appelez l’événement ChapterSkip dans l’instance MediaHeartbeat :

   public void onChapterSkip(Observable observable, Object data) {
       _heartbeat.trackEvent(MediaHeartbeat.Event.ChapterSkip, null, null);
   }
   

6. S’il existe d’autres chapitres, répétez les étapes 1 à 5.

Ressources Business.Adobe.com