Información general de la configuración del SDK de medios de streaming heredado 2.x setup-overview
Las instrucciones de esta sección se aplican a la variable Media SDK 2.x. heredado.
-
Para obtener información sobre la implementación de una versión 1.x del Media SDK, consulte la Documentación del Media SDK 1.x.
-
Para los integradores de Primetime, consulta la Documentación del SDK de Primetime Media.
Compatibilidad con versiones con la plataforma mínima requerida minimum-platform-version
En la tabla siguiente se describen las versiones de plataforma mínimas admitidas para cada SDK a partir del 19 de febrero de 2019.
Directrices generales de implementación general-implementation-guidelines
Hay tres componentes principales del SDK involucrados en el seguimiento de medios:
- Configuración de Media Heartbeat: La configuración contiene la configuración básica para la creación de informes.
- Delegado de Media Heartbeat: El delegado controla el tiempo de reproducción y el objeto QoS.
- Media Heartbeat: La biblioteca principal que contiene miembros y métodos.
Complete los pasos siguientes de la implementación:
-
Cree una instancia de
MediaHeartbeatConfig
y establezca los valores de configuración de parámetros.table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 3-align-center 8-align-center 13-align-center 18-align-center 23-align-center 28-align-center 33-align-center 38-align-center Nombre de variable Descripción Requerido Valor predeterminado trackingServer
Servidor de seguimiento para análisis de medios. Esto es diferente al servidor de seguimiento de Analytics. Sí Cadena vacía channel
Nombre del canal No Cadena vacía ovp
Nombre de la plataforma de medios en línea desde la que se distribuye el contenido. No Cadena vacía appVersion
La versión del SDK/aplicación del reproductor de medios No Cadena vacía playerName
Nombre del reproductor de medios en uso como "AVPlayer", "HTML5 Player", "Mi reproductor personalizado" No Cadena vacía ssl
Indica si las llamadas deben realizarse a través de HTTPS No false debugLogging
Indica si el registro de depuración está habilitado No false -
Implementación de
MediaHeartbeatDelegate
.table 0-row-3 1-row-3 2-row-3 3-align-center 7-align-center 11-align-center Nombre del método Descripción Requerido getQoSObject()
Devuelve la instancia de MediaObject
que contiene la información actual de QoS. Se llamará varias veces a este método durante una sesión de reproducción. La implementación del reproductor debe devolver siempre los datos de QoS más recientes que haya disponibles.Sí getCurrentPlaybackTime()
Devuelve la posición actual del cabezal de reproducción.
Para el seguimiento de vídeos VOD, el valor se especifica segundos después del comienzo del elemento de medios.
Para el streaming en directo, si el reproductor no proporciona información acerca de la duración del contenido, el valor se puede especificar como el número de segundos desde la medianoche (UTC) de ese día.
Nota: Cuando se utilizan marcadores de progreso, la duración del contenido es obligatoria y el cabezal de reproducción debe actualizarse como número de segundos desde el principio del elemento de medios, empezando por 0.Sí note tip TIP El objeto de calidad de servicio (QoS) es opcional. Si los datos de QoS están disponibles para el reproductor y desea rastrearlos, se requieren las siguientes variables: table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 3-align-center 7-align-center 11-align-center 15-align-center 19-align-center Nombre de variable Descripción Requerido bitrate
Velocidad de bits del medio en bits por segundo. Sí startupTime
Tiempo de activación del inicio del medio en milisegundos. Sí fps
Los fotogramas mostrados por segundo. Sí droppedFrames
Número de fotogramas perdidos hasta ahora. Sí -
Cree la instancia de
MediaHeartbeat
.Utilice
MediaHertbeatConfig
yMediaHertbeatDelegate
para crear la instanciaMediaHeartbeat
.note important IMPORTANT Asegúrese de que la instancia de MediaHeartbeat
es accesible y no se desasigna hasta el final de la sesión. Esta instancia se utilizará para todos los eventos de seguimiento de medios posteriores.note tip TIP MediaHeartbeat
requiere una instancia deAppMeasurement
para enviar llamadas a Adobe Analytics. -
Combine todas las piezas.
El siguiente código de ejemplo utiliza nuestro SDK JavaScript 2.x para un reproductor de vídeo HTML5:
code language-javascript // Create local references to the heartbeat classes var MediaHeartbeat = ADB.va.MediaHeartbeat; var MediaHeartbeatConfig = ADB.va.MediaHeartbeatConfig; var MediaHeartbeatDelegate = ADB.va.MediaHeartbeatDelegate; //Media Heartbeat Config var mediaConfig = new MediaHeartbeatConfig(); mediaConfig.trackingServer = "[your_namespace].hb.omtrdc.net"; mediaConfig.playerName = "HTML5 Basic"; mediaConfig.channel = "Video Channel"; mediaConfig.debugLogging = true; mediaConfig.appVersion = "2.0"; mediaConfig.ssl = false; mediaConfig.ovp = ""; // Media Heartbeat Delegate var mediaDelegate = new MediaHeartbeatDelegate(); // Set mediaDelegate CurrentPlaybackTime mediaDelegate.getCurrentPlaybackTime = function() { return video.currentTime; }; // Set mediaDelegate QoSObject - OPTIONAL mediaDelegate.getQoSObject = function() { return MediaHeartbeat.createQoSObject(video.bitrate, video.startuptime, video.fps, video.droppedframes); } // Create mediaHeartbeat instance this.mediaHeartbeat = new MediaHeartbeat(mediaDelegate, mediaConfig, appMeasurementInstance);
Validación validate
Las implementaciones de seguimiento de Media Analytics generan dos tipos de llamadas de seguimiento:
-
Las llamadas de inicio de contenido y anuncio se envían directamente al servidor de Adobe Analytics (AppMeasurement).
-
Las llamadas de Heartbeat se envían al servidor de seguimiento de Media Analytics (latidos), se procesan y se pasan al servidor de Adobe Analytics.
-
Servidor de Adobe Analytics (AppMeasurement) Para obtener más información sobre las opciones del servidor de seguimiento, consulte Rellenar correctamente las variables trackingServer y trackingServerSecure.
note important IMPORTANT Es necesario un servidor de seguimiento RDC o CNAME que se resuelva en un servidor RDC para el servicio ID de visitante de Experience Cloud. El servidor de seguimiento de análisis debe finalizar en “
.sc.omtrdc.net
” o ser CNAME. -
Servidor de Media Analytics (latidos)
Siempre tiene el formato “[your_namespace].hb.omtrdc.net
”. El valor de “[your_namespace]
” especifica su empresa y lo proporciona Adobe.
El seguimiento de medios funciona del mismo modo en todas las plataformas, equipos de escritorio y dispositivos móviles. Actualmente, el seguimiento de audio funciona en plataformas móviles. En todas las llamadas de seguimiento hay algunas variables universales clave que se deben validar:
Documentación de SDK 1.x sdk-1x-documentation
- Android: Configurar Media Analytics
- DHLS: Configurar Media Analytics
- iOS: Configurar Media Analytics