hls.js 1.6.0-beta.2.0.canary.10924 → 1.6.0-beta.2.0.canary.10926

package/dist/hls.js.d.ts

@@ -283,7 +283,7 @@ export declare class BaseStreamController extends TaskLoop implements NetworkCom
     protected fragCurrent: Fragment | null;
     protected fragmentTracker: FragmentTracker;
     protected transmuxer: TransmuxerInterface | null;
-    protected _state: string;
+    protected _state: (typeof State)[keyof typeof State];
     protected playlistType: PlaylistLevelType;
     protected media: HTMLMediaElement | null;
     protected mediaBuffer: Bufferable | null;
@@ -315,6 +315,7 @@ export declare class BaseStreamController extends TaskLoop implements NetworkCom
     get bufferingEnabled(): boolean;
     pauseBuffering(): void;
     resumeBuffering(): void;
+    get inFlightFrag(): InFlightData;
     protected _streamEnded(bufferInfo: BufferInfo, levelDetails: LevelDetails): boolean;
     getLevelDetails(): LevelDetails | undefined;
     protected onMediaAttached(event: Events.MEDIA_ATTACHED, data: MediaAttachedData): void;
@@ -323,7 +324,6 @@ export declare class BaseStreamController extends TaskLoop implements NetworkCom
     protected onError(event: Events.ERROR, data: ErrorData): void;
     protected onMediaSeeking: () => void;
     protected onMediaEnded: () => void;
-    protected triggerEnded(): void;
     protected onManifestLoaded(event: Events.MANIFEST_LOADED, data: ManifestLoadedData): void;
     protected onHandlerDestroying(): void;
     protected onHandlerDestroyed(): void;
@@ -384,8 +384,8 @@ export declare class BaseStreamController extends TaskLoop implements NetworkCom
     private treatAsGap;
     protected resetTransmuxer(): void;
     protected recoverWorkerError(data: ErrorData): void;
-    set state(nextState: string);
-    get state(): string;
+    set state(nextState: (typeof State)[keyof typeof State]);
+    get state(): (typeof State)[keyof typeof State];
 }
 
 export declare interface BaseTrack {
@@ -439,8 +439,8 @@ export declare class BufferController extends Logger implements ComponentAPI {
     private _objectUrl;
     private operationQueue;
     private bufferCodecEventsTotal;
-    media: HTMLMediaElement | null;
-    mediaSource: MediaSource | null;
+    private media;
+    private mediaSource;
     private lastMpegAudioChunk;
     private blockedAudioAppend;
     private lastVideoAppendEnd;
@@ -453,36 +453,36 @@ export declare class BufferController extends Logger implements ComponentAPI {
     constructor(hls: Hls, fragmentTracker: FragmentTracker);
     hasSourceTypes(): boolean;
     destroy(): void;
-    protected registerListeners(): void;
-    protected unregisterListeners(): void;
+    private registerListeners;
+    private unregisterListeners;
     transferMedia(): AttachMediaSourceData | null;
     private initTracks;
     private onManifestLoading;
-    protected onManifestParsed(event: Events.MANIFEST_PARSED, data: ManifestParsedData): void;
-    protected onMediaAttaching(event: Events.MEDIA_ATTACHING, data: MediaAttachingData): void;
+    private onManifestParsed;
+    private onMediaAttaching;
     private assignMediaSource;
     private attachTransferred;
     private get mediaSourceOpenOrEnded();
     private _onEndStreaming;
     private _onStartStreaming;
-    protected onMediaDetaching(event: Events.MEDIA_DETACHING, data: MediaDetachingData): void;
-    protected onBufferReset(): void;
+    private onMediaDetaching;
+    private onBufferReset;
     private resetBuffer;
     private removeBuffer;
     private resetQueue;
-    protected onBufferCodecs(event: Events.BUFFER_CODECS, data: BufferCodecsData): void;
+    private onBufferCodecs;
     get sourceBufferTracks(): BaseTrackSet;
-    protected appendChangeType(type: SourceBufferName, container: string, codec: string): void;
+    private appendChangeType;
     private blockAudio;
     private unblockAudio;
-    protected onBufferAppending(event: Events.BUFFER_APPENDING, eventData: BufferAppendingData): void;
+    private onBufferAppending;
     private getFlushOp;
-    protected onBufferFlushing(event: Events.BUFFER_FLUSHING, data: BufferFlushingData): void;
-    protected onFragParsed(event: Events.FRAG_PARSED, data: FragParsedData): void;
+    private onBufferFlushing;
+    private onFragParsed;
     private onFragChanged;
     get bufferedToEnd(): boolean;
-    protected onBufferEos(event: Events.BUFFER_EOS, data: BufferEOSData): void;
-    protected onLevelUpdated(event: Events.LEVEL_UPDATED, { details }: LevelUpdatedData): void;
+    private onBufferEos;
+    private onLevelUpdated;
     private updateDuration;
     private onError;
     private resetAppendErrors;
@@ -497,7 +497,7 @@ export declare class BufferController extends Logger implements ComponentAPI {
     private getDurationAndRange;
     private updateMediaSource;
     private get tracksReady();
-    protected checkPendingTracks(): void;
+    private checkPendingTracks;
     private bufferCreated;
     private createSourceBuffers;
     private getTrackCodec;
@@ -572,6 +572,7 @@ export declare type BufferInfo = {
     end: number;
     nextStart?: number;
     buffered?: BufferTimeRange[];
+    bufferedIndex: number;
 };
 
 /**
@@ -1448,7 +1449,7 @@ export declare class FragmentTracker implements ComponentAPI {
     /**
      * Gets the partial fragment for a certain time
      */
-    getPartialFragment(time: number): Fragment | null;
+    getPartialFragment(time: number): MediaFragment | null;
     isEndListAppended(type: PlaylistLevelType): boolean;
     getState(fragment: Fragment): FragmentState;
     private isTimeBuffered;
@@ -1486,6 +1487,14 @@ export declare interface FragParsingUserdataData {
     samples: UserdataSample[];
 }
 
+export declare type GapControllerConfig = {
+    detectStallWithCurrentTimeMs: number;
+    highBufferWatchdogPeriod: number;
+    nudgeOffset: number;
+    nudgeMaxRetry: number;
+    nudgeOnVideoHole: boolean;
+};
+
 export declare type HdcpLevel = (typeof HdcpLevels)[number];
 
 export declare const HdcpLevels: readonly ["NONE", "TYPE-0", "TYPE-1", null];
@@ -1519,9 +1528,12 @@ declare class Hls implements HlsEventEmitter {
     private latencyController;
     private levelController;
     private streamController;
+    private audioStreamController?;
+    private subtititleStreamController?;
     private audioTrackController?;
     private subtitleTrackController?;
     private interstitialsController?;
+    private gapController;
     private emeController?;
     private cmcdController?;
     private _media;
@@ -1632,6 +1644,7 @@ declare class Hls implements HlsEventEmitter {
      * This allows for media buffering to be paused without interupting playlist loading.
      */
     pauseBuffering(): void;
+    get inFlightFragments(): InFlightFragments;
     /**
      * Swap through possible audio codecs in the stream (for example to switch from stereo to 5.1)
      */
@@ -1652,7 +1665,14 @@ declare class Hls implements HlsEventEmitter {
      * @returns an array of levels (variants) sorted by HDCP-LEVEL, RESOLUTION (height), FRAME-RATE, CODECS, VIDEO-RANGE, and BANDWIDTH
      */
     get levels(): Level[];
+    /**
+     * @returns LevelDetails of last loaded level (variant) or `null` prior to loading a media playlist.
+     */
     get latestLevelDetails(): LevelDetails | null;
+    /**
+     * @returns Level object of selected level (variant) or `null` prior to selecting a level or once the level is removed.
+     */
+    get loadLevelObj(): Level | null;
     /**
      * Index of quality level (variant) currently played
      */
@@ -1967,8 +1987,7 @@ export declare type HlsConfig = {
     progressive: boolean;
     lowLatencyMode: boolean;
     primarySessionId?: string;
-    detectStallWithCurrentTimeMs: number;
-} & ABRControllerConfig & BufferControllerConfig & CapLevelControllerConfig & EMEControllerConfig & FPSControllerConfig & LevelControllerConfig & MP4RemuxerConfig & StreamControllerConfig & SelectionPreferences & LatencyControllerConfig & MetadataControllerConfig & TimelineControllerConfig & TSDemuxerConfig & HlsLoadPolicies & FragmentLoaderConfig & PlaylistLoaderConfig;
+} & ABRControllerConfig & BufferControllerConfig & CapLevelControllerConfig & EMEControllerConfig & FPSControllerConfig & GapControllerConfig & LevelControllerConfig & MP4RemuxerConfig & StreamControllerConfig & SelectionPreferences & LatencyControllerConfig & MetadataControllerConfig & TimelineControllerConfig & TSDemuxerConfig & HlsLoadPolicies & FragmentLoaderConfig & PlaylistLoaderConfig;
 
 export declare interface HlsEventEmitter {
     on<E extends keyof HlsListeners, Context = undefined>(event: E, listener: HlsListeners[E], context?: Context): void;
@@ -2116,6 +2135,17 @@ export declare interface ILogger {
     error: ILogFunction;
 }
 
+export declare type InFlightData = {
+    frag: Fragment | null;
+    state: (typeof State)[keyof typeof State];
+};
+
+export declare type InFlightFragments = {
+    [PlaylistLevelType.MAIN]: InFlightData;
+    [PlaylistLevelType.AUDIO]?: InFlightData;
+    [PlaylistLevelType.SUBTITLE]?: InFlightData;
+};
+
 export declare interface InitPTSFoundData {
     id: PlaylistLevelType;
     frag: MediaFragment;
@@ -3309,6 +3339,21 @@ export declare interface SourceBufferTrack extends BaseTrack {
 
 export declare type SourceBufferTrackSet = Partial<Record<SourceBufferName, SourceBufferTrack>>;
 
+export declare const State: {
+    STOPPED: string;
+    IDLE: string;
+    KEY_LOADING: string;
+    FRAG_LOADING: string;
+    FRAG_LOADING_WAITING_RETRY: string;
+    WAITING_TRACK: string;
+    PARSING: string;
+    PARSED: string;
+    ENDED: string;
+    ERROR: string;
+    WAITING_INIT_PTS: string;
+    WAITING_LEVEL: string;
+};
+
 export declare type SteeringManifest = {
     VERSION: 1;
     TTL: number;
@@ -3324,7 +3369,6 @@ export declare interface SteeringManifestLoadedData {
 
 export declare class StreamController extends BaseStreamController implements NetworkComponentAPI {
     private audioCodecSwap;
-    private gapController;
     private level;
     private _forceStartLoad;
     private _hasEnoughToStart;
@@ -3360,10 +3404,8 @@ export declare class StreamController extends BaseStreamController implements Ne
     protected flushMainBuffer(startOffset: number, endOffset: number): void;
     protected onMediaAttached(event: Events.MEDIA_ATTACHED, data: MediaAttachedData): void;
     protected onMediaDetaching(event: Events.MEDIA_DETACHING, data: MediaDetachingData): void;
-    private onMediaWaiting;
     private onMediaPlaying;
     private onMediaSeeked;
-    protected triggerEnded(): void;
     protected onManifestLoading(): void;
     private onManifestParsed;
     private onLevelLoading;
@@ -3376,7 +3418,6 @@ export declare class StreamController extends BaseStreamController implements Ne
     private onFragBuffered;
     get hasEnoughToStart(): boolean;
     protected onError(event: Events.ERROR, data: ErrorData): void;
-    private checkBuffer;
     private onFragLoadEmergencyAborted;
     private onBufferFlushed;
     private onLevelsUpdated;
@@ -3409,9 +3450,6 @@ export declare type StreamControllerConfig = {
     maxBufferLength: number;
     maxBufferSize: number;
     maxBufferHole: number;
-    highBufferWatchdogPeriod: number;
-    nudgeOffset: number;
-    nudgeMaxRetry: number;
     maxFragLookUpTolerance: number;
     maxMaxBufferLength: number;
     startFragPrefetch: boolean;