Tracciamento capitoli e segmenti su Android

Le istruzioni seguenti forniscono indicazioni per l'implementazione tramite SDK 2.x.

Implementare il tracciamento dei capitoli

1. Identificare quando si verifica l'evento di inizio del capitolo e creare l'istanza ChapterObject utilizzando le informazioni del capitolo.

   ChapterObject riferimento di tracciamento dei capitoli:

   NOTA

   Queste variabili sono necessarie solo se intendi tenere traccia dei capitoli.

   Nome variable	Descrizione	Obbligatorio
   name	Nome del capitolo	Sì
   position	Posizione del capitolo	Sì
   length	Lunghezza del capitolo	Sì
   startTime	Ora di inizio capitolo	Sì

   Oggetto capitolo:

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

2. Se includi metadati personalizzati per il capitolo , crea le variabili di dati di contesto per i metadati:

   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. Per iniziare a tenere traccia della riproduzione del capitolo, chiama l'evento ChapterStart nell'istanza MediaHeartbeat:

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

4. Quando la riproduzione raggiunge il limite finale del capitolo, come definito dal codice personalizzato, invoca l'evento ChapterComplete nell'istanza MediaHeartbeat:

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

5. Se la riproduzione del capitolo non è stata completata perché l'utente ha scelto di saltare il capitolo (ad esempio, se l'utente cerca fuori dal limite del capitolo), chiamare l'evento ChapterSkip nell'istanza MediaHeartbeat:

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

6. In caso di capitoli aggiuntivi, ripetere i punti da 1 a 5.