@vindral/web-sdk 4.7.2 → 4.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/{BqvCHW1b.js → Bf7Esc1M.js} +3383 -3108
- package/{6fUfml-Z.js → C2hzXxnL.js} +1 -1
- package/{BK-84KPi.js → CoLAnqGB.js} +3 -0
- package/DN0QZ0Rd.js +5087 -0
- package/README.md +2 -2
- package/{XEQIIc9P.js → ZUbKTiOB.js} +1 -1
- package/cast-sender.d.ts +3 -0
- package/core.d.ts +46 -17
- package/core.js +1 -1
- package/legacy.d.ts +46 -17
- package/legacy.es.js +1079 -802
- package/legacy.umd.js +17 -17
- package/package.json +1 -1
- package/player.d.ts +46 -14
- package/player.js +3 -3
- package/react.d.ts +46 -14
- package/vindral-player-component.js +2 -2
- package/CzQ6KH2E.js +0 -4783
package/package.json
CHANGED
package/player.d.ts
CHANGED
|
@@ -114,6 +114,7 @@ declare class UserAgentInformation {
|
|
|
114
114
|
ancestorOrigins: string[] | undefined;
|
|
115
115
|
hardwareConcurrency: number;
|
|
116
116
|
deviceMemory: number | undefined;
|
|
117
|
+
maxTouchPoints: number;
|
|
117
118
|
userAgentLegacy: string;
|
|
118
119
|
ua: {
|
|
119
120
|
browser: {
|
|
@@ -122,6 +123,8 @@ declare class UserAgentInformation {
|
|
|
122
123
|
majorVersions: string[];
|
|
123
124
|
};
|
|
124
125
|
device: string;
|
|
126
|
+
mobile: boolean | undefined;
|
|
127
|
+
formFactors: string[] | undefined;
|
|
125
128
|
os: {
|
|
126
129
|
family: string;
|
|
127
130
|
version: string;
|
|
@@ -134,6 +137,7 @@ declare class UserAgentInformation {
|
|
|
134
137
|
ancestorOrigins: string[] | undefined;
|
|
135
138
|
hardwareConcurrency: number;
|
|
136
139
|
deviceMemory: number | undefined;
|
|
140
|
+
maxTouchPoints: number;
|
|
137
141
|
userAgent: string;
|
|
138
142
|
};
|
|
139
143
|
}
|
|
@@ -384,6 +388,9 @@ interface Options {
|
|
|
384
388
|
* Note: the ReconnectState gets reset every time the client instance makes a successful connection.
|
|
385
389
|
* This means the default reconnect handler will only stop reconnecting after 30 _consecutive_ failed connections.
|
|
386
390
|
*
|
|
391
|
+
* While the page is hidden, a failure counts toward `reconnectRetries` only when the server answered: the channel
|
|
392
|
+
* is not live or not found, or the connect request got a 4xx other than 408 or 429. Retries back off up to 30 seconds.
|
|
393
|
+
*
|
|
387
394
|
* ```typescript
|
|
388
395
|
* // An example reconnect handler that will reconnect forever
|
|
389
396
|
* const reconnectHandler = (state: ReconnectState) => true
|
|
@@ -753,6 +760,14 @@ declare class ApiClient {
|
|
|
753
760
|
private toChannel;
|
|
754
761
|
}
|
|
755
762
|
type TransportSelectionReason = "unsupported" | "disabled" | "disabled_unstable_browser" | "unavailable" | "fallback";
|
|
763
|
+
interface DocumentStateModulesStatistics extends NavigatorConnectionStatistics {
|
|
764
|
+
isVisible: boolean;
|
|
765
|
+
isOnline: boolean;
|
|
766
|
+
isVisibleCount: number;
|
|
767
|
+
isHiddenCount: number;
|
|
768
|
+
isOnlineCount: number;
|
|
769
|
+
isOfflineCount: number;
|
|
770
|
+
}
|
|
756
771
|
interface AdaptivityStatistics {
|
|
757
772
|
/**
|
|
758
773
|
* True if adaptive bitrate (ABR) is enabled.
|
|
@@ -848,14 +863,6 @@ interface DecoderStatistics {
|
|
|
848
863
|
audioRenderer?: "AudioContext" | "MSE";
|
|
849
864
|
audioDecoder?: "WebCodecs" | "WASM" | "MSE";
|
|
850
865
|
}
|
|
851
|
-
interface DocumentStateModulesStatistics extends NavigatorConnectionStatistics {
|
|
852
|
-
isVisible: boolean;
|
|
853
|
-
isOnline: boolean;
|
|
854
|
-
isVisibleCount: number;
|
|
855
|
-
isHiddenCount: number;
|
|
856
|
-
isOnlineCount: number;
|
|
857
|
-
isOfflineCount: number;
|
|
858
|
-
}
|
|
859
866
|
interface IncomingDataModuleStatistics {
|
|
860
867
|
/**
|
|
861
868
|
* Current video bitrate in bits/second.
|
|
@@ -1129,6 +1136,8 @@ declare class Vindral extends Emitter<PublicVindralEvents> {
|
|
|
1129
1136
|
private offscreenCanvasElement?;
|
|
1130
1137
|
private webCodecsRenditionSupport;
|
|
1131
1138
|
private hasCalledConnect;
|
|
1139
|
+
/** The last upgrade check held, so the hold is logged once. */
|
|
1140
|
+
private upgradeHeld;
|
|
1132
1141
|
private hasRequestedAudioSession;
|
|
1133
1142
|
private isUserPaused;
|
|
1134
1143
|
/** Only the sinks that carry the audio report this, so a paused element here means silence. */
|
|
@@ -1443,10 +1452,18 @@ declare class Vindral extends Emitter<PublicVindralEvents> {
|
|
|
1443
1452
|
*/
|
|
1444
1453
|
getCastOptions: () => Options;
|
|
1445
1454
|
private onConnectInfo;
|
|
1455
|
+
/**
|
|
1456
|
+
* A recovery reconnect: the current level didn't fit the link. Rejoin at the lowest level and let ABR climb back,
|
|
1457
|
+
* since another backlog or stall costs more than a few seconds at low quality.
|
|
1458
|
+
*/
|
|
1459
|
+
private lowerTargetForRejoin;
|
|
1460
|
+
private onPingTimeout;
|
|
1446
1461
|
private emitLanguagesIfChanged;
|
|
1447
1462
|
private updateTextTracks;
|
|
1448
1463
|
private cleanupTextTracks;
|
|
1449
1464
|
private filterRenditions;
|
|
1465
|
+
/** The buffer lags behind the link: no upgrade while it queues, or while it is still unknown on a new connection. */
|
|
1466
|
+
private linkHoldsUpgrade;
|
|
1450
1467
|
/** Whether the bandwidth leaves room for a join burst of the video and audio the player starts at. */
|
|
1451
1468
|
private burstFits;
|
|
1452
1469
|
/**
|
|
@@ -1613,6 +1630,13 @@ interface ConnectionStatistics {
|
|
|
1613
1630
|
* Total number of connections that have been established since instantiation.
|
|
1614
1631
|
*/
|
|
1615
1632
|
connectCount: number;
|
|
1633
|
+
/**
|
|
1634
|
+
* Connections closed since instantiation because media queued too long between the edge and this client: the
|
|
1635
|
+
* link-queue breaker on vindral_ws and moq_ws, or missed pings on vindral_ws while its link queue is unknown. With ABR
|
|
1636
|
+
* on, the reconnect targets the lowest level, unless the player is already there, switching channel or on an
|
|
1637
|
+
* audio-only ladder.
|
|
1638
|
+
*/
|
|
1639
|
+
backlogReconnectCount: number;
|
|
1616
1640
|
/**
|
|
1617
1641
|
* Total number of connection attempts since instantiation.
|
|
1618
1642
|
*/
|
|
@@ -1640,6 +1664,12 @@ interface ConnectionStatistics {
|
|
|
1640
1664
|
* Unset while reconnecting; once disconnected, the last connection's.
|
|
1641
1665
|
*/
|
|
1642
1666
|
transportSelectionReason: TransportSelectionReason | undefined;
|
|
1667
|
+
/**
|
|
1668
|
+
* Media queued between the edge and this client over the last 30 seconds, in milliseconds, measured from the edge's
|
|
1669
|
+
* periodic timing info (vindral_ws) or stats (moq_ws). `last` is the current level. Unset while unknown and on
|
|
1670
|
+
* WebTransport. Arrival is read on the main thread, so a busy main thread (WASM decode, a heavy page) also counts.
|
|
1671
|
+
*/
|
|
1672
|
+
linkQueue?: MinMaxAverage;
|
|
1643
1673
|
}
|
|
1644
1674
|
interface LanguageSwitchContext {
|
|
1645
1675
|
/**
|
|
@@ -1649,7 +1679,7 @@ interface LanguageSwitchContext {
|
|
|
1649
1679
|
}
|
|
1650
1680
|
interface ChannelSwitchContext {
|
|
1651
1681
|
/**
|
|
1652
|
-
* The new channel
|
|
1682
|
+
* The new channel on "channel switch", the current channel on "channel switch failed"
|
|
1653
1683
|
*/
|
|
1654
1684
|
channelId: string;
|
|
1655
1685
|
}
|
|
@@ -1751,12 +1781,12 @@ interface PublicVindralEvents {
|
|
|
1751
1781
|
"is live": boolean;
|
|
1752
1782
|
/**
|
|
1753
1783
|
* Emitted when a channel switch has been completed and the first frame of the new channel is rendered.
|
|
1754
|
-
*
|
|
1784
|
+
* The argument holds the channel id of the new channel.
|
|
1755
1785
|
*/
|
|
1756
1786
|
"channel switch": Readonly<ChannelSwitchContext>;
|
|
1757
1787
|
/**
|
|
1758
|
-
*
|
|
1759
|
-
*
|
|
1788
|
+
* Emitted when a channel switch fails.
|
|
1789
|
+
* The argument holds the channel id of the current channel.
|
|
1760
1790
|
*/
|
|
1761
1791
|
"channel switch failed": Readonly<ChannelSwitchContext>;
|
|
1762
1792
|
/**
|
|
@@ -2016,6 +2046,7 @@ declare class Fullscreen extends Emitter<FullscreenEvents> {
|
|
|
2016
2046
|
export interface TimelineMarker {
|
|
2017
2047
|
/** Wall-clock time of the event in epoch ms */
|
|
2018
2048
|
time: number;
|
|
2049
|
+
/** Text shown in the seek bar tooltip */
|
|
2019
2050
|
label: string;
|
|
2020
2051
|
type?: string;
|
|
2021
2052
|
}
|
|
@@ -2023,6 +2054,7 @@ export interface TimelineMarker {
|
|
|
2023
2054
|
export interface TimelineMarkerInput {
|
|
2024
2055
|
/** Wall-clock time of the event as epoch ms, ISO 8601 string or Date */
|
|
2025
2056
|
time: number | string | Date;
|
|
2057
|
+
/** Text shown in the seek bar tooltip; markers without one are dropped */
|
|
2026
2058
|
label: string;
|
|
2027
2059
|
type?: string;
|
|
2028
2060
|
}
|
|
@@ -2030,7 +2062,7 @@ type ControllerAttributes = (typeof Controller.observedAttributes)[number];
|
|
|
2030
2062
|
export declare class Controller extends HTMLElement {
|
|
2031
2063
|
#private;
|
|
2032
2064
|
static observedAttributes: readonly [
|
|
2033
|
-
...("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")[],
|
|
2065
|
+
...("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" | "timeshift-thumbnail-url" | "seek-preview" | "timeline-markers" | "poster-src" | "debug-panel-open" | "target-buffer-time" | "drift" | "playback-latency" | "connection-state")[],
|
|
2034
2066
|
"url",
|
|
2035
2067
|
"edge-url",
|
|
2036
2068
|
"target-buffer-time",
|
|
@@ -2166,7 +2198,7 @@ export declare class PlayButton extends VindralButton {
|
|
|
2166
2198
|
*/
|
|
2167
2199
|
export declare class Player extends HTMLElement {
|
|
2168
2200
|
#private;
|
|
2169
|
-
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")[];
|
|
2201
|
+
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" | "timeshift-thumbnail-url" | "seek-preview" | "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")[];
|
|
2170
2202
|
constructor();
|
|
2171
2203
|
connectedCallback(): void;
|
|
2172
2204
|
disconnectedCallback(): void;
|
package/player.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { t as e } from "./
|
|
2
|
-
import "./
|
|
3
|
-
import { t } from "./
|
|
1
|
+
import { t as e } from "./ZUbKTiOB.js";
|
|
2
|
+
import "./Bf7Esc1M.js";
|
|
3
|
+
import { t } from "./DN0QZ0Rd.js";
|
|
4
4
|
export { t as registerComponents, e as registerDebugComponents };
|
package/react.d.ts
CHANGED
|
@@ -116,6 +116,7 @@ declare class UserAgentInformation {
|
|
|
116
116
|
ancestorOrigins: string[] | undefined;
|
|
117
117
|
hardwareConcurrency: number;
|
|
118
118
|
deviceMemory: number | undefined;
|
|
119
|
+
maxTouchPoints: number;
|
|
119
120
|
userAgentLegacy: string;
|
|
120
121
|
ua: {
|
|
121
122
|
browser: {
|
|
@@ -124,6 +125,8 @@ declare class UserAgentInformation {
|
|
|
124
125
|
majorVersions: string[];
|
|
125
126
|
};
|
|
126
127
|
device: string;
|
|
128
|
+
mobile: boolean | undefined;
|
|
129
|
+
formFactors: string[] | undefined;
|
|
127
130
|
os: {
|
|
128
131
|
family: string;
|
|
129
132
|
version: string;
|
|
@@ -136,6 +139,7 @@ declare class UserAgentInformation {
|
|
|
136
139
|
ancestorOrigins: string[] | undefined;
|
|
137
140
|
hardwareConcurrency: number;
|
|
138
141
|
deviceMemory: number | undefined;
|
|
142
|
+
maxTouchPoints: number;
|
|
139
143
|
userAgent: string;
|
|
140
144
|
};
|
|
141
145
|
}
|
|
@@ -386,6 +390,9 @@ interface Options {
|
|
|
386
390
|
* Note: the ReconnectState gets reset every time the client instance makes a successful connection.
|
|
387
391
|
* This means the default reconnect handler will only stop reconnecting after 30 _consecutive_ failed connections.
|
|
388
392
|
*
|
|
393
|
+
* While the page is hidden, a failure counts toward `reconnectRetries` only when the server answered: the channel
|
|
394
|
+
* is not live or not found, or the connect request got a 4xx other than 408 or 429. Retries back off up to 30 seconds.
|
|
395
|
+
*
|
|
389
396
|
* ```typescript
|
|
390
397
|
* // An example reconnect handler that will reconnect forever
|
|
391
398
|
* const reconnectHandler = (state: ReconnectState) => true
|
|
@@ -755,6 +762,14 @@ declare class ApiClient {
|
|
|
755
762
|
private toChannel;
|
|
756
763
|
}
|
|
757
764
|
type TransportSelectionReason = "unsupported" | "disabled" | "disabled_unstable_browser" | "unavailable" | "fallback";
|
|
765
|
+
interface DocumentStateModulesStatistics extends NavigatorConnectionStatistics {
|
|
766
|
+
isVisible: boolean;
|
|
767
|
+
isOnline: boolean;
|
|
768
|
+
isVisibleCount: number;
|
|
769
|
+
isHiddenCount: number;
|
|
770
|
+
isOnlineCount: number;
|
|
771
|
+
isOfflineCount: number;
|
|
772
|
+
}
|
|
758
773
|
interface AdaptivityStatistics {
|
|
759
774
|
/**
|
|
760
775
|
* True if adaptive bitrate (ABR) is enabled.
|
|
@@ -850,14 +865,6 @@ interface DecoderStatistics {
|
|
|
850
865
|
audioRenderer?: "AudioContext" | "MSE";
|
|
851
866
|
audioDecoder?: "WebCodecs" | "WASM" | "MSE";
|
|
852
867
|
}
|
|
853
|
-
interface DocumentStateModulesStatistics extends NavigatorConnectionStatistics {
|
|
854
|
-
isVisible: boolean;
|
|
855
|
-
isOnline: boolean;
|
|
856
|
-
isVisibleCount: number;
|
|
857
|
-
isHiddenCount: number;
|
|
858
|
-
isOnlineCount: number;
|
|
859
|
-
isOfflineCount: number;
|
|
860
|
-
}
|
|
861
868
|
interface IncomingDataModuleStatistics {
|
|
862
869
|
/**
|
|
863
870
|
* Current video bitrate in bits/second.
|
|
@@ -1131,6 +1138,8 @@ declare class Vindral extends Emitter<PublicVindralEvents> {
|
|
|
1131
1138
|
private offscreenCanvasElement?;
|
|
1132
1139
|
private webCodecsRenditionSupport;
|
|
1133
1140
|
private hasCalledConnect;
|
|
1141
|
+
/** The last upgrade check held, so the hold is logged once. */
|
|
1142
|
+
private upgradeHeld;
|
|
1134
1143
|
private hasRequestedAudioSession;
|
|
1135
1144
|
private isUserPaused;
|
|
1136
1145
|
/** Only the sinks that carry the audio report this, so a paused element here means silence. */
|
|
@@ -1445,10 +1454,18 @@ declare class Vindral extends Emitter<PublicVindralEvents> {
|
|
|
1445
1454
|
*/
|
|
1446
1455
|
getCastOptions: () => Options;
|
|
1447
1456
|
private onConnectInfo;
|
|
1457
|
+
/**
|
|
1458
|
+
* A recovery reconnect: the current level didn't fit the link. Rejoin at the lowest level and let ABR climb back,
|
|
1459
|
+
* since another backlog or stall costs more than a few seconds at low quality.
|
|
1460
|
+
*/
|
|
1461
|
+
private lowerTargetForRejoin;
|
|
1462
|
+
private onPingTimeout;
|
|
1448
1463
|
private emitLanguagesIfChanged;
|
|
1449
1464
|
private updateTextTracks;
|
|
1450
1465
|
private cleanupTextTracks;
|
|
1451
1466
|
private filterRenditions;
|
|
1467
|
+
/** The buffer lags behind the link: no upgrade while it queues, or while it is still unknown on a new connection. */
|
|
1468
|
+
private linkHoldsUpgrade;
|
|
1452
1469
|
/** Whether the bandwidth leaves room for a join burst of the video and audio the player starts at. */
|
|
1453
1470
|
private burstFits;
|
|
1454
1471
|
/**
|
|
@@ -1615,6 +1632,13 @@ interface ConnectionStatistics {
|
|
|
1615
1632
|
* Total number of connections that have been established since instantiation.
|
|
1616
1633
|
*/
|
|
1617
1634
|
connectCount: number;
|
|
1635
|
+
/**
|
|
1636
|
+
* Connections closed since instantiation because media queued too long between the edge and this client: the
|
|
1637
|
+
* link-queue breaker on vindral_ws and moq_ws, or missed pings on vindral_ws while its link queue is unknown. With ABR
|
|
1638
|
+
* on, the reconnect targets the lowest level, unless the player is already there, switching channel or on an
|
|
1639
|
+
* audio-only ladder.
|
|
1640
|
+
*/
|
|
1641
|
+
backlogReconnectCount: number;
|
|
1618
1642
|
/**
|
|
1619
1643
|
* Total number of connection attempts since instantiation.
|
|
1620
1644
|
*/
|
|
@@ -1642,6 +1666,12 @@ interface ConnectionStatistics {
|
|
|
1642
1666
|
* Unset while reconnecting; once disconnected, the last connection's.
|
|
1643
1667
|
*/
|
|
1644
1668
|
transportSelectionReason: TransportSelectionReason | undefined;
|
|
1669
|
+
/**
|
|
1670
|
+
* Media queued between the edge and this client over the last 30 seconds, in milliseconds, measured from the edge's
|
|
1671
|
+
* periodic timing info (vindral_ws) or stats (moq_ws). `last` is the current level. Unset while unknown and on
|
|
1672
|
+
* WebTransport. Arrival is read on the main thread, so a busy main thread (WASM decode, a heavy page) also counts.
|
|
1673
|
+
*/
|
|
1674
|
+
linkQueue?: MinMaxAverage;
|
|
1645
1675
|
}
|
|
1646
1676
|
interface LanguageSwitchContext {
|
|
1647
1677
|
/**
|
|
@@ -1651,7 +1681,7 @@ interface LanguageSwitchContext {
|
|
|
1651
1681
|
}
|
|
1652
1682
|
interface ChannelSwitchContext {
|
|
1653
1683
|
/**
|
|
1654
|
-
* The new channel
|
|
1684
|
+
* The new channel on "channel switch", the current channel on "channel switch failed"
|
|
1655
1685
|
*/
|
|
1656
1686
|
channelId: string;
|
|
1657
1687
|
}
|
|
@@ -1753,12 +1783,12 @@ interface PublicVindralEvents {
|
|
|
1753
1783
|
"is live": boolean;
|
|
1754
1784
|
/**
|
|
1755
1785
|
* Emitted when a channel switch has been completed and the first frame of the new channel is rendered.
|
|
1756
|
-
*
|
|
1786
|
+
* The argument holds the channel id of the new channel.
|
|
1757
1787
|
*/
|
|
1758
1788
|
"channel switch": Readonly<ChannelSwitchContext>;
|
|
1759
1789
|
/**
|
|
1760
|
-
*
|
|
1761
|
-
*
|
|
1790
|
+
* Emitted when a channel switch fails.
|
|
1791
|
+
* The argument holds the channel id of the current channel.
|
|
1762
1792
|
*/
|
|
1763
1793
|
"channel switch failed": Readonly<ChannelSwitchContext>;
|
|
1764
1794
|
/**
|
|
@@ -2026,12 +2056,14 @@ declare class Fullscreen extends Emitter<FullscreenEvents> {
|
|
|
2026
2056
|
interface TimelineMarker {
|
|
2027
2057
|
/** Wall-clock time of the event in epoch ms */
|
|
2028
2058
|
time: number;
|
|
2059
|
+
/** Text shown in the seek bar tooltip */
|
|
2029
2060
|
label: string;
|
|
2030
2061
|
type?: string;
|
|
2031
2062
|
}
|
|
2032
2063
|
interface TimelineMarkerInput {
|
|
2033
2064
|
/** Wall-clock time of the event as epoch ms, ISO 8601 string or Date */
|
|
2034
2065
|
time: number | string | Date;
|
|
2066
|
+
/** Text shown in the seek bar tooltip; markers without one are dropped */
|
|
2035
2067
|
label: string;
|
|
2036
2068
|
type?: string;
|
|
2037
2069
|
}
|
|
@@ -2039,7 +2071,7 @@ type ControllerAttributes = (typeof Controller.observedAttributes)[number];
|
|
|
2039
2071
|
declare class Controller extends HTMLElement {
|
|
2040
2072
|
#private;
|
|
2041
2073
|
static observedAttributes: readonly [
|
|
2042
|
-
...("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")[],
|
|
2074
|
+
...("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" | "timeshift-thumbnail-url" | "seek-preview" | "timeline-markers" | "poster-src" | "debug-panel-open" | "target-buffer-time" | "drift" | "playback-latency" | "connection-state")[],
|
|
2043
2075
|
"url",
|
|
2044
2076
|
"edge-url",
|
|
2045
2077
|
"target-buffer-time",
|
|
@@ -2175,7 +2207,7 @@ declare class PlayButton extends VindralButton {
|
|
|
2175
2207
|
type PlayerAttributes = (typeof Player.observedAttributes)[number];
|
|
2176
2208
|
declare class Player extends HTMLElement {
|
|
2177
2209
|
#private;
|
|
2178
|
-
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")[];
|
|
2210
|
+
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" | "timeshift-thumbnail-url" | "seek-preview" | "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")[];
|
|
2179
2211
|
constructor();
|
|
2180
2212
|
connectedCallback(): void;
|
|
2181
2213
|
disconnectedCallback(): void;
|