@vindral/web-sdk 4.1.1 → 4.1.2-10-g30d188ef

package/react.d.ts

@@ -284,6 +284,20 @@ interface DrmOptions {
 	 * Query parameters to be added to requests to license servers
 	 */
 	queryParams?: Record<string, string>;
+	/**
+	 * Widevine options to override default behaviour
+	 */
+	widevine?: {
+		videoRobustness?: string[];
+		audioRobustness?: string[];
+	};
+	/**
+	 * Playready options to override default behaviour
+	 */
+	playready?: {
+		videoRobustness?: string[];
+		audioRobustness?: string[];
+	};
 }
 type Media = "audio" | "video" | "audio+video";
 interface Options {
@@ -983,11 +997,20 @@ declare class Vindral extends Emitter<PublicVindralEvents> {
 	 */
 	get channelCurrentTime(): number;
 	/**
-	 * The current target buffer time in milliseconds
+	 * The current target buffer time in milliseconds.
+	 *
+	 * Initially, this will always be equal to `minBufferTime`.
+	 * Only when using a separate `maxBufferTime`, the `targetBufferTime` will be able to vary between min and max.
+	 *
 	 */
 	get targetBufferTime(): number;
 	/**
-	 * Set the current target buffer time in milliseconds
+	 * Set the current target buffer time in milliseconds.
+	 *
+	 * Note that setting this will not respect min/max buffer time values.
+	 * For instance with `{ minBufferTime: 500, maxBufferTime: 3000 }, you can still set `targetBufferTime` to 100 ms.`
+	 * The dynamic buffer will still work in respect to the originally set values when needed. Therefore we recommend
+	 * setting targetBufferTime within that range for consistancy if using both min/max.
 	 */
 	set targetBufferTime(bufferTimeMs: number);
 	/**
@@ -1534,6 +1557,7 @@ declare class AirPlaySender extends Emitter<AirPlaySenderEvents> {
 	private hlsUrl;
 	private element;
 	private connectingTimeout?;
+	private castingAvailable;
 	constructor(config: AirPlayConfig);
 	/**
 	 * True if the instance is casting right now.
@@ -1545,8 +1569,9 @@ declare class AirPlaySender extends Emitter<AirPlaySenderEvents> {
 	set channelId(channelId: string);
 	/**
 	 * Update authentication token on an already established and authenticated connection.
+	 * Note: When casting to AirPlay, this will interrupt the current session to apply the new token.
 	 */
-	updateAuthenticationToken: (_token: string) => void;
+	updateAuthenticationToken: (token: string) => void;
 	/**
 	 * Fully unloads the instance. This disconnects the current listeners.
 	 */
@@ -1561,6 +1586,7 @@ declare class AirPlaySender extends Emitter<AirPlaySenderEvents> {
 	static isAirPlaySupported(): boolean;
 	private onAirPlayAvailable;
 	private onAirPlayPlaybackChanged;
+	private getHlsUrl;
 	private checkHlsUrl;
 }
 type ControllerAttributes = (typeof Controller.observedAttributes)[number];
@@ -1592,6 +1618,10 @@ declare class Controller extends HTMLElement {
 		"advanced",
 		"drm-headers",
 		"drm-queryparams",
+		"drm-widevine-video-robustness",
+		"drm-widevine-audio-robustness",
+		"drm-playready-video-robustness",
+		"drm-playready-audio-robustness",
 		"webtransport-enabled",
 		"reconnect-retries",
 		"auto-instance-enabled",
@@ -1690,7 +1720,7 @@ declare class PlayButton extends VindralButton {
 type PlayerAttributes = (typeof Player.observedAttributes)[number];
 declare class Player extends HTMLElement {
 	#private;
-	static observedAttributes: readonly ("title" | "advanced" | "poster" | "language" | "channels" | "buffering" | "paused" | "volume" | "muted" | "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" | "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" | "vu-meter" | "poster-src" | "url" | "offline" | "edge-url" | "target-buffer-time" | "cast-receiver-id" | "cast-background" | "log-level" | "max-size" | "min-buffer-time" | "max-buffer-time" | "max-audio-bit-rate" | "burst-enabled" | "mse-enabled" | "mse-opus-enabled" | "ios-background-play-enabled" | "ios-wake-lock-enabled" | "ios-media-element-enabled" | "abr-enabled" | "size-based-resolution-cap-enabled" | "telemetry-enabled" | "video-codecs" | "drm-headers" | "drm-queryparams" | "webtransport-enabled" | "reconnect-retries" | "auto-instance-enabled" | "refresh-poster-enabled" | "stream-poll-enabled")[];
+	static observedAttributes: readonly ("title" | "advanced" | "poster" | "language" | "channels" | "buffering" | "paused" | "volume" | "muted" | "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" | "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" | "vu-meter" | "poster-src" | "url" | "offline" | "edge-url" | "target-buffer-time" | "cast-receiver-id" | "cast-background" | "log-level" | "max-size" | "min-buffer-time" | "max-buffer-time" | "max-audio-bit-rate" | "burst-enabled" | "mse-enabled" | "mse-opus-enabled" | "ios-background-play-enabled" | "ios-wake-lock-enabled" | "ios-media-element-enabled" | "abr-enabled" | "size-based-resolution-cap-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" | "reconnect-retries" | "auto-instance-enabled" | "refresh-poster-enabled" | "stream-poll-enabled")[];
 	constructor();
 	connectedCallback(): void;
 	disconnectedCallback(): void;