Streaming Video & Ads for Browser release notesRSS

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.

하이라이트

• 소스 로드 감지 후 loadstart 시 MediaTailor SSAI 트래커 초기화를 추가했습니다.

• stream-manager 이벤트를 통해 DAI 스트림 관리자 지원을 추가했습니다.

• 다음을 통한 개선된 비트레이트 보고:

  • 재생 비트레이트(AVERAGE-BANDWIDTH/BANDWIDTH)
  • 매니페스트 최대 비트레이트
  • 세그먼트 다운로드 비트레이트
  • 네트워크 처리량 비트레이트

개량

• 광고가 활성화되어 있는 동안 중복되거나 잘못된 콘텐츠 이벤트를 방지하기 위해 다음 이벤트에 대한 광고 및 콘텐츠 이벤트 처리를 개선했습니다:

  • 일시 정지/재개
  • 탐색 시작/종료
  • 버퍼 시작

• IMA 및 Freewheel 시나리오에서 광고가 활성화된 재생 경로에 대한 콘텐츠 종료 처리가 개선되었습니다.

• VHS에서 비트레이트 데이터를 사용할 수 없는 경우 기술 래퍼(Hls.js, Shaka, contrib-hls)에 대한 더 안전한 폴백 로직을 추가했습니다.

기술 참고 사항

• 트래커 메타데이터 및 재생 컨텍스트 메서드는 Video.js/Brightcove와 일치하게 유지됩니다 통합:

  • 사용 가능한 경우 mediainfo 에서 제목, ID 및 기간을 가져옵니다.
  • 사용 가능한 경우 활성 기술 컴포넌트에서 소스 및 렌디션 데이터를 가져옵니다.

• 광고 및 스트림 관리자 수명 주기 이벤트를 포함하도록 리스너 등록 및 등록 해제를 업데이트했습니다.

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

변경된 사항

선적 서류 비치

• README 개편: 포괄적인 설치 가이드, 사용 예시, 모범 사례, 설정 옵션, API 참조 및 지원 채널을 포함하여 README를 재구성하고 확장했습니다.

개량

• 속성 유효성 검사: 트래커 수준에서 정확성을 적용하도록 커스텀 속성에 대한 유효성 검사 로직을 업데이트했습니다.
• 커스텀 속성 제한: 이벤트당 전송할 수 있는 커스텀 속성 수에 강제 제한을 추가하여 예기치 않은 페이로드 크기를 방지했습니다.

설치

$
npm install @newrelic/video-html5@4.1.1

전체 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.

이번 릴리스에서는 Shaka 4.x와의 하위 호환성을 유지하면서 세밀한 재생 옵저버빌리티를 위한 세 가지 새로운 비트레이트 메트릭, QoE(Quality of Experience) 지원, Shaka Player 5.x 호환성을 도입합니다.

새로운 비트레이트 메트릭

스트리밍 성능에 대한 더 깊은 인사이트를 제공하는 세 가지 새로운 속성을 이제 사용할 수 있습니다:

또한, contentBitrate 은(는) 결합된 비디오 및 오디오 대역폭을 보고하는 다른 메트릭과 구분하기 위해 track.videoBandwidth (비디오 전용 비트레이트)을(를) 사용합니다.

체감 품질(QoE) 지원

이제 video-core을(를) 통해 QoE 집계 이벤트가 지원됩니다. 구성에서 qoeAggregate: true 을(를) 설정하여 활성화합니다:

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

const tracker = new ShakaTracker(player, options);

다음 KPI는 자동으로 추적됩니다:

Shaka Player 5.x 호환성

이제 트래커는 Shaka Player 4.x 및 5.x 모두와 호환됩니다:

• getPlayerVersion() 두 메이저 버전 모두에서 버전을 해결합니다.
• onError() Shaka 플레이어 오류(e.detail)와 HTML 비디오 요소 오류(e.target.error)를 모두 처리합니다.
• Shaka 5.x용 샘플 파일이 업데이트되었습니다(지원 중단된 shaka.polyfill.installAll() 제거, 플레이어 인스턴스화 업데이트).

업그레이드 가이드

다음을 실행하여 업데이트합니다:

$
npm install @newrelic/video-shaka@4.0.3

QoE를 활성화하려면 위와 같이 구성 옵션에 qoeAggregate: true 을(를) 추가합니다.

종속성

QoE 지원을 위해서는 @newrelic/video-core v4.1.1 이상이 필요합니다.

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

새로워진 사항

이번 릴리스에서는 MPEG-DASH 스트리밍에 대한 포괄적인 품질 분석을 제공하는 세 가지 새로운 비트레이트 메트릭이 도입되었으며, 기존 비트레이트 계산 및 dash.js v4/v5 호환성에 대한 중요한 개선 사항도 포함되었습니다.

새로운 기능

새로운 비트레이트 메트릭

• contentManifestBitrate: MPD 매니페스트의 최대 결합(비디오+오디오) 비트레이트입니다. 사용 가능한 가장 높은 스트림 변형을 나타냅니다.

• contentMeasuredBitrate: 측정된 다운로드 처리량을 기반으로 플레이어의 적응형 비트레이트(ABR) 알고리즘이 추정한 네트워크. ABR 의사 결정을 분석하려면 이 메트릭을 사용하십시오.

• contentDownloadBitrate: 비디오 세그먼트 요청 데이터(bytesDownloaded × 8 / downloadTime)에서 계산된 유효 다운로드 처리량. 이는 실시간 네트워크 성능 모니터링을 제공합니다.

변화

업데이트된 비트레이트 계산

• contentBitrate: 활성 트랙에서 오디오를 제외한 비디오 전용 비트레이트를 반환합니다. 이전 버전에는 통합 비트레이트가 포함되었습니다.

• contentRenditionBitrate: 완전한 품질 상태를 제공하기 위해 활성 렌디션의 결합된 비디오 및 오디오 대역폭 을 반환합니다.

호환성 개선 사항

• getDashBitrate(): v4 호환성 문제를 수정했습니다. 이제 v5 전용 API를 호출하기 전에 버전 확인이 수행되어 dash.js v4.x 설치에서 발생하는 오류를 방지합니다.
• getManifestBitrate(): dash.js v5+에서는 getRepresentationsByType() 을(를) 사용하고 v4.x에서는 getBitrateInfoListFor() (으)로 폴백하는 스마트 버전 감지 기능을 도입했습니다.

버그 수정

• 중복된 getPlayhead() 메서드 정의를 제거했습니다
• getTrack() 오류 핸들러에서 console.log 문을 제거했습니다.

비트레이트 메트릭 개요

Bug fixes

Fixed contentBitrate to accurately report stream bitrate

Issue: The contentBitrate attribute used estimatedBandwidth (the network capacity estimate) as its primary source, which didn't accurately represent the actual bitrate of the playing video stream.

Solution: Updated the bitrate calculation to prioritize streamBandwidth from Shaka Player statistics, which provides the actual content bitrate of the current video variant as defined in the manifest.

Impact: The contentBitrate attribute correctly reports the bitrate (in bits per second) of playing video stream rather than the estimated network bandwidth. This provides more accurate telemetry data for video quality monitoring and analytics.

Technical details

• Changed the priority order in getContentBitratePlayback() method
• Uses the stats.streamBandwidth as the primary source for content bitrate
• Updated the DATAMODEL.md documentation to reflect the accurate definition