Seguimiento de capítulos y segmentos en Android

Las siguientes instrucciones proporcionan directrices para la implementación mediante SDK de 2.x.

Implementación del seguimiento de capítulos

1. Identifique cuándo se produce el evento de inicio de capítulo y cree la instancia de ChapterObject con la información del capítulo.

   Referencia de seguimiento de capítulos ChapterObject:

   NOTA

   Estas variables solo son necesarias si planea rastrear capítulos.

   Nombre de variable	Descripción	Requerido
   name	Nombre del capítulo	Sí
   position	Posición del capítulo	Sí
   length	Duración del capítulo	Sí
   startTime	Hora de inicio del capítulo	Sí

   Objeto de capítulo:

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

2. Si incluye metadatos personalizados para el capítulo, cree las variables de datos de contexto para los metadatos:

   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. Para empezar a rastrear la reproducción del capítulo, invoque el evento ChapterStart en la instancia de MediaHeartbeat

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

4. Cuando la reproducción llega al final del capítulo, como se define en el código personalizado, invoque el evento ChapterComplete en la instancia de MediaHeartbeat:

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

5. Si no se ha completado la reproducción del capítulo porque el usuario ha elegido omitirlo (por ejemplo, si el usuario hace clic en la línea de tiempo para saltar el capítulo), invoque el evento ChapterSkip en la instancia de MediaHeartbeat:

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

6. Si hay más capítulos, repita los pasos del 1 al 5.