Seguimiento de reproducción principal en Android track-core-playback-on-android

Configuración de seguimiento inicial

Identifique el momento en que el usuario desencadena la intención de reproducir (cuando hace clic en reproducir o la reproducción automática está activada) y cree una instancia de MediaObject.

API de createMediaObject

StreamTypeConstantes:

MediaTypeConstantes:

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

Adjuntar metadatos

Opcionalmente, se pueden adjuntar objetos de metadatos estándar o personalizados a la sesión de seguimiento mediante el uso de variables de datos de contexto.

• Metadatos estándar

  Implementación de metadatos estándar en Android

  note note
  NOTE
  No es obligatorio adjuntar el objeto de metadatos estándar al objeto de contenidos.

  • Referencia de API de claves de metadatos de medios: Claves de metadatos estándar de Android
  • Consulte el conjunto completo de metadatos de vídeo disponibles aquí: Parámetros de audio y vídeo.

• Metadatos personalizados

  Cree un diccionario para las variables personalizadas y rellénelo con los datos de estos contenidos. Por ejemplo:

  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");

Realice un seguimiento de la intención de iniciar la reproducción

Para empezar a realizar el seguimiento de una sesión multimedia, invoque trackSessionStart en la instancia de Media Heartbeat. Por ejemplo:

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

Realizar un seguimiento del inicio real de la reproducción

Identifique el evento del reproductor de contenidos para el principio de la reproducción de contenido, cuando se renderice el primer fotograma del contenido en la pantalla, e invoque trackPlay:

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

Realizar un seguimiento de la finalización de la reproducción

Identifique el evento del reproductor de contenidos para la finalización de la reproducción del contenido cuando el usuario ha visto el contenido hasta el final e invoque trackComplete:

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

Realizar un seguimiento del final de la sesión

Identifique el evento del reproductor de contenidos para la carga o el cierre de la reproducción de contenido, cuando el usuario cierra o se completa la descarga, e invoque 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 los escenarios de pausa posibles

Identifique el evento desde el reproductor de contenido para que los contenidos se detengan e invoque trackPause:

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

Pausar escenarios

Identifique cualquier situación en la que se pausará el reproductor y compruebe que se ha invocado trackPause correctamente. Las siguientes situaciones requieren que la aplicación invoque trackPause():

• El usuario hace una pausa explícita en la aplicación.
• El reproductor se pone en estado de pausa.
• (Aplicaciones móviles): El usuario pone la aplicación en segundo plano, pero desea que la aplicación mantenga abierta la sesión.
• (Aplicaciones móviles): Se produce cualquier tipo de interrupción del sistema que provoca que una aplicación se ponga en segundo plano. Por ejemplo, si el usuario recibe una llamada o aparece una ventana emergente de otra aplicación, pero desea que la aplicación mantenga la sesión activa para que el usuario pueda reanudar el contenido desde donde se produjo la interrupción.

Identifique el evento del reproductor para la reproducción o reanudación de contenido después de la pausa e invoque trackPlay.

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