Rastreamento da reprodução principal no Android track-core-playback-on-android

Configuração de rastreamento inicial

Identifique quando o usuário aciona a intenção de reproduzir (o usuário clica em Reproduzir e/ou a reprodução automática está ativada) e crie uma instância MediaObject.

API de createMediaObject API

StreamTypeConstantes:

MediaTypeConstantes:

MediaHeartbeat.createMediaObject(<MEDIA_NAME>,
  <MEDIA_ID>, <MEDIA_LENGTH>, <STREAM_TYPE>, <MEDIA_TYPE>);

Anexar metadados

Opcionalmente, anexe objetos de metadados padrão e/ou personalizados à sessão de rastreamento por meio de variáveis de dados de contexto.

• Metadados padrão

  Implementar metadados padrão no Android

  note note
  NOTE
  Anexar o objeto de metadados padrão ao objeto de mídia é opcional.

  • Referência da API de chaves de metadados da mídia - Chaves de metadados padrão - Android
  • Consulte o conjunto completo de metadados aqui: Parâmetros de áudio e vídeo

• Metadados personalizados

  Crie um dicionário para as variáveis personalizadas e preencha com os dados desta mídia. Por exemplo:

  code language-java
  HashMap<String, String> mediaMetadata = new HashMap<String, String>(); mediaMetadata.put("isUserLoggedIn", "false"); mediaMetadata.put("tvStation", "Sample TV Station"); mediaMetadata.put("programmer", "Sample programmer");

Rastrear a intenção de iniciar a reprodução

Para começar a rastrear uma sessão de mídia, chame trackSessionStart na instância do Heartbeat de mídia. Por exemplo:

public void onVideoLoad(Observable observable, Object data) {
    _heartbeat.trackSessionStart(mediaInfo, mediaMetadata);
}

Rastrear o início real da reprodução

Identifique o evento do reprodutor de mídia para o início da reprodução, em que o primeiro quadro da mídia é renderizado na tela, e chame trackPlay:

// Video is rendered on the screen) and call trackPlay.
public void onVideoPlay(Observable observable, Object data) {
    _heartbeat.trackPlay();
}

Rastrear a conclusão da reprodução

Identifique o evento do reprodutor de mídia para a conclusão da reprodução, em que o usuário assistiu ao conteúdo até o fim, e chame trackComplete:

public void onVideoComplete(Observable observable, Object data) {
    _heartbeat.trackComplete();
}

Rastrear o final da sessão

Identifique o evento do reprodutor de mídia para o descarregamento/encerramento da reprodução, em que o usuário fecha a mídia, e/ou a mídia é concluída e descarregada, e chame trackSessionEnd:

// Closes the media and/or the media completed and unloaded,
// and call trackSessionEnd().
public void onMainVideoUnload(Observable observable, Object data) {
    _heartbeat.trackSessionEnd();
}

Rastrear todos os cenários de pausa possíveis

Identifique o evento no reprodutor de mídia para pausa de mídia e chame trackPause:

public void onVideoPause(Observable observable, Object data) {
    _heartbeat.trackPause();
}

Pausar cenários

Identifique qualquer cenário no qual o reprodutor de vídeo será pausado e verifique se trackPause foi chamado corretamente. Os seguintes cenários exigem que o aplicativo chame trackPause():

• O usuário faz uma pausa explicitamente no aplicativo.
• O player se coloca no estado Pausa.
• (Aplicativos móveis) - O usuário coloca o aplicativo em segundo plano, mas você deseja que ele mantenha a sessão aberta.
• (Aplicativos móveis) - Qualquer tipo de interrupção de sistema que ocorra e faça com que um aplicativo seja colocado em segundo plano. Por exemplo, o usuário recebe uma chamada ou uma pop-up de outro aplicativo ocorre, mas você deseja que o aplicativo mantenha a sessão ativa para dar ao usuário a oportunidade de retomar a mídia a partir do ponto de interrupção.

Identifique o evento do reprodutor para reprodução e/ou retomada da pausa da mídia e chame trackPlay.

// trackPlay()
public void onVideoPlay(Observable observable, Object data) {
    _heartbeat.trackPlay();
}