Streaming Video & Ads for Browser release notesRSS

Highlights

• Explicit opt-in for AWS MediaTailor, with full support for custom CDN domains.
• New config.ad.type API to choose between CSAI and SSAI (DAI, MT) ad tracking — no more URL-based guessing for SSAI.
• End-to-end logging through nrvideo.Log, with active detection mode logged at startup.

Features

MediaTailor custom CDN support

Replaced URL-based auto-detection with explicit opt-in.

• Enabled the tracker via mediatailor: true (or mediatailor: { trackingUrl, adSegmentPrefix }), supporting both default AWS hostnames and custom CDN domains.
• Added MT_DEFAULT_AD_SEGMENT_PATH (/tm/) constant for AWS-recommended CDN ad-segment path; ad segments rewritten to a custom CDN domain under /tm/ are detected automatically.
• Updated isMediaTailorSegment() to check the default AWS segments hostname, the /tm/ path, and an optional customer-supplied adSegmentPrefix.
• Threaded adSegmentPrefix through HLS (VHS) and DASH manifest parsing.
• Added explicit session initialization via mediatailor: { trackingUrl } for POST /v1/session/ flows.

Ad tracking configuration

Introduced config.ad.type to control ad tracker selection.

• Exposed AD_TRACKING constant with CSAI (flat value covering IMA / Brightcove IMA / Freewheel / generic) and SSAI sub-types (DAI, MT).
• Required an explicit sub-type for SSAI — each platform needs its own SDK and cannot be auto-detected.
• Mapped SSAI.MT to imply mediatailor: true.
• Added a fallback to CSAI auto-detection with a warning when config.ad.type is unset (backward compatible for v4.1.2 users).
• Co-located segmentPrefix and trackingUrl under config.ad.
• Added DaiAdsTracker to static exports.

Logging improvements

• Exposed VideojsTracker.Log as a static so UMD callers can set log level.
• Added logging of the active ad segment detection mode at tracker startup.
• Added logging of the matched ad segment detection path on the first ad break (once per session).
• Added logging of which CSAI framework was auto-detected (BrightcoveIma / IMA / Freewheel / generic).
• Replaced console.log/warn/error with nrvideo.Log across MediaTailor files.

Bug fixes

• Fixed buffer end handling in tracker.
• Fixed register-plugin.js silently dropping the options object and not forwarding it to the TrackerJS constructor.

Documentation

• Updated the README and SSAI docs for custom CDN support, clarified when trackingUrl and adSegmentPrefix overrides are needed, and cleaned up sessionId references.
• Corrected adSegmentPrefix references to config.ad.segmentPrefix in the SSAI troubleshooting docs.

Upgrade from 4.1.x

• No breaking changes for CSAI users. If config.ad.type is unset, the tracker still auto-detects CSAI frameworks (with a one-time warning).
• MediaTailor users must opt in explicitly. Replace any URL-pattern reliance with one of:
  • mediatailor: true (default AWS hostnames + /tm/ path)
  • mediatailor: { trackingUrl, adSegmentPrefix } (custom CDN / explicit session init)
  • config.ad.type: AD_TRACKING.SSAI.MT
• If you previously passed adSegmentPrefix at the top level, move it to config.ad.segmentPrefix.

Aspectos destacados

• Inclusión explícita para AWS MediaTailor, con compatibilidad total para dominios de CDN personalizados.
• Nueva API config.ad.type para elegir entre el seguimiento de anuncios CSAI y SSAI (DAI, MT) — no más suposiciones basadas en URL para SSAI.
• Logging de extremo a extremo a través de nrvideo.Log, con el modo de detección activa registrado en el inicio.

Característica

Soporte de CDN personalizada de MediaTailor

Se reemplazó la detección automática basada en URL con la inclusión explícita.

• Se habilitó el rastreador a través de mediatailor: true (o mediatailor: { trackingUrl, adSegmentPrefix }), que admite tanto nombres de host de AWS predeterminados como dominios de CDN personalizados.
• Se agregó la constante MT_DEFAULT_AD_SEGMENT_PATH (/tm/) para la ruta de segmento de anuncios de CDN recomendada por AWS; los segmentos de anuncios reescritos a un dominio de CDN personalizado bajo /tm/ se detectan automáticamente.
• Se actualizó isMediaTailorSegment() para verificar el nombre de host de segmentos de AWS predeterminado, la ruta /tm/ y un adSegmentPrefix opcional proporcionado por el cliente.
• Se enlazó adSegmentPrefix a través del análisis de manifiestos HLS (VHS) y DASH.
• Se agregó la inicialización de sesión explícita a través de mediatailor: { trackingUrl } para los flujos de POST /v1/session/.

Configuración de seguimiento de anuncios

Se introdujo config.ad.type para controlar la selección del rastreador de anuncios.

• Se expuso la constante AD_TRACKING con CSAI (valor plano que cubre IMA / Brightcove IMA / Freewheel / genérico) y los subtipos de SSAI (DAI, MT).
• Se requirió un subtipo explícito para SSAI — cada plataforma necesita su propio SDK y no se puede detectar automáticamente.
• Se asignó SSAI.MT para implicar mediatailor: true.
• Se agregó una alternativa a la detección automática de CSAI con una advertencia cuando config.ad.type no está configurado (compatible con versiones anteriores para v4.1.2 usuarios).
• Se ubicaron conjuntamente segmentPrefix y trackingUrl bajo config.ad.
• Se agregó DaiAdsTracker a las exportaciones estáticas.

Mejoras de logging

• Se expuso VideojsTracker.Log como estático para que los llamadores UMD puedan establecer el nivel de logs.
• Se agregó el logging del modo de detección de segmentos de anuncios activo al inicio del rastreador.
• Se agregó el logging de la ruta de detección de segmentos de anuncios coincidente en la primera pausa publicitaria (una vez por sesión).
• Se agregó el logging de qué framework de CSAI se detectó automáticamente (BrightcoveIma / IMA / Freewheel / genérico).
• Se reemplazó console.log/warn/error por nrvideo.Log en todos los archivos de MediaTailor.

Corrección de errores

• Se corrigió el manejo del final del búfer en el rastreador.
• Se corrigió que register-plugin.js descartara silenciosamente el objeto de opciones y no lo reenviara al constructor de TrackerJS.

Documentación

• Se actualizaron el README y los documentos de SSAI para la compatibilidad con CDN personalizada, se aclaró cuándo se necesitan las anulaciones de trackingUrl y adSegmentPrefix, y se limpiaron las referencias a sessionId.
• Se corrigieron las referencias de adSegmentPrefix a config.ad.segmentPrefix en los documentos de resolución de problemas de SSAI.

Actualizar desde la 4.1.x

• No hay cambios importantes para los usuarios de CSAI. Si config.ad.type no está configurado, el rastreador aún detecta automáticamente los frameworks de CSAI (con una advertencia única).

• Los usuarios de MediaTailor deben habilitarlo explícitamente. Reemplace cualquier dependencia de patrón de URL con uno de:

  • mediatailor: true (nombres de host predeterminados de AWS + ruta /tm/)
  • mediatailor: { trackingUrl, adSegmentPrefix } (CDN personalizado / inicialización de sesión explícita)
  • config.ad.type: AD_TRACKING.SSAI.MT

• Si anteriormente pasó adSegmentPrefix en el nivel superior, muévalo a config.ad.segmentPrefix.

Highlights

• Added MediaTailor SSAI tracker initialization on loadstart after source load detection.
• Added DAI stream manager support through the stream-manager event.
• Improved bitrate reporting with:
  • Playback bitrate (AVERAGE-BANDWIDTH/BANDWIDTH)
  • Manifest max bitrate
  • Segment download bitrate
  • Network throughput bitrate

Improvements

• Refined ad and content event handling to avoid duplicate or incorrect content events while ads are active for following events:
  • Pause/Resume
  • Seek Start/End
  • Buffer Start
• Improved end-of-content handling for ad-enabled playback paths during IMA and Freewheel scenarios.
• Added safer fallback logic for tech wrappers (Hls.js, Shaka, contrib-hls) when bitrate data is unavailable in VHS.

Technical notes

• Tracker metadata and playback context methods remain aligned with Video.js/Brightcove integrations:
  • Retrieves the title, ID, and duration from mediainfo when available.
  • Retrieves source and rendition data from the active tech component when available.
• Updated the Listener registration and unregistration to include ad and stream manager lifecycle events.

Aspectos destacados

• Se agregó la inicialización del rastreador de SSAI de MediaTailor en loadstart después de la detección de carga del origen.

• Se agregó soporte para el administrador de transmisiones DAI a través del evento stream-manager.

• Reportes de tasa de bits mejorados con:

  • Tasa de bits de reproducción (AVERAGE-BANDWIDTH/BANDWIDTH)
  • Tasa de bits máx. del manifiesto
  • Tasa de bits de descarga del segmento
  • Tasa de bits de rendimiento de red

Mejoras

• Se refinó el manejo de eventos de anuncios y contenido para evitar eventos de contenido duplicados o incorrectos mientras los anuncios están activos para los siguientes eventos:

  • Pausar/reanudar
  • Inicio/fin de búsqueda
  • Inicio de búfer

• Manejo mejorado del fin del contenido para rutas de reproducción con anuncios habilitados durante escenarios de IMA y Freewheel.

• Se agregó una lógica de respaldo más segura para los wrappers tecnológicos (Hls.js, Shaka, contrib-hls) cuando los datos de la tasa de bits no están disponibles en VHS.

Notas técnicas

• Los metadatos del rastreador y los métodos de contexto de reproducción se mantienen alineados con Video.js/Brightcove integraciones:

  • Recupera el título, el ID y la duración de mediainfo cuando estén disponibles.
  • Recupera datos de origen y de representación del componente técnico activo cuando están disponibles.

• Se actualizó el registro y la anulación de registro del Listener para incluir los eventos del ciclo de vida del administrador de anuncios y transmisiones.

What's changed

Documentation

• README Overhaul: Restructured and expanded README with comprehensive installation guides, usage examples, best practices, configuration options, API reference, and support channels.

Improvements

• Attributes Validation: Updated validation logic for custom attributes to enforce correctness at the tracker level.
• Custom Attributes Limit: Added an enforced limit on the number of custom attributes that can be sent per event, preventing unexpected payload sizes.

Installation

$
npm install @newrelic/video-html5@4.1.1

Full changelog

This release introduces three new bitrate metrics for granular playback observability, QoE (Quality of Experience) support, and Shaka Player 5.x compatibility while maintaining backward compatibility with Shaka 4.x.

New bitrate metrics

Three new attributes are now available to provide deeper insight into streaming performance:

Additionally, contentBitrate uses track.videoBandwidth (video-only bitrate) to differentiate it from other metrics that report combined video and audio bandwidth.

Quality of Experience (QoE) support

QoE aggregate events are now supported via video-core. Enable them by setting qoeAggregate: true in the config:

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

const tracker = new ShakaTracker(player, options);

The following KPIs are tracked automatically:

Shaka Player 5.x compatibility

The tracker is now compatible with both Shaka Player 4.x and 5.x:

• getPlayerVersion() resolves version across both major versions.
• onError() handles both Shaka player errors (e.detail) and HTML video element errors (e.target.error).
• Sample files updated for Shaka 5.x (removed deprecated shaka.polyfill.installAll(), updated player instantiation).

Upgrade guide

Run the following following to update:

$
npm install @newrelic/video-shaka@4.0.3

To enable QoE, add qoeAggregate: true to your config options as shown above.

Dependencies

Requires @newrelic/video-core v4.1.1 or later for QoE support.

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:

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:

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:

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

Bug fixes

Improved contentBitrate calculation

Issue: The contentBitrate attribute reported the target bitrate from the manifest instead of the actual measured throughput during playback.

Fix: Updated the bitrate calculation method to use getAverageThroughput() from dash.js. This captures the measured average throughput, providing a more accurate, real-time representation of the content consumption rate during playback.

Implementation details

• Primary logic: Uses player.getAverageThroughput('video') to retrieve measured throughput
• Fallback logic:
  • Uses manifest bitrate if throughput measurement is unavailable
  • Improves accuracy of video quality monitoring and analytics
• Impact:
  • More accurate bitrate reporting in New Relic video monitoring
  • Better visibility into actual network conditions and video quality
  • Improved debugging capabilities for playback issues

What's new

This release introduces three new bitrate metrics providing comprehensive quality analysis for MPEG-DASH streaming, along with important improvements to existing bitrate calculations and dash.js v4/v5 compatibility.

New features

New bitrate metrics

• contentManifestBitrate: Maximum combined (video + audio) bitrate from the MPD manifest. Represents the highest possible stream variant available.

• contentMeasuredBitrate: Network estimated by the player's Adaptive BitRate (ABR) algorithm, based on measured download throughput. Use this metric to analyze ABR decision-making.

• contentDownloadBitrate: Effective download throughput calculated from video segment request data (bytesDownloaded × 8 / downloadTime). This Provides real-time network performance monitoring.

Changes

Updated bitrate calculations

• contentBitrate: Returns the video-only bitrate from the active track and excludes audio. Previous versions included combined bitrate.

• contentRenditionBitrate: Returns the combined video and audio bandwidth of the active rendition to provide a complete quality picture.

Compatibility improvements

• getDashBitrate(): Fixed v4 compatibility issue. Version check now occurs before calling v5-only APIs, preventing errors on dash.js v4.x installations.
• getManifestBitrate(): Introduced a smart version detection that uses getRepresentationsByType() on dash.js v5+ and falls back to getBitrateInfoListFor() on v4.x.

Bug fixes

• Removed duplicate getPlayhead() method definition
• Removed console.log statement from getTrack() error handler

Bitrate metrics overview