stormcloud-video-player 0.8.53 → 0.8.54

package/lib/index.d.cts

@@ -207,6 +207,7 @@ declare class StormcloudVideoPlayer {
     getStreamType(): "hls" | "other";
     shouldShowNativeControls(): boolean;
     isLive(): boolean;
+    isLowLatencyStream(): boolean | undefined;
     get videoElement(): HTMLVideoElement;
     toggleMute(): void;
     toggleFullscreen(): Promise<void>;

package/lib/index.d.ts

@@ -207,6 +207,7 @@ declare class StormcloudVideoPlayer {
     getStreamType(): "hls" | "other";
     shouldShowNativeControls(): boolean;
     isLive(): boolean;
+    isLowLatencyStream(): boolean | undefined;
     get videoElement(): HTMLVideoElement;
     toggleMute(): void;
     toggleFullscreen(): Promise<void>;

package/lib/index.js

@@ -6513,6 +6513,7 @@ var HlsEngine = /*#__PURE__*/ function() {
         this.bufferedSegmentsCount = 0;
         this.shouldAutoplayAfterBuffering = false;
         this.hasInitialBufferCompleted = false;
+        this.latencyProfileApplied = false;
         this.config = config;
         this.video = video;
         this.cueManager = cueManager;
@@ -6581,24 +6582,21 @@ var HlsEngine = /*#__PURE__*/ function() {
             key: "setupHls",
             value: function setupHls() {
                 var _this = this;
-                this.hls = new Hls2(_object_spread_props(_object_spread({
+                this.hls = new Hls2({
                     enableWorker: true,
                     backBufferLength: 30,
                     liveDurationInfinity: true,
                     lowLatencyMode: !!this.config.lowLatencyMode,
-                    maxLiveSyncPlaybackRate: this.config.lowLatencyMode ? 1.5 : 1
-                }, this.config.lowLatencyMode ? {
-                    liveSyncDuration: 2
-                } : {}), {
+                    maxLiveSyncPlaybackRate: 1.1,
                     maxBufferLength: 30,
                     maxMaxBufferLength: 600,
                     maxBufferSize: 60 * 1e3 * 1e3,
-                    maxBufferHole: 0.5,
+                    maxBufferHole: 1,
                     highBufferWatchdogPeriod: 2,
-                    nudgeOffset: 0.1,
-                    nudgeMaxRetry: 3,
+                    nudgeOffset: 0.2,
+                    nudgeMaxRetry: 5,
                     startPosition: -1
-                }));
+                });
                 this.hls.on(Hls2.Events.MEDIA_ATTACHED, function() {
                     var _this_hls;
                     (_this_hls = _this.hls) === null || _this_hls === void 0 ? void 0 : _this_hls.loadSource(_this.config.src);
@@ -6622,6 +6620,8 @@ var HlsEngine = /*#__PURE__*/ function() {
                                     this.bufferedSegmentsCount = 0;
                                     this.hasInitialBufferCompleted = false;
                                     this.shouldAutoplayAfterBuffering = !!this.config.autoplay;
+                                    this.latencyProfileApplied = false;
+                                    this.detectedLowLatencyStream = void 0;
                                     minSegments = (_this_config_minSegmentsBeforePlay = this.config.minSegmentsBeforePlay) !== null && _this_config_minSegmentsBeforePlay !== void 0 ? _this_config_minSegmentsBeforePlay : 2;
                                     if (this.debug) {
                                         console.log("[StormcloudVideoPlayer] Waiting for", minSegments, "segments to buffer before playback");
@@ -6652,6 +6652,7 @@ var HlsEngine = /*#__PURE__*/ function() {
                     }).call(_this);
                 });
                 this.hls.on(Hls2.Events.LEVEL_LOADED, function(_evt, data) {
+                    _this.applyStreamLatencyProfile(data === null || data === void 0 ? void 0 : data.details);
                     if (_this.callbacks.isInAdBreak() || _this.callbacks.hasPendingAdBreak()) {
                         return;
                     }
@@ -6925,6 +6926,70 @@ var HlsEngine = /*#__PURE__*/ function() {
                 this.hls.attachMedia(this.video);
             }
         },
+        {
+            key: "isLowLatencyStream",
+            value: function isLowLatencyStream() {
+                return this.detectedLowLatencyStream;
+            }
+        },
+        {
+            key: "applyStreamLatencyProfile",
+            value: function applyStreamLatencyProfile(details) {
+                if (this.latencyProfileApplied || !this.hls) {
+                    return;
+                }
+                if (!details) {
+                    return;
+                }
+                if (details.live !== true) {
+                    this.latencyProfileApplied = true;
+                    this.detectedLowLatencyStream = false;
+                    return;
+                }
+                var isLowLatencyManifest = this.isLowLatencyManifest(details);
+                var useLowLatency = isLowLatencyManifest && !!this.config.lowLatencyMode;
+                this.detectedLowLatencyStream = useLowLatency;
+                this.latencyProfileApplied = true;
+                var cfg = this.hls.config;
+                if (useLowLatency) {
+                    cfg.maxLiveSyncPlaybackRate = 1.5;
+                    cfg.maxBufferHole = 0.5;
+                    delete cfg.liveSyncDuration;
+                } else {
+                    cfg.maxLiveSyncPlaybackRate = 1.1;
+                    cfg.maxBufferHole = 1;
+                    delete cfg.liveSyncDuration;
+                    cfg.liveSyncDurationCount = 3;
+                }
+                if (this.debug) {
+                    var _details_targetduration;
+                    console.log("[StormcloudVideoPlayer] Live latency profile: ".concat(useLowLatency ? "LL-HLS (low latency)" : "standard live (stability)"), {
+                        isLowLatencyManifest: isLowLatencyManifest,
+                        lowLatencyModeRequested: !!this.config.lowLatencyMode,
+                        canBlockReload: details.canBlockReload,
+                        partTarget: details.partTarget,
+                        partHoldBack: details.partHoldBack,
+                        partListLength: Array.isArray(details.partList) ? details.partList.length : 0,
+                        targetDuration: (_details_targetduration = details.targetduration) !== null && _details_targetduration !== void 0 ? _details_targetduration : details.targetDuration,
+                        maxLiveSyncPlaybackRate: cfg.maxLiveSyncPlaybackRate,
+                        maxBufferHole: cfg.maxBufferHole
+                    });
+                }
+            }
+        },
+        {
+            key: "isLowLatencyManifest",
+            value: function isLowLatencyManifest(details) {
+                if (!details) {
+                    return false;
+                }
+                var hasParts = Array.isArray(details.partList) && details.partList.length > 0;
+                var hasPartTarget = typeof details.partTarget === "number" && details.partTarget > 0;
+                var hasPartHoldBack = typeof details.partHoldBack === "number" && details.partHoldBack > 0;
+                var canBlockReload = details.canBlockReload === true;
+                return hasParts || hasPartTarget || hasPartHoldBack || canBlockReload;
+            }
+        },
         {
             key: "onId3Tag",
             value: function onId3Tag(tag) {
@@ -9412,6 +9477,12 @@ var StormcloudVideoPlayer = /*#__PURE__*/ function() {
                 return this.hlsEngine.isLiveStream;
             }
         },
+        {
+            key: "isLowLatencyStream",
+            value: function isLowLatencyStream() {
+                return this.hlsEngine.isLowLatencyStream();
+            }
+        },
         {
             key: "videoElement",
             get: function get() {