@vindral/web-sdk 2.0.13 → 2.0.17

package/index.d.ts

@@ -7,6 +7,7 @@ interface BaseCodedSample {
 	timescale: number;
 	duration: number;
 	data: ArrayBuffer;
+	compositionTimeOffset?: number;
 }
 interface CodedAudioSample extends BaseCodedSample {
 	type: "audio";
@@ -181,6 +182,7 @@ export interface PlaybackSource {
 	playbackRate?: number;
 	isActivated: boolean;
 	readonly seekTime: number;
+	readonly paused: boolean;
 	readonly isSeeking: boolean;
 	play(initiator: PlayInitiator): Promise<void>;
 }
@@ -281,6 +283,7 @@ declare class PlaybackModule {
 }
 declare type Direction = "upgrade" | "downgrade" | "double downgrade" | "reconnect";
 interface QualityOfServiceConfig {
+	cooldownTime: number;
 	maxBufferingEvents: {
 		last10Seconds: number;
 		last30Seconds: number;
@@ -300,6 +303,9 @@ interface QualityOfServiceConfig {
 interface AdaptivityEvents {
 	["adapt level"]: Readonly<Direction>;
 }
+interface AdaptivityStatistics {
+	isAbrEnabled: boolean;
+}
 interface QualityOfServiceSource {
 	getMetrics(): Metrics;
 	getLevelStats(level: RenditionLevel): PerLevelStats | undefined;
@@ -317,7 +323,6 @@ declare class AdaptivityModule {
 	private logger;
 	private isSuspended;
 	private lastAdaptTime;
-	private cooldownTime;
 	isEnabled: boolean;
 	constructor(emitter: Emitter<AdaptivityEvents>, logger: Logger, qualityOfServiceSource: QualityOfServiceSource, config: Partial<QualityOfServiceConfig>);
 	static create: (emitter: Emitter<AdaptivityEvents>, logger: Logger, qualityOfServiceSource: QualityOfServiceSource, config?: Partial<QualityOfServiceConfig>) => AdaptivityModule;
@@ -326,6 +331,7 @@ declare class AdaptivityModule {
 	suspend: () => void;
 	unsuspend: () => void;
 	reset: () => void;
+	getStatistics: () => AdaptivityStatistics;
 	isQoSOk: (renditionLevel: RenditionLevel) => boolean;
 	private onBufferState;
 	private onAdaptedLevel;
@@ -368,6 +374,7 @@ declare class AudioPlayerModule {
 	get isSeeking(): boolean;
 	get muted(): boolean;
 	set muted(muted: boolean);
+	get paused(): boolean;
 	get currentTime(): number;
 	set currentTime(currentTime: number);
 	constructor(emitter: Emitter<AudioPlayerModuleListeners, AudioPlayerModuleEvents>, logger: Logger, clockSource: ClockSource, muted: boolean);
@@ -441,6 +448,7 @@ interface ConnectionStatistics {
 	estimatedBandwidth: number;
 	edgeUrl?: string;
 	connectCount: number;
+	connectionAttemptCount: number;
 }
 declare class ConnectionModule {
 	private static PING_INTERVAL;
@@ -480,7 +488,7 @@ declare class ConnectionModule {
 	private onTransportChange;
 	disconnect: (reason?: string) => void;
 	reconnect: (reason: string) => void;
-	private cleanupOnDisconnect;
+	private cleanupPingIntervals;
 	private sendPing;
 }
 interface Size {
@@ -728,7 +736,6 @@ declare class DocumentStateModule implements DocumentState {
 	private onOffline;
 	private onPageHide;
 	private onVisibilityChanged;
-	private onFocusChange;
 	private setIsActive;
 }
 interface IncomingDataModuleListeners {
@@ -777,23 +784,23 @@ declare class LoggerModule {
 interface MetadataModuleEvents {
 	["metadata"]: Readonly<Metadata>;
 }
-interface MetadataModuleListeners {
-	["buffer state"]: Readonly<BufferState>;
-}
-interface DriftSource {
+interface TimeSource {
 	readonly drift: number | undefined;
+	readonly serverCurrentTime: number;
 }
 declare class MetadataModule {
 	private static METADATA_TIMEOUT;
+	private static METADATA_CHECK_INTERVAL;
 	private logger;
 	private emitter;
 	private waitingMetadata;
 	private isTriggered;
-	private driftSource;
-	constructor(emitter: Emitter<MetadataModuleListeners, MetadataModuleEvents>, logger: Logger, driftSource: DriftSource);
+	private timeSource;
+	private timers;
+	constructor(emitter: Emitter<unknown, MetadataModuleEvents>, logger: Logger, timeSource: TimeSource);
 	load: () => void;
 	unload: () => void;
-	static create: (emitter: Emitter<MetadataModuleListeners, MetadataModuleEvents>, logger: Logger, driftSource: DriftSource) => MetadataModule;
+	static create: (emitter: Emitter<unknown, MetadataModuleEvents>, logger: Logger, timeSource: TimeSource) => MetadataModule;
 	addMetadata: (metadata: Metadata) => void;
 	private onBufferedStateChanged;
 }
@@ -804,6 +811,9 @@ interface MseModuleListeners {
 	["init segment"]: Readonly<InitSegment>;
 	["coded sample"]: Readonly<CodedSample>;
 }
+interface MseModuleStatistics {
+	quotaErrorCount: number;
+}
 declare class MseModule {
 	private logger;
 	private timers;
@@ -815,9 +825,11 @@ declare class MseModule {
 	private autoRecoverFromMediaErrors;
 	private pendingSamples;
 	private isWorkingOnPendingSamples;
+	private quotaErrorCount;
 	constructor(logger: Logger, emitter: Emitter<MseModuleListeners, MseModuleEvents>, mediaElement: HTMLMediaElement, tracks: Track[]);
 	static create: (logger: Logger, emitter: Emitter<MseModuleListeners, MseModuleEvents>, mediaElement: HTMLMediaElement, tracks: Track[]) => Promise<MseModule>;
 	unload: () => void;
+	getStatistics: () => MseModuleStatistics;
 	private open;
 	getBuffer: (type: Type) => TimeRange[];
 	init: (initSegment: Readonly<InitSegment>) => void;
@@ -869,6 +881,7 @@ interface QualityOfServiceModuleStatistics {
 	};
 }
 declare class QualityOfServiceModule {
+	private readonly minBufferFullnessLengthForRegression;
 	private logger;
 	private emitter;
 	private timers;
@@ -924,12 +937,14 @@ declare class SubscriptionModule {
 	private currentSubscription;
 	private _isSwitchingSubscription;
 	private pendingSubscriptionTimeoutId?;
+	private burstMs;
 	private constructor();
 	unload: () => void;
 	static create: (logger: Logger, emitter: Emitter<SubscriptionModuleListeners>, subscription: Subscription) => SubscriptionModule;
 	isSwitchingSubscription: () => boolean;
 	getTargetSubscription: () => Subscription;
 	getCurrentSubscription: () => Subscription;
+	enableBurst: (bufferTimeMs: number) => void;
 	setSize: (size: Readonly<Size>) => void;
 	setVideoConstraint: (constraint: VideoConstraint) => void;
 	setAudioConstraint: (constraint: AudioConstraint) => void;
@@ -939,6 +954,7 @@ declare class SubscriptionModule {
 	setLanguage: (language: string | undefined) => void;
 	setVideoCodec: (videoCodec: VideoCodec | undefined) => void;
 	setAudioCodec: (audioCodec: AudioCodec | undefined) => void;
+	private setBurst;
 	private onSubscriptionChanged;
 	private scheduleSubscriptionChange;
 }
@@ -965,8 +981,9 @@ interface BufferSource {
 interface SyncModuleStatistics {
 	drift: number | undefined;
 	driftAdjustmentCount: number;
-	playbackRateAdjustmentCount: number;
+	timeshiftDriftAdjustmentCount: number;
 	discardedTimeInfoCount: number;
+	seekTime: number;
 }
 declare class SyncModule {
 	private emitter;
@@ -974,25 +991,29 @@ declare class SyncModule {
 	private playbackSource;
 	private bufferSource;
 	private lastSeekTime;
-	readonly seekCooldownTime = 5000;
+	readonly seekCooldownTime = 1000;
+	readonly seekTimeoutTime = 5000;
 	readonly syncMaxBehind: number;
 	readonly syncMaxBehindMultiplierStep = 1;
-	readonly syncMaxBehindIncreaseEvery = 5;
-	readonly syncMaxBehindMaximumAllowed = 1000;
+	readonly syncMaxBehindIncreaseEvery = 3;
+	readonly syncMaxBehindMaximumAllowed = 2000;
 	syncMaxBehindMultiplier: number;
 	readonly syncMaxAhead = 150;
-	readonly playbackRateSyncConstants: {
-		readonly enabled: true;
-		readonly maxBehind: 1000;
-		readonly catchupRate: 1.05;
-		readonly slowdownRate: 0.95;
+	timeshiftSync: {
+		enabled: boolean;
+		maxBehind: number;
+		multiplier: number;
+		maxBehindAllowed: number;
+		overshoot: number;
+		minOvershootAllowed: number;
+		maxOvershootAllowed: number;
 	};
-	readonly maxTimeSyncDifferenceTolerance = 20;
+	readonly maxTimeSyncDifferenceTolerance = 150;
 	private timers;
 	private rtt;
 	private channelSyncInfo;
 	private driftAdjustmentsCount;
-	private playbackRateAdjustmentCount;
+	private timeshiftDriftAdjustmentCount;
 	private timestampOffset?;
 	private currentChannelId?;
 	private highestSeenTimestamps;
@@ -1005,34 +1026,38 @@ declare class SyncModule {
 	suspend: () => void;
 	unsuspend: () => void;
 	activateSyncAdjustments: () => void;
-	static create: (emitter: Emitter<SyncModuleListeners, SyncModuleEvents>, logger: Logger, playbackSource: PlaybackSource, bufferSource: BufferSource, syncMaxBehind: number) => SyncModule;
+	static create: (emitter: Emitter<SyncModuleListeners, SyncModuleEvents>, logger: Logger, playbackSource: PlaybackSource, bufferSource: BufferSource, isTimeshiftSyncEnabled: boolean) => SyncModule;
 	reset: () => void;
 	getTimeshiftOffset: () => number;
 	getCurrentChannelId: () => string | undefined;
 	updateChannelSyncInfo(channelId: string, syncInfo: SyncInfo): void;
+	private tryApplySyncInfo;
 	getLiveEdgeTime: (channelId: string) => number | undefined;
 	getLiveEdgeTimeLatencyAdjusted: (channelId: string) => number | undefined;
 	getWallclockTime: (channelId: string) => number | undefined;
 	getWallclockTimeLatencyAdjusted: (channelId: string) => number | undefined;
 	get serverCurrentTime(): number;
+	get channelCurrentTime(): number;
 	processSample: <T extends SyncSample>(sample: T) => T;
 	getStatistics: () => SyncModuleStatistics;
 	get drift(): number | undefined;
 	private updateRtt;
 	isPlaybackSourceReadyToSeek: () => boolean;
+	private isSeeking;
 	private isAllowedToSync;
 	private isSeekCooldownExpired;
+	private isSeekTimeoutExpired;
+	private currentTimeshiftMaxBehind;
 	private currentSyncMaxBehind;
+	private currentSyncMaxAhead;
+	private tryTimeshiftSync;
 	private onSync;
-	playbackRateSync: (drift: number, playbackRate: number) => [
-		boolean,
-		number
-	];
 }
 declare const defaultOptions: {
 	sizeBasedResolutionCapEnabled: boolean;
 	pictureInPictureEnabled: boolean;
 	abrEnabled: boolean;
+	burstEnabled: boolean;
 	mseEnabled: boolean;
 	mseOpusEnabled: boolean;
 	muted: boolean;
@@ -1118,6 +1143,7 @@ export declare class Vindral extends Emitter<PublicVindralEvents> {
 	get serverEdgeTime(): number | undefined;
 	get serverWallclockTime(): number | undefined;
 	get currentTime(): number;
+	get channelCurrentTime(): number;
 	get targetBufferTime(): number;
 	set targetBufferTime(bufferTimeMs: number);
 	get playbackLatency(): number | undefined;
@@ -1204,6 +1230,7 @@ declare class TelemetryModule {
 	private unsentLines;
 	private retries;
 	private errorCount;
+	private statsCount;
 	private constructor();
 	unload: () => void;
 	static create: (logger: Logger, emitter: Emitter<TelemetryModuleListeners, unknown>, options: TelemetryModuleOptions, statisticsSource: TelemetryStatisticsSource) => TelemetryModule;
@@ -1307,6 +1334,7 @@ export interface Options {
 	maxBufferTime?: number;
 	sizeBasedResolutionCapEnabled?: boolean;
 	pictureInPictureEnabled?: boolean;
+	burstEnabled?: boolean;
 	mseEnabled?: boolean;
 	mseOpusEnabled?: boolean;
 	abrEnabled?: boolean;
@@ -1373,12 +1401,16 @@ interface AudioRenditionProps {
 	channels: number;
 	sampleRate: number;
 }
+interface CodecProps {
+	codec: Codec;
+	codecString?: string;
+}
 export declare type VideoRendition = VideoRenditionProps & RenditionProps;
 export declare type AudioRendition = AudioRenditionProps & RenditionProps;
 export declare type Rendition = VideoRendition | AudioRendition;
 export declare const isVideoRendition: (rendition: Readonly<Rendition>) => rendition is VideoRendition;
 export declare const isAudioRendition: (rendition: Readonly<Rendition>) => rendition is AudioRendition;
-export declare const getMimeType: (rendition: Readonly<Rendition>) => string;
+export declare const getMimeType: (rendition: Readonly<CodecProps>) => string;
 interface AudioConstraint {
 	bitRate: number;
 	codec?: AudioCodec;
@@ -1397,6 +1429,7 @@ interface Subscription {
 	channelId: string;
 	video: VideoConstraint;
 	audio: AudioConstraint;
+	burstMs?: number;
 	meta?: Record<string, string>;
 	initiator?: SubscriptionInitiator;
 }
@@ -1532,6 +1565,7 @@ export declare class CastSender extends Emitter<CastSenderEvents> {
 	init: () => Promise<void>;
 	start: () => Promise<void>;
 	stop: () => void;
+	getReceiverName: () => string | undefined;
 	private onGCastApiAvailable;
 	private send;
 	private onMessage;
@@ -1539,7 +1573,6 @@ export declare class CastSender extends Emitter<CastSenderEvents> {
 	private onSessionStateChanged;
 	private getInstance;
 	private getSession;
-	private getReceiverName;
 	private castLibrariesAdded;
 	private verifyCastLibraries;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vindral/web-sdk",
-  "version": "2.0.13",
+  "version": "2.0.17",
   "homepage": "https://vindral.com",
   "description": "Web SDK for viewing Vindral streams",
   "license": "SEE LICENSE IN https://www.vindral.com/terms-conditions",