stormcloud-video-player 0.8.48 → 0.8.50

package/lib/index.cjs

@@ -601,6 +601,7 @@ function createHlsAdPlayer(contentVideo, options) {
     var mainHlsInstance = options === null || options === void 0 ? void 0 : options.mainHlsInstance;
     var AD_CONTAINER_PROP = "__stormcloudAdContainer";
     var AD_VIDEO_PROP = "__stormcloudAdVideo";
+    var FRAME_COUNTER_RELIABLE_PROP = "__stormcloudFrameCounterReliable";
     var adVideoElement = (_contentVideo_AD_VIDEO_PROP = contentVideo[AD_VIDEO_PROP]) !== null && _contentVideo_AD_VIDEO_PROP !== void 0 ? _contentVideo_AD_VIDEO_PROP : void 0;
     var adHls;
     var adContainerEl = (_contentVideo_AD_CONTAINER_PROP = contentVideo[AD_CONTAINER_PROP]) !== null && _contentVideo_AD_CONTAINER_PROP !== void 0 ? _contentVideo_AD_CONTAINER_PROP : void 0;
@@ -615,9 +616,12 @@ function createHlsAdPlayer(contentVideo, options) {
     var pendingTimeouts = [];
     var STALL_TIMEOUT_MS = 4e3;
     var STALL_CHECK_INTERVAL_MS = 1e3;
+    var BLACKFRAME_MIN_PLAYBACK_S = 1.5;
     var stallWatchdogId;
     var lastAdProgressTime = 0;
     var lastAdProgressPosition = 0;
+    var sawDecodedVideoFrame = false;
+    var videoFrameCallbackHandle;
     var trackingFired = {
         impression: false,
         start: false,
@@ -798,6 +802,11 @@ function createHlsAdPlayer(contentVideo, options) {
                 console.warn("[HlsAdPlayer] MediaFile ".concat(index, ' skipped (audio-only, type="').concat(type, '") — audio ads are not played to avoid a black screen'));
                 return;
             }
+            var hasExplicitDimensions = mf.getAttribute("width") != null && mf.getAttribute("height") != null;
+            if (!isHlsMediaFile(mediaFile) && hasExplicitDimensions && (mediaFile.width <= 1 || mediaFile.height <= 1)) {
+                console.warn("[HlsAdPlayer] MediaFile ".concat(index, " skipped (degenerate dimensions ").concat(mediaFile.width, "x").concat(mediaFile.height, ', type="').concat(type, '") — likely an audio-only placeholder rendition'));
+                return;
+            }
             if (isHlsMediaFile(mediaFile) || isProgressiveMediaFile(mediaFile)) {
                 mediaFiles.push(mediaFile);
                 if (verbose) {
@@ -1265,6 +1274,14 @@ function createHlsAdPlayer(contentVideo, options) {
                 fireTrackingPixels(currentAd.trackingUrls.thirdQuartile);
             }
         };
+        var onLoadedMetadata = function onLoadedMetadata() {
+            if (!adPlaying || !adVideoElement) return;
+            var videoWidth = adVideoElement.videoWidth, videoHeight = adVideoElement.videoHeight;
+            if (videoWidth <= 1 || videoHeight <= 1) {
+                console.warn("[HlsAdPlayer] Ad creative has no usable video dimensions (".concat(videoWidth, "x").concat(videoHeight, ") - skipping this creative"));
+                handleVideoDecodeFailure();
+            }
+        };
         var onPlaying = function onPlaying() {
             startStallWatchdog();
             if (!currentAd || trackingFired.start) return;
@@ -1316,6 +1333,10 @@ function createHlsAdPlayer(contentVideo, options) {
                 type: "timeupdate",
                 handler: onTimeUpdate
             },
+            {
+                type: "loadedmetadata",
+                handler: onLoadedMetadata
+            },
             {
                 type: "playing",
                 handler: onPlaying
@@ -1487,6 +1508,7 @@ function createHlsAdPlayer(contentVideo, options) {
             clearInterval(stallWatchdogId);
             stallWatchdogId = void 0;
         }
+        cancelVideoFrameProbe();
     }
     function noteAdProgress() {
         lastAdProgressTime = Date.now();
@@ -1505,13 +1527,86 @@ function createHlsAdPlayer(contentVideo, options) {
         }
         handleAdError();
     }
+    function getDecodedVideoFrameCount(video) {
+        try {
+            if (typeof video.getVideoPlaybackQuality === "function") {
+                var quality = video.getVideoPlaybackQuality();
+                if (quality && typeof quality.totalVideoFrames === "number") {
+                    return quality.totalVideoFrames;
+                }
+            }
+            var legacyCount = video.webkitDecodedFrameCount;
+            if (typeof legacyCount === "number") {
+                return legacyCount;
+            }
+        } catch (error) {
+            console.warn("[HlsAdPlayer] Unable to read decoded video frame count:", error);
+        }
+        return void 0;
+    }
+    function isFrameCounterReliable() {
+        return contentVideo[FRAME_COUNTER_RELIABLE_PROP] === true;
+    }
+    function markFrameCounterReliable() {
+        contentVideo[FRAME_COUNTER_RELIABLE_PROP] = true;
+    }
+    function cancelVideoFrameProbe() {
+        if (videoFrameCallbackHandle != null && adVideoElement && typeof adVideoElement.cancelVideoFrameCallback === "function") {
+            try {
+                adVideoElement.cancelVideoFrameCallback(videoFrameCallbackHandle);
+            } catch (error) {
+                console.warn("[HlsAdPlayer] Error cancelling video frame callback:", error);
+            }
+        }
+        videoFrameCallbackHandle = void 0;
+    }
+    function startVideoFrameProbe() {
+        cancelVideoFrameProbe();
+        if (!adVideoElement) return;
+        var rvfc = adVideoElement.requestVideoFrameCallback;
+        if (typeof rvfc !== "function") return;
+        var onPresentedFrame = function onPresentedFrame() {
+            videoFrameCallbackHandle = void 0;
+            if (!adPlaying) return;
+            sawDecodedVideoFrame = true;
+        };
+        try {
+            videoFrameCallbackHandle = rvfc.call(adVideoElement, onPresentedFrame);
+        } catch (error) {
+            console.warn("[HlsAdPlayer] Error requesting video frame callback:", error);
+            videoFrameCallbackHandle = void 0;
+        }
+    }
+    function handleVideoDecodeFailure() {
+        console.warn("[HlsAdPlayer] Ad audio is advancing but no video frames decoded (black screen) - skipping this creative");
+        clearStallWatchdog();
+        if (currentAd) {
+            fireTrackingPixels(currentAd.trackingUrls.error);
+        }
+        if (podIndex < podAds.length - 1 && advanceToNextPodAd()) {
+            return;
+        }
+        handleAdError();
+    }
     function startStallWatchdog() {
         clearStallWatchdog();
         noteAdProgress();
+        sawDecodedVideoFrame = false;
+        startVideoFrameProbe();
         stallWatchdogId = window.setInterval(function() {
             if (!adPlaying || !adVideoElement) {
                 return;
             }
+            if (!sawDecodedVideoFrame && !adVideoElement.paused) {
+                var decodedFrames = getDecodedVideoFrameCount(adVideoElement);
+                if (decodedFrames !== void 0 && decodedFrames > 0) {
+                    sawDecodedVideoFrame = true;
+                    markFrameCounterReliable();
+                } else if (decodedFrames === 0 && adVideoElement.currentTime >= BLACKFRAME_MIN_PLAYBACK_S && isFrameCounterReliable()) {
+                    handleVideoDecodeFailure();
+                    return;
+                }
+            }
             if (adVideoElement.currentTime > lastAdProgressPosition + 0.05) {
                 noteAdProgress();
                 return;
@@ -6396,17 +6491,17 @@ var AdTimingService = /*#__PURE__*/ function() {
         {
             key: "logAdState",
             value: function logAdState(event) {
-                var extra = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {}, adPlayer = arguments.length > 2 ? arguments[2] : void 0, inAdBreak = arguments.length > 3 ? arguments[3] : void 0, showAds = arguments.length > 4 ? arguments[4] : void 0;
-                var _ref;
+                var extra = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {};
                 if (!this.debug) {
                     return;
                 }
+                var _this_callbacks_getAdState = this.callbacks.getAdState(), inAdBreak = _this_callbacks_getAdState.inAdBreak, showAds = _this_callbacks_getAdState.showAds, adPlaying = _this_callbacks_getAdState.adPlaying;
                 console.log("[StormcloudVideoPlayer][AdState]", _object_spread({
                     event: event,
                     timestamp: /* @__PURE__ */ new Date().toISOString(),
-                    showAds: showAds !== null && showAds !== void 0 ? showAds : false,
-                    adPlaying: (_ref = adPlayer === null || adPlayer === void 0 ? void 0 : adPlayer.isAdPlaying()) !== null && _ref !== void 0 ? _ref : false,
-                    inAdBreak: inAdBreak !== null && inAdBreak !== void 0 ? inAdBreak : false,
+                    showAds: showAds,
+                    adPlaying: adPlaying,
+                    inAdBreak: inAdBreak,
                     activeAdRequestToken: this.activeAdRequestToken
                 }, extra));
             }
@@ -8756,6 +8851,13 @@ var StormcloudVideoPlayer = /*#__PURE__*/ function() {
             },
             onFailsafeTimeout: function onFailsafeTimeout() {
                 return _this.adBreak.handleAdFailure();
+            },
+            getAdState: function getAdState() {
+                return {
+                    inAdBreak: _this.adBreak.inAdBreak,
+                    showAds: _this.adBreak.showAds,
+                    adPlaying: _this.adPlayer.isAdPlaying()
+                };
             }
         });
         this.placeholder = new PlaceholderLayer(this.video, !!this.config.debugAdTiming);