hls.js 1.6.0-beta.2.0.canary.10880 → 1.6.0-beta.2.0.canary.10883

package/dist/hls.d.mts

@@ -571,6 +571,19 @@ export declare type BufferInfo = {
     start: number;
     end: number;
     nextStart?: number;
+    buffered?: BufferTimeRange[];
+};
+
+/**
+ * Provides methods dealing with buffer length retrieval for example.
+ *
+ * In general, a helper around HTML5 MediaElement TimeRanges gathered from `buffered` property.
+ *
+ * Also @see https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/buffered
+ */
+export declare type BufferTimeRange = {
+    start: number;
+    end: number;
 };
 
 export declare class CapLevelController implements ComponentAPI {
@@ -1017,6 +1030,7 @@ export declare interface ErrorData {
     fatal: boolean;
     errorAction?: IErrorAction;
     buffer?: number;
+    bufferInfo?: BufferInfo;
     bytes?: number;
     chunkMeta?: ChunkMetadata;
     context?: PlaylistLoaderContext;
@@ -1027,6 +1041,9 @@ export declare interface ErrorData {
     levelRetry?: boolean;
     loader?: Loader<LoaderContext>;
     networkDetails?: any;
+    stalled?: {
+        start: number;
+    };
     stats?: LoaderStats;
     mimeType?: string;
     reason?: string;
@@ -1110,6 +1127,7 @@ export declare enum Events {
     MEDIA_DETACHING = "hlsMediaDetaching",
     MEDIA_DETACHED = "hlsMediaDetached",
     MEDIA_ENDED = "hlsMediaEnded",
+    STALL_RESOLVED = "hlsStallResolved",
     BUFFER_RESET = "hlsBufferReset",
     BUFFER_CODECS = "hlsBufferCodecs",
     BUFFER_CREATED = "hlsBufferCreated",
@@ -1948,6 +1966,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;
 
 export declare interface HlsEventEmitter {
@@ -1969,6 +1988,7 @@ export declare interface HlsListeners {
     [Events.MEDIA_DETACHING]: (event: Events.MEDIA_DETACHING, data: MediaDetachingData) => void;
     [Events.MEDIA_DETACHED]: (event: Events.MEDIA_DETACHED, data: MediaDetachedData) => void;
     [Events.MEDIA_ENDED]: (event: Events.MEDIA_ENDED, data: MediaEndedData) => void;
+    [Events.STALL_RESOLVED]: (event: Events.STALL_RESOLVED, data: {}) => void;
     [Events.BUFFER_RESET]: (event: Events.BUFFER_RESET) => void;
     [Events.BUFFER_CODECS]: (event: Events.BUFFER_CODECS, data: BufferCodecsData) => void;
     [Events.BUFFER_CREATED]: (event: Events.BUFFER_CREATED, data: BufferCreatedData) => void;
@@ -3340,6 +3360,7 @@ 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;

package/dist/hls.d.ts

@@ -571,6 +571,19 @@ export declare type BufferInfo = {
     start: number;
     end: number;
     nextStart?: number;
+    buffered?: BufferTimeRange[];
+};
+
+/**
+ * Provides methods dealing with buffer length retrieval for example.
+ *
+ * In general, a helper around HTML5 MediaElement TimeRanges gathered from `buffered` property.
+ *
+ * Also @see https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/buffered
+ */
+export declare type BufferTimeRange = {
+    start: number;
+    end: number;
 };
 
 export declare class CapLevelController implements ComponentAPI {
@@ -1017,6 +1030,7 @@ export declare interface ErrorData {
     fatal: boolean;
     errorAction?: IErrorAction;
     buffer?: number;
+    bufferInfo?: BufferInfo;
     bytes?: number;
     chunkMeta?: ChunkMetadata;
     context?: PlaylistLoaderContext;
@@ -1027,6 +1041,9 @@ export declare interface ErrorData {
     levelRetry?: boolean;
     loader?: Loader<LoaderContext>;
     networkDetails?: any;
+    stalled?: {
+        start: number;
+    };
     stats?: LoaderStats;
     mimeType?: string;
     reason?: string;
@@ -1110,6 +1127,7 @@ export declare enum Events {
     MEDIA_DETACHING = "hlsMediaDetaching",
     MEDIA_DETACHED = "hlsMediaDetached",
     MEDIA_ENDED = "hlsMediaEnded",
+    STALL_RESOLVED = "hlsStallResolved",
     BUFFER_RESET = "hlsBufferReset",
     BUFFER_CODECS = "hlsBufferCodecs",
     BUFFER_CREATED = "hlsBufferCreated",
@@ -1948,6 +1966,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;
 
 export declare interface HlsEventEmitter {
@@ -1969,6 +1988,7 @@ export declare interface HlsListeners {
     [Events.MEDIA_DETACHING]: (event: Events.MEDIA_DETACHING, data: MediaDetachingData) => void;
     [Events.MEDIA_DETACHED]: (event: Events.MEDIA_DETACHED, data: MediaDetachedData) => void;
     [Events.MEDIA_ENDED]: (event: Events.MEDIA_ENDED, data: MediaEndedData) => void;
+    [Events.STALL_RESOLVED]: (event: Events.STALL_RESOLVED, data: {}) => void;
     [Events.BUFFER_RESET]: (event: Events.BUFFER_RESET) => void;
     [Events.BUFFER_CODECS]: (event: Events.BUFFER_CODECS, data: BufferCodecsData) => void;
     [Events.BUFFER_CREATED]: (event: Events.BUFFER_CREATED, data: BufferCreatedData) => void;
@@ -3340,6 +3360,7 @@ 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;