Show Menu
TOPICS×

Rastrear capítulos e segmentos no Android

As instruções a seguir fornecem orientação para a implementação usando SDKs 2.x. Se estiver implementando uma versão 1.x do SDK, você pode baixar o Guia dos desenvolvedores aqui: Baixar SDKs.

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
    :
    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.