Seguimiento de reproducción principal en Roku

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

   MediaObjectReferencia de:

   Nombre de variable	Descripción	Requerido
   name	Nombre del vídeo	Sí
   mediaid	Identificador único de vídeo	Sí
   length	Duración del vídeo	Sí
   streamType	Tipo de flujo (consulte Constantes de StreamType a continuación)	Sí
   mediaType	Tipo de contenido (consulte Constantes de MediaType a continuación)	Sí

   StreamTypeConstantes de:

   Nombre de la constante	Descripción
   MEDIA_STREAM_TYPE_VOD	Tipo de emisión de vídeo bajo demanda.
   MEDIA_STREAM_TYPE_LIVE	Tipo de emisión de contenido en directo.
   MEDIA_STREAM_TYPE_LINEAR	Tipo de emisión de contenido lineal.
   MEDIA_STREAM_TYPE_AOD	Tipo de emisión de audio a la carta.
   MEDIA_STREAM_TYPE_AUDIOBOOK	Tipo de emisión de audiolibro.
   MEDIA_STREAM_TYPE_PODCAST	Tipo de emisión de podcast.

   MediaTypeConstantes de:

   Nombre de la constante	Descripción
   MEDIA_STREAM_TYPE_AUDIO	Tipo de contenido para emisiones de audio.
   MEDIA_STREAM_TYPE_VIDEO	Tipo de contenido para emisiones de vídeo.

   Cree un objeto de información multimedia para vídeo con contenido de VOD:

    mediaInfo = adb_media_init_mediainfo(
     "<MEDIA_NAME>",
     "<MEDIA_ID>",
     600,
     ADBMobile().MEDIA_STREAM_TYPE_VOD,
     ADBMobile().MEDIA_TYPE_VIDEO
   )
   

   O bien

   mediaInfo = adb_media_init_mediainfo()
   mediaInfo.name = "<MEDIA_NAME>"
   mediaInfo.id = "<MEDIA_ID>"
   mediaInfo.length = 600
   mediaInfo.streamType = ADBMobile().MEDIA_STREAM_TYPE_VOD
   mediaInfo.mediaType = ADBMobile().MEDIA_TYPE_VIDEO
   

   Cree un objeto de información multimedia para vídeo con contenido de AOD:

   mediaInfo = adb_media_init_mediainfo(
    "<MEDIA_NAME>",
    "<MEDIA_ID>",
    600,
    ADBMobile().MEDIA_STREAM_TYPE_AOD,
    ADBMobile().MEDIA_TYPE_AUDIO
   )
   

   O bien

   mediaInfo = adb_media_init_mediainfo()
   mediaInfo.name = "<MEDIA_NAME>"
   mediaInfo.id = "<MEDIA_ID>"
   mediaInfo.length = 600
   mediaInfo.streamType = ADBMobile().MEDIA_STREAM_TYPE_AOD
   mediaInfo.mediaType = ADBMobile().MEDIA_TYPE_AUDIO
   

2. 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 JavaScript

     NOTA

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

     • Referencia de API de claves de metadatos de contenidos: Claves de metadatos estándar de JavaScript

       Consulte el conjunto completo de metadatos disponibles aquí: Parámetros de audio y vídeo.

   • Metadatos personalizados

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

     /* Set custom context data */
     var customVideoMetadata = {
         isUserLoggedIn: "false",
         tvStation: "Sample TV station",
         programmer: "Sample programmer"
     };
     

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

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

   mediaHeartbeat.trackSessionStart(mediaObject, customVideoMetadata);
   

   CONSEJO

   El segundo valor es el nombre de objeto de metadatos de contenido personalizado que ha creado en el paso 2.

   IMPORTANTE

   trackSessionStart rastrea la intención de reproducción, no el comienzo de la reproducción. Esta API se utiliza para cargar los datos y los metadatos, y para calcular la métrica de QoS (tiempo entre trackSessionStart y trackPlay).

   NOTA

   Si no utiliza metadatos personalizados, envíe un objeto vacío para el argumento data en trackSessionStart, tal y como se muestra en la línea comentada del ejemplo para iOS anterior.

4. Realizar un seguimiento del inicio real de la reproducción

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

   mediaHeartbeat.trackPlay();
   

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

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

   mediaHeartbeat.trackComplete();
   

6. Realizar un seguimiento del final de la sesión

   Identifique el evento del reproductor de contenido para la carga o el cierre de la reproducción, cuando el usuario cierra o se completa la descarga, e invoque trackSessionEnd:

   mediaHeartbeat.trackSessionEnd();
   

   IMPORTANTE

   trackSessionEnd marca el final de una sesión de seguimiento. Si la sesión se ha visto por completo correctamente, es decir, el usuario ha visto el contenido hasta el final, asegúrese de invocar trackComplete antes que trackSessionEnd. Las demás llamadas de la API track* se pasan por alto después de trackSessionEnd (salvo trackSessionStart en una nueva sesión de seguimiento). Método de seguimiento de reproducción de contenidos para hacer un seguimiento de la carga de contenidos y establecer la sesión actual como activa:

   ‘ Create a media info object
   mediaInfo = adb_media_init_mediainfo()
   mediaInfo.id = <MEDIA_ID>
   mediaInfo.playhead = "0"
   mediaInfo.length = "600"
   

7. Adjuntar metadatos de vídeo

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

   • Metadatos de vídeo estándar

     Implementación de metadatos estándar en Roku

     NOTA

     No es obligatorio adjuntar el objeto de metadatos de vídeo estándar al objeto de contenidos.

   • Metadatos personalizados

     Cree un objeto de variable para las variables personalizadas y rellénelo con los datos de este vídeo. Por ejemplo:

     mediaContextData = {}
     mediaContextData["cmk1"] = "cmv1"
     mediaContextData["cmk2"] = "cmv2"
     

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

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

   ADBMobile().mediaTrackSessionStart(mediaInfo,mediaContextData)
   

   CONSEJO

   El segundo valor es el nombre de objeto de metadatos de video personalizado que ha creado en el paso 2.

   IMPORTANTE

   trackSessionStart rastrea la intención de reproducción, no el comienzo de la reproducción. Esta API se utiliza para cargar los datos y los metadatos del vídeo y para calcular la métrica de QoS (tiempo entre trackSessionStart y trackPlay).

   NOTA

   Si no utiliza metadatos de vídeo personalizados, envíe un objeto vacío para el argumento data en trackSessionStart, tal y como se muestra en la línea comentada del ejemplo para iOS anterior.

9. Realizar un seguimiento del inicio real de la reproducción

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

   ADBMobile().mediaTrackPlay()
   

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

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

    ADBMobile().mediaTrackComplete()
    

11. Realizar un seguimiento del final de la sesión

    Identifique el evento del reproductor de vídeo para la descarga o cierre de la reproducción, cuando el usuario cierra o completa la descarga e invoque trackSessionEnd:

    ADBMobile().mediaTrackSessionEnd()
    

    IMPORTANTE

    trackSessionEnd marca el final de una sesión de seguimiento de vídeo. Si la sesión se ha visto por completo correctamente, es decir, el usuario ha visto el contenido hasta el final, asegúrese de invocar trackComplete antes que trackSessionEnd. Las demás llamadas de la API track* se pasan por alto después de trackSessionEnd (salvo trackSessionStart en una nueva sesión de seguimiento de vídeo).

12. Rastrear todos los escenarios de pausa posibles

    Identifique el evento del reproductor en el que se pause el vídeo e invoque trackPause:

    ADBMobile().mediaTrackPause()
    

    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 vídeo desde donde se produjo la interrupción.

13. Identifique el evento del reproductor en el que el vídeo se reproduzca o se reanude e invoque trackPlay:

    ADBMobile().mediaTrackPlay()
    

    CONSEJO

    Puede ser el mismo origen de evento empleado en el paso 4. Asegúrese de que cada llamada de API a trackPause() esté vinculada a continuación con una llamada de API a trackPlay() cuando se reanude la reproducción de vídeo.

• Situaciones de seguimiento: Reproducción de VOD sin anuncios
• Reproductor de muestra incluido con el SDK para Roku para ver un ejemplo de seguimiento completo.