Rastrear capítulos e segmentos no Android

As instruções a seguir fornecem orientação para a implementação usando SDKs 2.x.

Implementar o rastreamento de capítulo

1. Identifique quando ocorre o evento de início do capítulo e crie a instância ChapterObject usando as informações do capítulo.

   Referência de rastreamento de capítulo ChapterObject:

   OBSERVAÇÃO

   Essas variáveis somente são necessárias se você estiver planejando rastrear capítulos.

   Nome da variável	Descrição	Obrigatório
   name	Nome do capítulo	Sim
   position	Posição do capítulo	Sim
   length	Extensão do capítulo	Sim
   startTime	Hora de início do capítulo	Sim

   Objeto do capítulo:

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

2. Se você incluir metadados personalizados para o capítulo, crie as variáveis de dados de contexto para os metadados:

   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 começar a rastrear a reprodução do capítulo, chame o evento ChapterStart na instância MediaHeartbeat:

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

4. Quando a reprodução atingir o limite final do capítulo, conforme definido pelo seu código personalizado, chame o evento ChapterComplete na instância MediaHeartbeat:

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

5. Se a reprodução do capítulo não tiver sido concluída porque o usuário optou por ignorar o capítulo (por exemplo, se o usuário sair do limite do capítulo), chame o evento ChapterSkip na instância MediaHeartbeat:

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

6. Se houver capítulos adicionais, repita as etapas de 1 até 5.