@vindral/web-sdk 4.7.1 → 4.7.2-1-g49d73f7f

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "4.7.1",
+  "version": "4.7.2-1-g49d73f7f",
   "name": "@vindral/web-sdk",
   "main": "./legacy.umd.js",
   "module": "./legacy.es.js",

package/player.d.ts

@@ -402,6 +402,17 @@ interface Options {
 	logShippingEnabled?: boolean;
 	statsShippingEnabled?: boolean;
 	webtransportEnabled?: boolean;
+	/**
+	 * Use WebTransport for MoQ on browsers where it is unstable. When false, these connect MoQ over
+	 * WebSocket directly. Unstable browsers:
+	 * - Safari and every iOS/iPadOS browser (all WebKit): far more buffering than over WebSocket.
+	 * - Samsung Internet on Tizen Smart TVs: WebTransport connects fail and fall back to WebSocket.
+	 *
+	 * Has no effect when webtransportEnabled is false.
+	 *
+	 * Default is false.
+	 */
+	unstableWebtransportEnabled?: boolean;
 	/**
 	 * Enable wake lock for iOS devices.
 	 * The wake lock requires that the audio has been activated at least once for the instance, othwerwise it will not work.
@@ -741,7 +752,7 @@ declare class ApiClient {
 	private toChannels;
 	private toChannel;
 }
-type TransportSelectionReason = "unsupported" | "disabled" | "unavailable" | "fallback";
+type TransportSelectionReason = "unsupported" | "disabled" | "disabled_unstable_browser" | "unavailable" | "fallback";
 interface AdaptivityStatistics {
 	/**
 	 * True if adaptive bitrate (ABR) is enabled.
@@ -1623,6 +1634,7 @@ interface ConnectionStatistics {
 	 * When connectionProtocol is "moq_ws", indicates why WebSocket was used instead of WebTransport.
 	 * - "unsupported": browser doesn't support WebTransport
 	 * - "disabled": webtransportEnabled option is false
+	 * - "disabled_unstable_browser": browser with unstable WebTransport, and unstableWebtransportEnabled option is false
 	 * - "unavailable": edge did not offer a WebTransport endpoint
 	 * - "fallback": WebTransport was attempted but failed or timed out
 	 * Unset while reconnecting; once disconnected, the last connection's.
@@ -2052,6 +2064,7 @@ export declare class Controller extends HTMLElement {
 		"drm-playready-video-robustness",
 		"drm-playready-audio-robustness",
 		"webtransport-enabled",
+		"unstable-webtransport-enabled",
 		"webcodecs-hardware-acceleration",
 		"decoders",
 		"offscreen-canvas-enabled",
@@ -2153,7 +2166,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" | "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")[];
+	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" | "unstable-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 "./XEQIIc9P.js";
-import "./BZbYOX-0.js";
-import { t } from "./wRfUpHJt.js";
+import "./ksXX-BNs.js";
+import { t } from "./YuzOg3X6.js";
 export { t as registerComponents, e as registerDebugComponents };

package/react.d.ts

@@ -404,6 +404,17 @@ interface Options {
 	logShippingEnabled?: boolean;
 	statsShippingEnabled?: boolean;
 	webtransportEnabled?: boolean;
+	/**
+	 * Use WebTransport for MoQ on browsers where it is unstable. When false, these connect MoQ over
+	 * WebSocket directly. Unstable browsers:
+	 * - Safari and every iOS/iPadOS browser (all WebKit): far more buffering than over WebSocket.
+	 * - Samsung Internet on Tizen Smart TVs: WebTransport connects fail and fall back to WebSocket.
+	 *
+	 * Has no effect when webtransportEnabled is false.
+	 *
+	 * Default is false.
+	 */
+	unstableWebtransportEnabled?: boolean;
 	/**
 	 * Enable wake lock for iOS devices.
 	 * The wake lock requires that the audio has been activated at least once for the instance, othwerwise it will not work.
@@ -743,7 +754,7 @@ declare class ApiClient {
 	private toChannels;
 	private toChannel;
 }
-type TransportSelectionReason = "unsupported" | "disabled" | "unavailable" | "fallback";
+type TransportSelectionReason = "unsupported" | "disabled" | "disabled_unstable_browser" | "unavailable" | "fallback";
 interface AdaptivityStatistics {
 	/**
 	 * True if adaptive bitrate (ABR) is enabled.
@@ -1625,6 +1636,7 @@ interface ConnectionStatistics {
 	 * When connectionProtocol is "moq_ws", indicates why WebSocket was used instead of WebTransport.
 	 * - "unsupported": browser doesn't support WebTransport
 	 * - "disabled": webtransportEnabled option is false
+	 * - "disabled_unstable_browser": browser with unstable WebTransport, and unstableWebtransportEnabled option is false
 	 * - "unavailable": edge did not offer a WebTransport endpoint
 	 * - "fallback": WebTransport was attempted but failed or timed out
 	 * Unset while reconnecting; once disconnected, the last connection's.
@@ -2061,6 +2073,7 @@ declare class Controller extends HTMLElement {
 		"drm-playready-video-robustness",
 		"drm-playready-audio-robustness",
 		"webtransport-enabled",
+		"unstable-webtransport-enabled",
 		"webcodecs-hardware-acceleration",
 		"decoders",
 		"offscreen-canvas-enabled",
@@ -2162,7 +2175,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" | "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")[];
+	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" | "unstable-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/vindral-player-component.js

@@ -1,5 +1,5 @@
-import "./BZbYOX-0.js";
-import { t as e } from "./wRfUpHJt.js";
+import "./ksXX-BNs.js";
+import { t as e } from "./YuzOg3X6.js";
 //#region src/vindral-player-component.ts
 e();
 //#endregion