Documentación Analytics Guía de colección de medios de streaming

Información general

Última actualización: 26 de junio de 2024

Temas:

Creado para:

Usuario
Administrador
Desarrollador

En las siguientes instrucciones se indican los pasos para la implementación en todos los kits de desarrollo de software de 2.x.

IMPORTANT

Si va a implementar una versión 1.x del SDK, puede descargar las guías del desarrollador de 1.x aquí: Descargar SDK.

El seguimiento de la calidad de la experiencia incluye la calidad del servicio (QoS) y el seguimiento de errores. Ambos son elementos opcionales y no son necesarios para las implementaciones principales de contenido. Puede utilizar la API del reproductor de contenido para identificar las variables relacionadas con la calidad de servicio y el seguimiento de errores. Estos son los elementos clave del seguimiento de la calidad de la experiencia:

Eventos del reproductor

En cualquier cambio de métrica de QoS:

Cree o actualice la instancia del objeto QoS para la reproducción. Referencia de API de QoS

En todos los eventos de cambio de velocidad de bits

La llamada trackEvent(Media.Heartbeat.Event.BitrateChange);

Implementación de QOS

Identifique cuándo cambia alguna de las métricas de QoS durante la reproducción de contenido, cree el objeto MediaObject mediante el uso de la información de QoS y actualice la nueva información de QoS.

Variables QoSObject:

TIP
Estas variables solo son necesarias si planea realizar seguimientos de QoS.

Variable
Descripción
Requerido
bitrate
Velocidad de bits actual
Sí
startupTime
Hora de inicio
Sí
fps
Valor FPS
Sí
droppedFrames
Número de fotogramas perdidos
Sí
Asegúrese de que el método getQoSObject() devuelve la información de QoS más actual.
Cuando la velocidad de bits de la reproducción cambie, invoque el evento BitrateChange en la instancia de Media Heartbeat.

IMPORTANT
Actualice el objeto QoS e invoque el evento de cambio de velocidad de bits en cada cambio. Esto proporciona los datos de QoS más precisos.

El siguiente código de ejemplo utiliza el SDK JavaScript 2.x para un reproductor de contenidos HTML5. Este código debe utilizarse con el código de reproducción de contenidos principal.

var mediaDelegate = new MediaHeartbeatDelegate();
...

// This is called periodically by MediaHeartbeat instance
mediaDelegate.prototype.getQoSObject = function() {
    return this.qosInfo;
};

if (e.type == "qos_update") {
    var qosInfo = MediaHeartbeat.createQoSObject(<BITRATE>,<STARTUP_TIME>,<FPS>,<DROPPED_FRAMES>);
    mediaDelegate.qosInfo = qosInfo;
};

if (e.type == "bitrate_change") {
    this.mediaHeartbeat.trackEvent(MediaHeartbeat.Event.BitrateChange, qosObject);
};

recommendation-more-help