@vindral/web-sdk 4.1.9 → 4.1.10

package/legacy.d.ts

@@ -23,17 +23,6 @@ export interface Channel {
 	 */
 	timeshiftUrls?: string[];
 }
-interface ClientOverrides {
-	maxVideoBitRate?: number;
-	minBufferTime?: number;
-	maxBufferTime?: number;
-	burstEnabled?: boolean;
-	sizeBasedResolutionCapEnabled?: boolean;
-	separateVideoSocketEnabled?: boolean;
-	videoCodecs?: string[];
-}
-export type AudioCodec = "aac" | "opus" | "mp3";
-export type VideoCodec = "h264" | "av1";
 interface MinMaxAverage {
 	last: number;
 	/**
@@ -106,44 +95,51 @@ type Tagged<BaseType, Tag extends PropertyKey> = BaseType & {
 		[K in Tag]: void;
 	};
 };
-type Namespace = Tagged<Array<string>, "Namespace">;
-interface TrackObject {
-	namespace?: Namespace;
-	name: string;
-	format: string;
-	label?: string;
-	renderGroup?: number;
-	altGroup?: number;
-	initData?: string;
-	initTrack?: string;
-	depends?: Array<string>;
-	temporalId?: number;
-	spatialId?: number;
-	codec?: string;
-	mimeType?: string;
-	framerate?: [
-		number,
-		number
-	];
-	bitrate?: number;
-	width?: number;
-	height?: number;
-	samplerate?: number;
-	channelConfig?: string;
-	displayWidth?: number;
-	displayHeight?: number;
-	language?: string;
-	["com.vindral.variant_uid"]?: string;
-	["com.vindral.drm"]?: string;
-}
-interface CatalogRoot {
-	version: number;
-	streamingFormat?: number;
-	streamingFormatVersion?: string;
+declare class UserAgentInformation {
+	private highEntropyValues?;
+	constructor();
+	getUserAgentInformation(): {
+		locationOrigin: string;
+		locationPath: string;
+		ancestorOrigins: string[] | undefined;
+		hardwareConcurrency: number;
+		deviceMemory: number | undefined;
+		userAgentLegacy: string;
+		ua: {
+			browser: {
+				brands: string[];
+				fullVersionBrands: string[];
+				majorVersions: string[];
+			};
+			device: string;
+			os: {
+				family: string;
+				version: string;
+				major_version: number;
+			};
+		};
+	} | {
+		locationOrigin: string;
+		locationPath: string;
+		ancestorOrigins: string[] | undefined;
+		hardwareConcurrency: number;
+		deviceMemory: number | undefined;
+		userAgent: string;
+	};
 }
-interface TracksCatalog extends CatalogRoot {
-	namespace: Namespace;
-	tracks: Array<TrackObject>;
+export type AudioCodec = "aac" | "opus" | "mp3";
+export type VideoCodec = "h264" | "av1";
+/**
+ * The current reconnect state to use to decide whether to kep reconnecting or not
+ */
+export interface ReconnectState {
+	/**
+	 * The number or retry attempts so far.
+	 * This gets reset on every successful connect, so it will start from zero every
+	 * time the client instance gets disconnected and will increment until the
+	 * client instance makes a connection attempt is successful.
+	 */
+	reconnectRetries: number;
 }
 interface RenditionProps {
 	id: number;
@@ -192,85 +188,6 @@ export type VideoRendition = VideoRenditionProps & RenditionProps;
 export type AudioRendition = AudioRenditionProps & RenditionProps;
 type TextRendition = TextRenditionProps & RenditionProps;
 type Rendition = VideoRendition | AudioRendition | TextRendition;
-interface Telemetry {
-	url: string;
-	probability?: number;
-	includeErrors?: boolean;
-	includeEvents?: boolean;
-	includeStats?: boolean;
-	maxRetries?: number;
-	maxErrorReports?: number;
-	interval?: number;
-}
-interface ChannelWithCatalog extends Channel {
-	catalog: TracksCatalog;
-	renditions: Rendition[];
-	overrides?: ClientOverrides;
-}
-interface ChannelWithRenditions extends Channel {
-	renditions: Rendition[];
-	overrides?: ClientOverrides;
-}
-interface ServerCertificateHash {
-	algorithm: string;
-	value: string;
-}
-interface Edge {
-	moqUrl?: string;
-	moqWsUrl: string;
-	serverCertificateHashes?: ServerCertificateHash[];
-}
-interface MoQConnectInfo {
-	logsUrl?: string;
-	statsUrl?: string;
-	telemetry?: Telemetry;
-	channels: ChannelWithCatalog[];
-	edges: Edge[];
-	timeshift: {
-		urls: string[];
-		duration: string;
-	};
-}
-interface VindralConnectInfo {
-	logsUrl?: string;
-	statsUrl?: string;
-	telemetry?: Telemetry;
-	channels: ChannelWithRenditions[];
-	edges: string[];
-}
-export type ConnectInfo = VindralConnectInfo | MoQConnectInfo;
-/**
- * Represents a timed metadata event
- */
-export interface Metadata {
-	/**
-	 * The raw string content as it was ingested (if using JSON, it needs to be parsed on your end)
-	 */
-	content: string;
-	/**
-	 * Timestamp in ms
-	 */
-	timestamp: number;
-}
-/** */
-export interface TimeRange {
-	/** */
-	start: number;
-	/** */
-	end: number;
-}
-/**
- * The current reconnect state to use to decide whether to kep reconnecting or not
- */
-export interface ReconnectState {
-	/**
-	 * The number or retry attempts so far.
-	 * This gets reset on every successful connect, so it will start from zero every
-	 * time the client instance gets disconnected and will increment until the
-	 * client instance makes a connection attempt is successful.
-	 */
-	reconnectRetries: number;
-}
 /**
  * Represents a size with a width and height.
  */
@@ -334,6 +251,7 @@ export interface DrmOptions {
  * Type of media.
  */
 export type Media = "audio" | "video" | "audio+video";
+type WebCodecsHardwareAccelerationPreference = "no-preference" | "prefer-hardware" | "prefer-software";
 /**
  * Options for the Vindral instance
  *
@@ -538,6 +456,38 @@ export interface Options {
 	 * Enables iOS devices to use a media element for playback. This enables fullscreen and picture in picture support on iOS.
 	 */
 	iosMediaElementEnabled?: boolean;
+	/**
+	 * Enable WebCodecs API for hardware-accelerated decoding.
+	 *
+	 * When enabled, the browser's native VideoDecoder and AudioDecoder APIs will be used instead
+	 * of WASM decoding on supported browsers (Chrome 94+, Edge 94+, Safari 16.4+). This provides:
+	 * - Hardware-accelerated decoding (uses GPU for video)
+	 * - Better performance at higher resolutions
+	 * - Lower CPU usage and battery consumption
+	 *
+	 * Disabled by default to allow gradual rollout and testing.
+	 *
+	 * Note: Automatically falls back to WASM decoding if:
+	 * - The browser doesn't support WebCodecs
+	 * - WebCodecs initialization fails
+	 * - This option is set to false or undefined
+	 */
+	webcodecsEnabled?: boolean;
+	/**
+	 * Hardware acceleration preference for WebCodecs video decoding.
+	 *
+	 * Defaults to `"no-preference"`.
+	 */
+	webcodecsHardwareAcceleration?: WebCodecsHardwareAccelerationPreference;
+	/**
+	 * Enable OffscreenCanvas rendering in worker thread (requires webcodecsEnabled: true).
+	 *
+	 * When enabled, video rendering happens in the worker thread using OffscreenCanvas.
+	 * Disabled by default to allow gradual rollout and testing.
+	 *
+	 * Note: Requires browser support for OffscreenCanvas and webcodecsEnabled must be true, and iosMediaElementEnabled must be false.
+	 */
+	offscreenCanvasEnabled?: boolean;
 	/**
 	 * Advanced options to override default behaviour.
 	 */
@@ -549,6 +499,124 @@ export interface Options {
 	 */
 	drm?: DrmOptions;
 }
+interface ClientOverrides {
+	maxVideoBitRate?: number;
+	minBufferTime?: number;
+	maxBufferTime?: number;
+	burstEnabled?: boolean;
+	sizeBasedResolutionCapEnabled?: boolean;
+	separateVideoSocketEnabled?: boolean;
+	webcodecsEnabled?: boolean;
+	webcodecsHardwareAcceleration?: WebCodecsHardwareAccelerationPreference;
+	offscreenCanvasEnabled?: boolean;
+	videoCodecs?: string[];
+}
+type Namespace = Tagged<Array<string>, "Namespace">;
+interface TrackObject {
+	namespace?: Namespace;
+	name: string;
+	format: string;
+	label?: string;
+	renderGroup?: number;
+	altGroup?: number;
+	initData?: string;
+	initTrack?: string;
+	depends?: Array<string>;
+	temporalId?: number;
+	spatialId?: number;
+	codec?: string;
+	mimeType?: string;
+	framerate?: [
+		number,
+		number
+	];
+	bitrate?: number;
+	width?: number;
+	height?: number;
+	samplerate?: number;
+	channelConfig?: string;
+	displayWidth?: number;
+	displayHeight?: number;
+	language?: string;
+	["com.vindral.variant_uid"]?: string;
+	["com.vindral.drm"]?: string;
+}
+interface CatalogRoot {
+	version: number;
+	streamingFormat?: number;
+	streamingFormatVersion?: string;
+}
+interface TracksCatalog extends CatalogRoot {
+	namespace: Namespace;
+	tracks: Array<TrackObject>;
+}
+interface Telemetry {
+	url: string;
+	probability?: number;
+	includeErrors?: boolean;
+	includeEvents?: boolean;
+	includeStats?: boolean;
+	maxRetries?: number;
+	maxErrorReports?: number;
+	interval?: number;
+}
+interface ChannelWithCatalog extends Channel {
+	catalog: TracksCatalog;
+	renditions: Rendition[];
+	overrides?: ClientOverrides;
+}
+interface ChannelWithRenditions extends Channel {
+	renditions: Rendition[];
+	overrides?: ClientOverrides;
+}
+interface ServerCertificateHash {
+	algorithm: string;
+	value: string;
+}
+interface Edge {
+	moqUrl?: string;
+	moqWsUrl: string;
+	serverCertificateHashes?: ServerCertificateHash[];
+}
+interface MoQConnectInfo {
+	logsUrl?: string;
+	statsUrl?: string;
+	telemetry?: Telemetry;
+	channels: ChannelWithCatalog[];
+	edges: Edge[];
+	timeshift: {
+		urls: string[];
+		duration: string;
+	};
+}
+interface VindralConnectInfo {
+	logsUrl?: string;
+	statsUrl?: string;
+	telemetry?: Telemetry;
+	channels: ChannelWithRenditions[];
+	edges: string[];
+}
+export type ConnectInfo = VindralConnectInfo | MoQConnectInfo;
+/**
+ * Represents a timed metadata event
+ */
+export interface Metadata {
+	/**
+	 * The raw string content as it was ingested (if using JSON, it needs to be parsed on your end)
+	 */
+	content: string;
+	/**
+	 * Timestamp in ms
+	 */
+	timestamp: number;
+}
+/** */
+export interface TimeRange {
+	/** */
+	start: number;
+	/** */
+	end: number;
+}
 /**
  * Represents a rendition (quality level).
  */
@@ -928,38 +996,6 @@ interface VideoPlayerStatistics {
 	contextLostCount: number;
 	contextRestoredCount: number;
 }
-declare class UserAgentInformation {
-	private highEntropyValues?;
-	constructor();
-	getUserAgentInformation(): {
-		locationOrigin: string;
-		locationPath: string;
-		ancestorOrigins: string[] | undefined;
-		hardwareConcurrency: number;
-		deviceMemory: number | undefined;
-		userAgentLegacy: string;
-		ua: {
-			browser: {
-				brands: string[];
-				fullVersionBrands: string[];
-				majorVersions: string[];
-			};
-			device: string;
-			os: {
-				family: string;
-				version: string;
-				major_version: number;
-			};
-		};
-	} | {
-		locationOrigin: string;
-		locationPath: string;
-		ancestorOrigins: string[] | undefined;
-		hardwareConcurrency: number;
-		deviceMemory: number | undefined;
-		userAgent: string;
-	};
-}
 type ModuleStatistics = AdaptivityStatistics & BufferTimeStatistics & ConnectionStatistics & ConstraintCapStatistics & DecoderStatistics & DocumentStateModulesStatistics & IncomingDataModuleStatistics & JitterModuleStatistics & MseModuleStatistics & PlaybackModuleStatistics & QualityOfServiceModuleStatistics & RenditionsModuleStatistics & SyncModuleStatistics & TelemetryModuleStatistics & VideoPlayerStatistics;
 /**
  * Contains internal statistics.