Agente de medios para Shaka v4.0.3

Esta versión introduce tres nuevas métricas de bitrate para una observabilidad granular de la reproducción, soporte para QoE (calidad de experiencia) y compatibilidad con Shaka Player 5.x, al tiempo que mantiene la compatibilidad retroactiva con Shaka 4.x.

Nuevas métricas de tasa de bits

Tres nuevos atributos ya están disponibles para proporcionar información valiosa más detallada sobre el rendimiento del streaming:

Atributo	Fuente	Descripción
`contentManifestBitrate`	`stats.streamBandwidth`	Tasa de bits total de la variante (video + audio) según lo declarado en el manifiesto (Tasa de bits indicada).
`contentMeasuredBitrate`	`stats.estimatedBandwidth`	Ancho de banda de red estimado medido por el algoritmo ABR de Shaka (tasa de bits observada).
`contentDownloadBitrate`	`(bytesDownloaded × 8) / playTime`	Rendimiento de descarga efectivo en todos los medios descargados.

Además, contentBitrate utiliza track.videoBandwidth (tasa de bits de solo video) para diferenciarla de otras métricas que reportan el ancho de banda combinado de video y audio.

Soporte de calidad de la experiencia (QoE)

Los eventos agregados de QoE ahora se admiten a través de video-core. Habilítelos estableciendo qoeAggregate: true en la configuración:

const options = {
  info: {
    beacon: 'xxxxxxxxxx',
    applicationID: 'xxxxxxx',
    licenseKey: 'xxxxxxxxxxx',
  },
  config: {
    qoeAggregate: true,
    qoeIntervalFactor: 2,
  },
};

const tracker = new ShakaTracker(player, options);

Los siguientes KPI se rastrean automáticamente:

KPI	Descripción
`startupTime`	Tiempo desde la solicitud de contenido hasta el inicio del contenido (ms).
`peakBitrate`	Máximo `contentBitrate` observado durante la reproducción.
`averageBitrate`	Tasa de bits promedio ponderada en toda la sesión.
`hadStartupFailure`	`true` si ocurrió un error de contenido antes de que el contenido comenzara.
`hadPlaybackFailure`	`true` si ocurrió un error de contenido durante la reproducción.
`totalRebufferingTime`	Tiempo total dedicado a la recarga del búfer (ms).
`rebufferingRatio`	Tiempo de recarga de búfer como porcentaje del tiempo total de reproducción.
`totalPlaytime`	Tiempo total de reproducción de contenido (ms).
`numberOfErrors`	Número total de errores durante la sesión.

Compatibilidad con Shaka Player 5.x

El rastreador ahora es compatible con Shaka Player 4.x y 5.x:

getPlayerVersion() resuelve la versión en ambas versiones principales.
onError() maneja tanto los errores del reproductor Shaka (e.detail) como los errores del elemento de video HTML (e.target.error).
Archivos de ejemplo actualizados para Shaka 5.x (se eliminó shaka.polyfill.installAll() obsoleto, se actualizó la instanciación del reproductor).

Guía de actualización

Ejecute lo siguiente para actualizar:

bash

$npm install @newrelic/video-shaka@4.0.3

Para habilitar QoE, agregue qoeAggregate: true a sus opciones de configuración como se muestra arriba.

Dependencia

Requiere @newrelic/video-core v4.1.1 o posterior para el soporte de QoE.