stormcloud-video-player 0.8.52 → 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

@@ -1079,7 +1079,7 @@ function createHlsAdPlayer(contentVideo, options) {
     }
     function fetchAndParsePod(vastTagUrl) {
         return _async_to_generator(function() {
-            var vastXml, parser, xmlDoc, adElements, ads, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, adElement, parsed, resolved, error, err;
+            var vastXml, trimmedXml, parser, xmlDoc, adElements, ads, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, adElement, parsed, resolved, error, err;
             return _ts_generator(this, function(_state) {
                 switch(_state.label){
                     case 0:
@@ -1089,11 +1089,19 @@ function createHlsAdPlayer(contentVideo, options) {
                         ];
                     case 1:
                         vastXml = _state.sent();
-                        console.log("[HlsAdPlayer] Pod VAST XML received");
+                        console.log("[HlsAdPlayer] Pod VAST XML received (length=".concat(vastXml.length, ")"));
+                        trimmedXml = vastXml.trim();
+                        if (trimmedXml.length === 0) {
+                            console.warn("[HlsAdPlayer] Pod VAST response body is empty (no fill)");
+                            return [
+                                2,
+                                []
+                            ];
+                        }
                         parser = new DOMParser();
                         xmlDoc = parser.parseFromString(vastXml, "text/xml");
                         if (xmlDoc.querySelector("parsererror")) {
-                            console.error("[HlsAdPlayer] Pod VAST XML parsing error (malformed)");
+                            console.error("[HlsAdPlayer] Pod VAST XML parsing error (malformed). Content (first 2000 chars):", vastXml.substring(0, 2e3));
                             return [
                                 2,
                                 []
@@ -1101,7 +1109,7 @@ function createHlsAdPlayer(contentVideo, options) {
                         }
                         adElements = Array.from(xmlDoc.querySelectorAll("Ad"));
                         if (adElements.length === 0) {
-                            console.warn("[HlsAdPlayer] No <Ad> elements found in pod VAST response");
+                            console.warn("[HlsAdPlayer] No <Ad> elements found in pod VAST response (no fill). Content (first 2000 chars):", vastXml.substring(0, 2e3));
                             return [
                                 2,
                                 []
@@ -6505,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;
@@ -6573,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);
@@ -6614,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");
@@ -6644,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;
                     }
@@ -6917,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) {
@@ -9404,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() {