Show Menu
TOPICS×

Seguimiento de capítulos y segmentos en Android

Las siguientes instrucciones proporcionan directrices para la implementación mediante SDK de 2.x. Si va a implementar una versión 1.x del SDK, puede descargar la guía del desarrollador aquí: Descargar SDK.

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
    :
    Estas variables solo son necesarias si planea rastrear capítulos.
    Nombre de variable
    Descripción
    Requerido
    name
    Nombre del capítulo
    position
    Posición del capítulo
    length
    Duración del capítulo
    startTime
    Hora de inicio del capítulo
    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.