@vindral/web-sdk 4.5.1 → 4.6.0-2-g8124b200

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "4.5.1",
+  "version": "4.6.0-2-g8124b200",
   "name": "@vindral/web-sdk",
   "main": "./legacy.umd.js",
   "module": "./legacy.es.js",

package/player.d.ts

@@ -174,6 +174,17 @@ interface DrmOptions {
 type Media = "audio" | "video" | "audio+video";
 type WebCodecsHardwareAccelerationPreference = "no-preference" | "prefer-hardware" | "prefer-software";
 type DecoderType = "mse" | "webcodecs" | "wasm";
+interface MediaSessionMetadata {
+	title?: string;
+	artist?: string;
+	album?: string;
+	/** Fetched by the operating system, so the URLs should not carry credentials. */
+	artwork?: Array<{
+		src: string;
+		sizes?: string;
+		type?: string;
+	}>;
+}
 interface Options {
 	/**
 	 * URL to use when connecting to the stream
@@ -253,13 +264,36 @@ interface Options {
 	 */
 	mseOpusEnabled?: boolean;
 	/**
-	 * Enable or disable support for playing audio in the background for iOS devices.
+	 * Keep playback running while the page is in the background. Enabled by default.
+	 * When disabled, the session disconnects while hidden and reconnects when visible.
 	 *
-	 * Is false (disabled) by default.
+	 * Browser media policies still apply; iOS Safari pauses hidden video regardless.
+	 * Call `play()` again from a user gesture or media-control action to resume.
 	 *
-	 * Note:  This may be enabled by default in a future (major) release
+	 * When enabled, hidden sessions that are muted outside Picture-in-Picture or browser-paused
+	 * are disconnected after the inactivity timeout; an explicit `pause()` disconnects at once.
+	 */
+	backgroundPlayEnabled?: boolean;
+	/**
+	 * @deprecated Use `backgroundPlayEnabled` instead.
+	 *
+	 * Legacy alias kept for backwards compatibility.
 	 */
 	iosBackgroundPlayEnabled?: boolean;
+	/**
+	 * Show the stream in the browser and OS media controls (notification, lock screen, toolbar) and
+	 * let play and pause from there reach the SDK. Enabled by default.
+	 *
+	 * The SDK takes over `navigator.mediaSession` for the document, so a page with its own Media
+	 * Session integration should disable this. On canvas playback paths a silent `<audio>` element is
+	 * added to `document.body` for the controls to attach to.
+	 */
+	mediaSessionEnabled?: boolean;
+	/**
+	 * Title, artist and artwork for the media controls. Without it the browser derives them from the
+	 * page. Read once at construction.
+	 */
+	mediaSessionMetadata?: MediaSessionMetadata;
 	/**
 	 * Enable or disable Adaptive Bit Rate. This allows for automatically adapting the incoming bit rate based on
 	 * the viewers bandwidth and thus avoiding buffering events. This also disables the
@@ -374,6 +408,9 @@ interface Options {
 	 * This enables platform media features such as fullscreen and picture-in-picture
 	 * for non-MSE playback by routing the canvas output through a `<video>` element.
 	 *
+	 * On iOS the audio then plays from its own element, so it continues in the background and under
+	 * lock. After an extended pause from the lock screen, reopening Safari may be required to resume.
+	 *
 	 * Disabled by default.
 	 */
 	streamToMediaElementEnabled?: boolean;
@@ -827,6 +864,13 @@ interface JitterModuleStatistics {
 	audioJitter: JitterStatistics | undefined;
 	videoJitter: JitterStatistics | undefined;
 }
+type DecoyState = "detached" | "attached" | "playing" | "blocked";
+interface MediaSessionModuleStatistics {
+	mediaSessionSupported: boolean;
+	mediaSessionOwner: boolean;
+	mediaSessionPlaybackState: MediaSessionPlaybackState;
+	decoyState?: DecoyState;
+}
 interface MseModuleStatistics {
 	quotaErrorCount: number;
 	mediaSourceOpenTime: number;
@@ -938,8 +982,10 @@ interface SyncModuleStatistics {
 interface VideoPlayerStatistics {
 	renderedFrameCount: number;
 	rendererDroppedFrameCount: number;
+	/** The platform's own view of the audio context, which a mute reading cannot tell apart. */
+	audioContextState?: AudioContextState | "none";
 }
-type ModuleStatistics = AdaptivityStatistics & BufferTimeStatistics & ConnectionStatistics & ConstraintCapStatistics & DecoderStatistics & DocumentStateModulesStatistics & IncomingDataModuleStatistics & JitterModuleStatistics & MseModuleStatistics & PlaybackModuleStatistics & QualityOfServiceModuleStatistics & RenditionsModuleStatistics & SyncModuleStatistics & TelemetryModuleStatistics & VideoPlayerStatistics;
+type ModuleStatistics = AdaptivityStatistics & BufferTimeStatistics & ConnectionStatistics & ConstraintCapStatistics & DecoderStatistics & DocumentStateModulesStatistics & IncomingDataModuleStatistics & JitterModuleStatistics & Partial<MediaSessionModuleStatistics> & MseModuleStatistics & PlaybackModuleStatistics & QualityOfServiceModuleStatistics & RenditionsModuleStatistics & SyncModuleStatistics & TelemetryModuleStatistics & VideoPlayerStatistics;
 type Statistics = ModuleStatistics & ReturnType<UserAgentInformation["getUserAgentInformation"]> & {
 	/**
 	 * Version of the @vindral/web-sdk being used.
@@ -991,6 +1037,8 @@ type Statistics = ModuleStatistics & ReturnType<UserAgentInformation["getUserAge
 	streamToMediaElementEnabled?: boolean;
 	/** @deprecated */
 	iosMediaElementEnabled?: boolean;
+	/** Whether the element carrying the audio is paused right now, on the sinks that have one. */
+	mediaElementPaused?: boolean;
 	/**
 	 * Average bitrate for the entire session in bits/second.
 	 */
@@ -1015,8 +1063,10 @@ type Statistics = ModuleStatistics & ReturnType<UserAgentInformation["getUserAge
 declare class Vindral extends Emitter<PublicVindralEvents> {
 	#private;
 	private static MAX_POOL_SIZE;
-	private static DISCONNECT_TIMEOUT;
 	private static REMOVE_CUE_THRESHOLD;
+	private static BACKGROUND_INACTIVITY_DISCONNECT_TIMEOUT;
+	/** How long a pause on a visible page may still turn out to be the platform backgrounding us. */
+	private static VISIBLE_PAUSE_DISCONNECT_DELAY;
 	/**
 	 * Picture in picture
 	 */
@@ -1059,6 +1109,10 @@ declare class Vindral extends Emitter<PublicVindralEvents> {
 	private offscreenCanvasElement?;
 	private webCodecsRenditionSupport;
 	private hasCalledConnect;
+	private hasRequestedAudioSession;
+	private isUserPaused;
+	/** Only the sinks that carry the audio report this, so a paused element here means silence. */
+	private isMediaElementPaused;
 	private latestEmittedLanguages;
 	private wakeLock;
 	private pool;
@@ -1073,7 +1127,8 @@ declare class Vindral extends Emitter<PublicVindralEvents> {
 	private readonly unextractableSamplesWarned;
 	private sizes;
 	private isSuspended;
-	private disconnectTimeout;
+	private inactivityDisconnectInterval;
+	private visiblePauseTimeout;
 	private offscreenSubtitleInterval?;
 	constructor(options: Options);
 	/**
@@ -1375,6 +1430,8 @@ declare class Vindral extends Emitter<PublicVindralEvents> {
 	private isSupportedVideoCodecProfile;
 	private supportedAudioCodecs;
 	private initializeDecodingModule;
+	private capturesCanvasOnWebKit;
+	private connectWebKitVideoOutput;
 	/**
 	 * Set up a polling interval that forwards subtitle cues to the decoder worker
 	 * when OffscreenCanvas rendering is active. This is needed because the canvas modules'
@@ -1406,6 +1463,12 @@ declare class Vindral extends Emitter<PublicVindralEvents> {
 	 * Pauses the stream. Call .play() to resume playback again.
 	 */
 	pause: () => void;
+	/**
+	 * A browser-initiated decoy pause means an interruption (another app took the focus, headphones
+	 * unplugged), so give the audio up rather than play over it. WebKit holds the decoy on purpose.
+	 */
+	private yieldToInterruption;
+	private fromNativeControls;
 	private registerDebugInstance;
 	/**
 	 *
@@ -1436,8 +1499,24 @@ declare class Vindral extends Emitter<PublicVindralEvents> {
 	 */
 	getStatistics: () => Statistics;
 	private resetModules;
+	private disconnectForInactivePage;
+	private scheduleInactivityDisconnect;
+	/**
+	 * iOS pauses the element a moment before it hides the page, and that pause reaches us while the
+	 * page still reports visible. Acting on it at once tears the session down, so every app switch
+	 * comes back as a full reconnect. Wait for the hide that follows a platform pause instead.
+	 * Nowhere else pauses before hiding, so there a visible pause is the viewer's at once.
+	 */
+	private onVisiblePause;
+	private disconnectForVisiblePause;
+	private clearVisiblePauseDisconnect;
+	private clearInactivityDisconnect;
+	private isHiddenWithBackgroundPlayback;
+	private isVideoOnScreen;
+	private isHiddenWithBackgroundPlayDisabled;
 	private suspend;
 	private unsuspend;
+	private resumeModules;
 	private getRuntimeInfo;
 	private getPlaybackBufferState;
 	private onMediaElementBufferState;
@@ -1451,6 +1530,20 @@ declare class Vindral extends Emitter<PublicVindralEvents> {
 	private get targetSubscription();
 	private timeToFirstFrame;
 	private resolvedDecoder;
+	/**
+	 * On mobile Chromium with WebCodecs audio the play action arrives but no sound comes back until
+	 * the page is visible, so a hidden pause is a stop there. Reads the decoder in use.
+	 */
+	private hiddenPauseIsStop;
+	private usesSplitCanvasAudio;
+	private isWebKitCanvasPath;
+	private holdsDecoyWhilePaused;
+	private streamsToMediaElement;
+	/**
+	 * Safari 16.4+: a playback audio session keeps Web Audio alive in the background. Document-wide
+	 * and not restorable, so it waits for playback to be wanted rather than for construction.
+	 */
+	private requestAudioSessionOnce;
 	private willUseMediaSource;
 	private shouldUseWebCodecs;
 	private isWebCodecsVideoAvailable;
@@ -1461,6 +1554,8 @@ declare class Vindral extends Emitter<PublicVindralEvents> {
 	 * is the optimal rendering path for WebCodecs (worker renders VideoFrames directly).
 	 */
 	private shouldUseOffscreenCanvas;
+	private isBackgroundPlayEnabled;
+	private shouldAllowBackgroundPlayback;
 }
 interface TelemetryModuleStatistics {
 	/**
@@ -1613,7 +1708,8 @@ interface PublicVindralEvents {
 	 * Is emitted during connection whether the channel is live or not.
 	 *
 	 * If the channel is not live, the Vindral instance will try to reconnect until the `reconnectHandler`
-	 * determines that no more retries should be made.
+	 * determines that no more retries should be made. Each attempt also emits a non-fatal `error` with
+	 * the code `channel_not_live`.
 	 *
 	 * Note: If the web-sdk is instantiated at the same time as you are starting the stream it is possible
 	 * that this emits false until the started state has propagated through the system.
@@ -1916,7 +2012,9 @@ export declare class Controller extends HTMLElement {
 		"burst-enabled",
 		"mse-enabled",
 		"mse-opus-enabled",
+		"background-play-enabled",
 		"ios-background-play-enabled",
+		"media-session-enabled",
 		"ios-wake-lock-enabled",
 		"stream-to-media-element-enabled",
 		"ios-media-element-enabled",
@@ -2033,7 +2131,7 @@ export declare class PlayButton extends VindralButton {
  */
 export declare class Player extends HTMLElement {
 	#private;
-	static observedAttributes: readonly ("title" | "offline" | "advanced" | "poster" | "language" | "channels" | "buffering" | "paused" | "volume" | "muted" | "duration" | "user-interacting" | "is-casting" | "cast-available" | "cast-receiver-name" | "ui-locked" | "hide-ui-on-pause" | "is-fullscreen" | "is-fullscreen-fallback" | "rendition-levels" | "rendition-level" | "max-video-bit-rate" | "max-initial-bit-rate" | "abr-enabled" | "size-based-resolution-cap-enabled" | "channel-id" | "channel-group-id" | "pip-available" | "is-pip" | "airplay-available" | "is-airplaying" | "media" | "languages" | "text-tracks" | "text-track" | "needs-user-input-video" | "needs-user-input-audio" | "authentication-token" | "volume-level" | "cast" | "airplay" | "pip" | "fullscreen" | "double-click-fullscreen" | "vu-meter" | "timeshift" | "timeshift-position" | "timeline-markers" | "poster-src" | "debug-panel-open" | "target-buffer-time" | "drift" | "playback-latency" | "connection-state" | "url" | "decoders" | "min-buffer-time" | "max-buffer-time" | "edge-url" | "cast-receiver-id" | "cast-background" | "log-level" | "max-size" | "max-audio-bit-rate" | "burst-enabled" | "mse-enabled" | "mse-opus-enabled" | "ios-background-play-enabled" | "ios-wake-lock-enabled" | "stream-to-media-element-enabled" | "ios-media-element-enabled" | "telemetry-enabled" | "video-codecs" | "drm-headers" | "drm-queryparams" | "drm-widevine-video-robustness" | "drm-widevine-audio-robustness" | "drm-playready-video-robustness" | "drm-playready-audio-robustness" | "webtransport-enabled" | "webcodecs-hardware-acceleration" | "offscreen-canvas-enabled" | "reconnect-retries" | "auto-instance-enabled" | "advanced-rendition-menu-enabled" | "refresh-poster-enabled" | "stream-poll-enabled")[];
+	static observedAttributes: readonly ("title" | "offline" | "advanced" | "poster" | "language" | "channels" | "buffering" | "paused" | "volume" | "muted" | "duration" | "user-interacting" | "is-casting" | "cast-available" | "cast-receiver-name" | "ui-locked" | "hide-ui-on-pause" | "is-fullscreen" | "is-fullscreen-fallback" | "rendition-levels" | "rendition-level" | "max-video-bit-rate" | "max-initial-bit-rate" | "abr-enabled" | "size-based-resolution-cap-enabled" | "channel-id" | "channel-group-id" | "pip-available" | "is-pip" | "airplay-available" | "is-airplaying" | "media" | "languages" | "text-tracks" | "text-track" | "needs-user-input-video" | "needs-user-input-audio" | "authentication-token" | "volume-level" | "cast" | "airplay" | "pip" | "fullscreen" | "double-click-fullscreen" | "vu-meter" | "timeshift" | "timeshift-position" | "timeline-markers" | "poster-src" | "debug-panel-open" | "target-buffer-time" | "drift" | "playback-latency" | "connection-state" | "url" | "decoders" | "min-buffer-time" | "max-buffer-time" | "edge-url" | "cast-receiver-id" | "cast-background" | "log-level" | "max-size" | "max-audio-bit-rate" | "burst-enabled" | "mse-enabled" | "mse-opus-enabled" | "background-play-enabled" | "ios-background-play-enabled" | "media-session-enabled" | "ios-wake-lock-enabled" | "stream-to-media-element-enabled" | "ios-media-element-enabled" | "telemetry-enabled" | "video-codecs" | "drm-headers" | "drm-queryparams" | "drm-widevine-video-robustness" | "drm-widevine-audio-robustness" | "drm-playready-video-robustness" | "drm-playready-audio-robustness" | "webtransport-enabled" | "webcodecs-hardware-acceleration" | "offscreen-canvas-enabled" | "reconnect-retries" | "auto-instance-enabled" | "advanced-rendition-menu-enabled" | "refresh-poster-enabled" | "stream-poll-enabled")[];
 	constructor();
 	connectedCallback(): void;
 	disconnectedCallback(): void;

package/player.js

@@ -1,4 +1,4 @@
-import { t as e } from "./C2-H3s2r.js";
-import "./C3YYzwmQ.js";
-import { t } from "./ci2nH0xq.js";
+import { t as e } from "./CcCOP7K4.js";
+import "./tY-Iy2bb.js";
+import { t } from "./CQewxOcB.js";
 export { t as registerComponents, e as registerDebugComponents };

package/react.d.ts

@@ -176,6 +176,17 @@ interface DrmOptions {
 type Media = "audio" | "video" | "audio+video";
 type WebCodecsHardwareAccelerationPreference = "no-preference" | "prefer-hardware" | "prefer-software";
 type DecoderType = "mse" | "webcodecs" | "wasm";
+interface MediaSessionMetadata {
+	title?: string;
+	artist?: string;
+	album?: string;
+	/** Fetched by the operating system, so the URLs should not carry credentials. */
+	artwork?: Array<{
+		src: string;
+		sizes?: string;
+		type?: string;
+	}>;
+}
 interface Options {
 	/**
 	 * URL to use when connecting to the stream
@@ -255,13 +266,36 @@ interface Options {
 	 */
 	mseOpusEnabled?: boolean;
 	/**
-	 * Enable or disable support for playing audio in the background for iOS devices.
+	 * Keep playback running while the page is in the background. Enabled by default.
+	 * When disabled, the session disconnects while hidden and reconnects when visible.
 	 *
-	 * Is false (disabled) by default.
+	 * Browser media policies still apply; iOS Safari pauses hidden video regardless.
+	 * Call `play()` again from a user gesture or media-control action to resume.
 	 *
-	 * Note:  This may be enabled by default in a future (major) release
+	 * When enabled, hidden sessions that are muted outside Picture-in-Picture or browser-paused
+	 * are disconnected after the inactivity timeout; an explicit `pause()` disconnects at once.
+	 */
+	backgroundPlayEnabled?: boolean;
+	/**
+	 * @deprecated Use `backgroundPlayEnabled` instead.
+	 *
+	 * Legacy alias kept for backwards compatibility.
 	 */
 	iosBackgroundPlayEnabled?: boolean;
+	/**
+	 * Show the stream in the browser and OS media controls (notification, lock screen, toolbar) and
+	 * let play and pause from there reach the SDK. Enabled by default.
+	 *
+	 * The SDK takes over `navigator.mediaSession` for the document, so a page with its own Media
+	 * Session integration should disable this. On canvas playback paths a silent `<audio>` element is
+	 * added to `document.body` for the controls to attach to.
+	 */
+	mediaSessionEnabled?: boolean;
+	/**
+	 * Title, artist and artwork for the media controls. Without it the browser derives them from the
+	 * page. Read once at construction.
+	 */
+	mediaSessionMetadata?: MediaSessionMetadata;
 	/**
 	 * Enable or disable Adaptive Bit Rate. This allows for automatically adapting the incoming bit rate based on
 	 * the viewers bandwidth and thus avoiding buffering events. This also disables the
@@ -376,6 +410,9 @@ interface Options {
 	 * This enables platform media features such as fullscreen and picture-in-picture
 	 * for non-MSE playback by routing the canvas output through a `<video>` element.
 	 *
+	 * On iOS the audio then plays from its own element, so it continues in the background and under
+	 * lock. After an extended pause from the lock screen, reopening Safari may be required to resume.
+	 *
 	 * Disabled by default.
 	 */
 	streamToMediaElementEnabled?: boolean;
@@ -829,6 +866,13 @@ interface JitterModuleStatistics {
 	audioJitter: JitterStatistics | undefined;
 	videoJitter: JitterStatistics | undefined;
 }
+type DecoyState = "detached" | "attached" | "playing" | "blocked";
+interface MediaSessionModuleStatistics {
+	mediaSessionSupported: boolean;
+	mediaSessionOwner: boolean;
+	mediaSessionPlaybackState: MediaSessionPlaybackState;
+	decoyState?: DecoyState;
+}
 interface MseModuleStatistics {
 	quotaErrorCount: number;
 	mediaSourceOpenTime: number;
@@ -940,8 +984,10 @@ interface SyncModuleStatistics {
 interface VideoPlayerStatistics {
 	renderedFrameCount: number;
 	rendererDroppedFrameCount: number;
+	/** The platform's own view of the audio context, which a mute reading cannot tell apart. */
+	audioContextState?: AudioContextState | "none";
 }
-type ModuleStatistics = AdaptivityStatistics & BufferTimeStatistics & ConnectionStatistics & ConstraintCapStatistics & DecoderStatistics & DocumentStateModulesStatistics & IncomingDataModuleStatistics & JitterModuleStatistics & MseModuleStatistics & PlaybackModuleStatistics & QualityOfServiceModuleStatistics & RenditionsModuleStatistics & SyncModuleStatistics & TelemetryModuleStatistics & VideoPlayerStatistics;
+type ModuleStatistics = AdaptivityStatistics & BufferTimeStatistics & ConnectionStatistics & ConstraintCapStatistics & DecoderStatistics & DocumentStateModulesStatistics & IncomingDataModuleStatistics & JitterModuleStatistics & Partial<MediaSessionModuleStatistics> & MseModuleStatistics & PlaybackModuleStatistics & QualityOfServiceModuleStatistics & RenditionsModuleStatistics & SyncModuleStatistics & TelemetryModuleStatistics & VideoPlayerStatistics;
 type Statistics = ModuleStatistics & ReturnType<UserAgentInformation["getUserAgentInformation"]> & {
 	/**
 	 * Version of the @vindral/web-sdk being used.
@@ -993,6 +1039,8 @@ type Statistics = ModuleStatistics & ReturnType<UserAgentInformation["getUserAge
 	streamToMediaElementEnabled?: boolean;
 	/** @deprecated */
 	iosMediaElementEnabled?: boolean;
+	/** Whether the element carrying the audio is paused right now, on the sinks that have one. */
+	mediaElementPaused?: boolean;
 	/**
 	 * Average bitrate for the entire session in bits/second.
 	 */
@@ -1017,8 +1065,10 @@ type Statistics = ModuleStatistics & ReturnType<UserAgentInformation["getUserAge
 declare class Vindral extends Emitter<PublicVindralEvents> {
 	#private;
 	private static MAX_POOL_SIZE;
-	private static DISCONNECT_TIMEOUT;
 	private static REMOVE_CUE_THRESHOLD;
+	private static BACKGROUND_INACTIVITY_DISCONNECT_TIMEOUT;
+	/** How long a pause on a visible page may still turn out to be the platform backgrounding us. */
+	private static VISIBLE_PAUSE_DISCONNECT_DELAY;
 	/**
 	 * Picture in picture
 	 */
@@ -1061,6 +1111,10 @@ declare class Vindral extends Emitter<PublicVindralEvents> {
 	private offscreenCanvasElement?;
 	private webCodecsRenditionSupport;
 	private hasCalledConnect;
+	private hasRequestedAudioSession;
+	private isUserPaused;
+	/** Only the sinks that carry the audio report this, so a paused element here means silence. */
+	private isMediaElementPaused;
 	private latestEmittedLanguages;
 	private wakeLock;
 	private pool;
@@ -1075,7 +1129,8 @@ declare class Vindral extends Emitter<PublicVindralEvents> {
 	private readonly unextractableSamplesWarned;
 	private sizes;
 	private isSuspended;
-	private disconnectTimeout;
+	private inactivityDisconnectInterval;
+	private visiblePauseTimeout;
 	private offscreenSubtitleInterval?;
 	constructor(options: Options);
 	/**
@@ -1377,6 +1432,8 @@ declare class Vindral extends Emitter<PublicVindralEvents> {
 	private isSupportedVideoCodecProfile;
 	private supportedAudioCodecs;
 	private initializeDecodingModule;
+	private capturesCanvasOnWebKit;
+	private connectWebKitVideoOutput;
 	/**
 	 * Set up a polling interval that forwards subtitle cues to the decoder worker
 	 * when OffscreenCanvas rendering is active. This is needed because the canvas modules'
@@ -1408,6 +1465,12 @@ declare class Vindral extends Emitter<PublicVindralEvents> {
 	 * Pauses the stream. Call .play() to resume playback again.
 	 */
 	pause: () => void;
+	/**
+	 * A browser-initiated decoy pause means an interruption (another app took the focus, headphones
+	 * unplugged), so give the audio up rather than play over it. WebKit holds the decoy on purpose.
+	 */
+	private yieldToInterruption;
+	private fromNativeControls;
 	private registerDebugInstance;
 	/**
 	 *
@@ -1438,8 +1501,24 @@ declare class Vindral extends Emitter<PublicVindralEvents> {
 	 */
 	getStatistics: () => Statistics;
 	private resetModules;
+	private disconnectForInactivePage;
+	private scheduleInactivityDisconnect;
+	/**
+	 * iOS pauses the element a moment before it hides the page, and that pause reaches us while the
+	 * page still reports visible. Acting on it at once tears the session down, so every app switch
+	 * comes back as a full reconnect. Wait for the hide that follows a platform pause instead.
+	 * Nowhere else pauses before hiding, so there a visible pause is the viewer's at once.
+	 */
+	private onVisiblePause;
+	private disconnectForVisiblePause;
+	private clearVisiblePauseDisconnect;
+	private clearInactivityDisconnect;
+	private isHiddenWithBackgroundPlayback;
+	private isVideoOnScreen;
+	private isHiddenWithBackgroundPlayDisabled;
 	private suspend;
 	private unsuspend;
+	private resumeModules;
 	private getRuntimeInfo;
 	private getPlaybackBufferState;
 	private onMediaElementBufferState;
@@ -1453,6 +1532,20 @@ declare class Vindral extends Emitter<PublicVindralEvents> {
 	private get targetSubscription();
 	private timeToFirstFrame;
 	private resolvedDecoder;
+	/**
+	 * On mobile Chromium with WebCodecs audio the play action arrives but no sound comes back until
+	 * the page is visible, so a hidden pause is a stop there. Reads the decoder in use.
+	 */
+	private hiddenPauseIsStop;
+	private usesSplitCanvasAudio;
+	private isWebKitCanvasPath;
+	private holdsDecoyWhilePaused;
+	private streamsToMediaElement;
+	/**
+	 * Safari 16.4+: a playback audio session keeps Web Audio alive in the background. Document-wide
+	 * and not restorable, so it waits for playback to be wanted rather than for construction.
+	 */
+	private requestAudioSessionOnce;
 	private willUseMediaSource;
 	private shouldUseWebCodecs;
 	private isWebCodecsVideoAvailable;
@@ -1463,6 +1556,8 @@ declare class Vindral extends Emitter<PublicVindralEvents> {
 	 * is the optimal rendering path for WebCodecs (worker renders VideoFrames directly).
 	 */
 	private shouldUseOffscreenCanvas;
+	private isBackgroundPlayEnabled;
+	private shouldAllowBackgroundPlayback;
 }
 interface TelemetryModuleStatistics {
 	/**
@@ -1615,7 +1710,8 @@ interface PublicVindralEvents {
 	 * Is emitted during connection whether the channel is live or not.
 	 *
 	 * If the channel is not live, the Vindral instance will try to reconnect until the `reconnectHandler`
-	 * determines that no more retries should be made.
+	 * determines that no more retries should be made. Each attempt also emits a non-fatal `error` with
+	 * the code `channel_not_live`.
 	 *
 	 * Note: If the web-sdk is instantiated at the same time as you are starting the stream it is possible
 	 * that this emits false until the started state has propagated through the system.
@@ -1925,7 +2021,9 @@ declare class Controller extends HTMLElement {
 		"burst-enabled",
 		"mse-enabled",
 		"mse-opus-enabled",
+		"background-play-enabled",
 		"ios-background-play-enabled",
+		"media-session-enabled",
 		"ios-wake-lock-enabled",
 		"stream-to-media-element-enabled",
 		"ios-media-element-enabled",
@@ -2043,7 +2141,7 @@ declare class PlayButton extends VindralButton {
 type PlayerAttributes = (typeof Player.observedAttributes)[number];
 declare class Player extends HTMLElement {
 	#private;
-	static observedAttributes: readonly ("title" | "offline" | "advanced" | "poster" | "language" | "channels" | "buffering" | "paused" | "volume" | "muted" | "duration" | "user-interacting" | "is-casting" | "cast-available" | "cast-receiver-name" | "ui-locked" | "hide-ui-on-pause" | "is-fullscreen" | "is-fullscreen-fallback" | "rendition-levels" | "rendition-level" | "max-video-bit-rate" | "max-initial-bit-rate" | "abr-enabled" | "size-based-resolution-cap-enabled" | "channel-id" | "channel-group-id" | "pip-available" | "is-pip" | "airplay-available" | "is-airplaying" | "media" | "languages" | "text-tracks" | "text-track" | "needs-user-input-video" | "needs-user-input-audio" | "authentication-token" | "volume-level" | "cast" | "airplay" | "pip" | "fullscreen" | "double-click-fullscreen" | "vu-meter" | "timeshift" | "timeshift-position" | "timeline-markers" | "poster-src" | "debug-panel-open" | "target-buffer-time" | "drift" | "playback-latency" | "connection-state" | "url" | "decoders" | "min-buffer-time" | "max-buffer-time" | "edge-url" | "cast-receiver-id" | "cast-background" | "log-level" | "max-size" | "max-audio-bit-rate" | "burst-enabled" | "mse-enabled" | "mse-opus-enabled" | "ios-background-play-enabled" | "ios-wake-lock-enabled" | "stream-to-media-element-enabled" | "ios-media-element-enabled" | "telemetry-enabled" | "video-codecs" | "drm-headers" | "drm-queryparams" | "drm-widevine-video-robustness" | "drm-widevine-audio-robustness" | "drm-playready-video-robustness" | "drm-playready-audio-robustness" | "webtransport-enabled" | "webcodecs-hardware-acceleration" | "offscreen-canvas-enabled" | "reconnect-retries" | "auto-instance-enabled" | "advanced-rendition-menu-enabled" | "refresh-poster-enabled" | "stream-poll-enabled")[];
+	static observedAttributes: readonly ("title" | "offline" | "advanced" | "poster" | "language" | "channels" | "buffering" | "paused" | "volume" | "muted" | "duration" | "user-interacting" | "is-casting" | "cast-available" | "cast-receiver-name" | "ui-locked" | "hide-ui-on-pause" | "is-fullscreen" | "is-fullscreen-fallback" | "rendition-levels" | "rendition-level" | "max-video-bit-rate" | "max-initial-bit-rate" | "abr-enabled" | "size-based-resolution-cap-enabled" | "channel-id" | "channel-group-id" | "pip-available" | "is-pip" | "airplay-available" | "is-airplaying" | "media" | "languages" | "text-tracks" | "text-track" | "needs-user-input-video" | "needs-user-input-audio" | "authentication-token" | "volume-level" | "cast" | "airplay" | "pip" | "fullscreen" | "double-click-fullscreen" | "vu-meter" | "timeshift" | "timeshift-position" | "timeline-markers" | "poster-src" | "debug-panel-open" | "target-buffer-time" | "drift" | "playback-latency" | "connection-state" | "url" | "decoders" | "min-buffer-time" | "max-buffer-time" | "edge-url" | "cast-receiver-id" | "cast-background" | "log-level" | "max-size" | "max-audio-bit-rate" | "burst-enabled" | "mse-enabled" | "mse-opus-enabled" | "background-play-enabled" | "ios-background-play-enabled" | "media-session-enabled" | "ios-wake-lock-enabled" | "stream-to-media-element-enabled" | "ios-media-element-enabled" | "telemetry-enabled" | "video-codecs" | "drm-headers" | "drm-queryparams" | "drm-widevine-video-robustness" | "drm-widevine-audio-robustness" | "drm-playready-video-robustness" | "drm-playready-audio-robustness" | "webtransport-enabled" | "webcodecs-hardware-acceleration" | "offscreen-canvas-enabled" | "reconnect-retries" | "auto-instance-enabled" | "advanced-rendition-menu-enabled" | "refresh-poster-enabled" | "stream-poll-enabled")[];
 	constructor();
 	connectedCallback(): void;
 	disconnectedCallback(): void;