@arcware-cloud/pixelstreaming-websdk 1.3.8 → 1.3.10

package/README.md

@@ -80,6 +80,10 @@ For more detailed examples and advanced usage, please refer to our documentation
 
 # Changelog
 
+### 1.3.9
+
+- added an event handler to check if video is streaming if cloud requests evidence
+
 ### 1.3.8
 
 - fixed error handling in SDK to back of reconnects if connection was intentionally terminated by cloud

package/index.cjs.js

@@ -23420,7 +23420,7 @@ class ArcwareConfig extends lib_pixelstreamingfrontend_ue5_5_1.Config {
         if (!config.initialSettings.ss)
             config.initialSettings.ss = exports.DefaultUrl;
         super(config);
-        this.VERSION = "1.3.8";
+        this.VERSION = "1.3.10";
         this.settings = settings;
         this.session = new Session_1.Session();
         this._initialSettings = config.initialSettings;
@@ -23536,7 +23536,7 @@ function ArcwareInit({ shareId, projectId }, configuration, forceRefresh = false
         useUrlParams: (configuration === null || configuration === void 0 ? void 0 : configuration.useUrlParams) === true,
         initialSettings: Object.assign({ ss: ArcwareConfig_1.DefaultUrl, AutoConnect: false, StartVideoMuted: true, AutoPlayVideo: true, KeyboardInput: true, MouseInput: true, GamepadInput: true, TouchInput: true, XRControllerInput: true, UseMic: true, SuppressBrowserKeys: true, FakeMouseWithTouches: false, ForceMonoAudio: false, HoveringMouse: true }, configuration === null || configuration === void 0 ? void 0 : configuration.initialSettings),
         settings: Object.assign({ shareId,
-            projectId, fullscreenButton: true, audioButton: true, stopButton: false, infoButton: false, micButton: false, settingsButton: false, connectionStrengthIcon: false, connectionIdentifierLoggingDisabled: undefined, errorHandler: undefined, loveLetterHandler: undefined, loveLetterLogging: undefined, queueHandler: undefined, sessionIdHandler: undefined, startHeight: undefined, startWidth: undefined }, configuration === null || configuration === void 0 ? void 0 : configuration.settings)
+            projectId, fullscreenButton: true, audioButton: true, stopButton: false, infoButton: false, micButton: false, settingsButton: false, connectionStrengthIcon: false, connectionIdentifierLoggingDisabled: undefined, errorHandler: undefined, loveLetterHandler: undefined, loveLetterLogging: undefined, queueHandler: undefined, sessionIdHandler: undefined, startHeight: undefined, startWidth: undefined, orientationZoom: undefined }, configuration === null || configuration === void 0 ? void 0 : configuration.settings)
     });
     const PixelStreaming = new ArcwarePixelStreaming_1.ArcwarePixelStreaming(Config);
     const Application = new ArcwareApplication_1.ArcwareApplication({ stream: PixelStreaming });
@@ -23573,6 +23573,7 @@ const ArcwareLogoLoader_1 = __webpack_require__(6469);
 const MicrophoneOverlay_1 = __webpack_require__(3613);
 const ConnectionIdentifier_1 = __webpack_require__(5999);
 const DiagnosticsCollector_1 = __webpack_require__(8429);
+const common_1 = __webpack_require__(2483);
 class ArcwarePixelStreaming extends lib_pixelstreamingfrontend_ue5_5_1.PixelStreaming {
     resetInitGuardsAndHooks() {
         this.videoInitializedSent = false;
@@ -23725,6 +23726,7 @@ class ArcwarePixelStreaming extends lib_pixelstreamingfrontend_ue5_5_1.PixelStre
         this.addMessageHandler("ping", shared_pixelstreaming_websdk_1.Messages.ZPing, this.onPing);
         this.addMessageHandler("queue", shared_pixelstreaming_websdk_1.Messages.ZQueue, this.onQueue);
         this.addMessageHandler("version", shared_pixelstreaming_websdk_1.Messages.ZVersion, this.onVersion);
+        this.addMessageHandler("render", shared_pixelstreaming_websdk_1.Messages.ZRender, this.onRender);
         // Create a debounced version of the handleResolutionChange function
         const debouncedResolutionChange = (0, debounce_1.default)(() => {
             this.handleResolutionChange();
@@ -23791,6 +23793,64 @@ class ArcwarePixelStreaming extends lib_pixelstreamingfrontend_ue5_5_1.PixelStre
             }
         });
     }
+    isVideoRenderingNow(video) {
+        if (!video)
+            return false;
+        const hasDims = video.videoWidth > 0 && video.videoHeight > 0;
+        const hasData = video.readyState >= HTMLMediaElement.HAVE_CURRENT_DATA; // ≥2
+        const playing = !video.paused && !video.ended;
+        // Be conservative: require at least two signals to avoid metadata-only false positives
+        return (hasDims && hasData) || (hasDims && playing) || (hasData && playing);
+    }
+    waitForFirstFrameWithTimeout(ms = 2000) {
+        var _a, _b, _c;
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const video = (_c = (_b = (_a = this.webRtcController) === null || _a === void 0 ? void 0 : _a.videoPlayer) === null || _b === void 0 ? void 0 : _b.getVideoElement) === null || _c === void 0 ? void 0 : _c.call(_b);
+            if (this.isVideoRenderingNow(video))
+                return true;
+            let t;
+            const ok = yield Promise.race([
+                new Promise((resolve) => {
+                    var _a, _b;
+                    const done = () => {
+                        cleanup();
+                        resolve(true);
+                    };
+                    const cleanup = () => {
+                        var _a, _b;
+                        video.removeEventListener("playing", onPlaying);
+                        video.removeEventListener("resize", onResize);
+                        if ("cancelVideoFrameCallback" in HTMLVideoElement.prototype && rvfcId != null) {
+                            (_b = (_a = video).cancelVideoFrameCallback) === null || _b === void 0 ? void 0 : _b.call(_a, rvfcId);
+                        }
+                    };
+                    const onPlaying = () => this.isVideoRenderingNow(video) && done();
+                    const onResize = () => this.isVideoRenderingNow(video) && done();
+                    video.addEventListener("playing", onPlaying, { once: true });
+                    video.addEventListener("resize", onResize, { once: true });
+                    const rvfcId = "requestVideoFrameCallback" in HTMLVideoElement.prototype
+                        ? (_b = (_a = video).requestVideoFrameCallback) === null || _b === void 0 ? void 0 : _b.call(_a, () => done())
+                        : null;
+                }),
+                new Promise((resolve) => {
+                    t = window.setTimeout(() => resolve(false), ms);
+                })
+            ]);
+            if (t)
+                clearTimeout(t);
+            return ok;
+        });
+    }
+    onRender(_msg) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const isRendering = yield this.waitForFirstFrameWithTimeout();
+            const payload = {
+                type: "render",
+                isRendering: isRendering
+            };
+            this.send(payload); // uses buffered send
+        });
+    }
     /** On ping the session creation timestamp will be updated. */
     onPing(message) {
         var _a, _b;
@@ -24043,15 +24103,16 @@ class ArcwarePixelStreaming extends lib_pixelstreamingfrontend_ue5_5_1.PixelStre
         }
     }
     handleResolutionChange() {
-        var _a, _b, _c, _d, _e, _f, _g;
+        var _a, _b, _c, _d, _e, _f, _g, _h;
         if (!(this === null || this === void 0 ? void 0 : this.streamInfo) || !(this === null || this === void 0 ? void 0 : this.webRtcController) || !((_b = (_a = this === null || this === void 0 ? void 0 : this.webRtcController) === null || _a === void 0 ? void 0 : _a.videoPlayer) === null || _b === void 0 ? void 0 : _b.getVideoElement())) {
             return;
         }
         const resolution = (_d = (_c = this === null || this === void 0 ? void 0 : this.streamInfo) === null || _c === void 0 ? void 0 : _c.streamInfo) === null || _d === void 0 ? void 0 : _d.resolution;
         const unrealVersion = (_g = (_f = (_e = this === null || this === void 0 ? void 0 : this.streamInfo) === null || _e === void 0 ? void 0 : _e.streamInfo) === null || _f === void 0 ? void 0 : _f.meta) === null || _g === void 0 ? void 0 : _g.version;
+        const orientationZoom = (_h = this.config.settings) === null || _h === void 0 ? void 0 : _h.orientationZoom;
         if (resolution && (resolution === null || resolution === void 0 ? void 0 : resolution.dynamic)) {
             setTimeout(() => {
-                var _a;
+                var _a, _b, _c;
                 const { videoPlayer } = this === null || this === void 0 ? void 0 : this.webRtcController;
                 const videoElementParent = videoPlayer === null || videoPlayer === void 0 ? void 0 : videoPlayer.getVideoParentElement();
                 const browserWidth = videoElementParent === null || videoElementParent === void 0 ? void 0 : videoElementParent.getBoundingClientRect().width;
@@ -24068,10 +24129,32 @@ class ArcwarePixelStreaming extends lib_pixelstreamingfrontend_ue5_5_1.PixelStre
                     limitedHeight = maxHeight;
                     limitedWidth = maxHeight * aspectRatio;
                 }
+                // width: clientWidth * Math.max(window.devicePixelRatio, 1)  - for retina device, 1 is min upscale factor
+                const newRes = (0, common_1.capScale)({
+                    width: browserWidth * Math.max(window.devicePixelRatio, 1.25),
+                    height: browserHeight * Math.max(window.devicePixelRatio, 1.25),
+                }, {
+                    width: maxWidth,
+                    height: maxHeight,
+                });
+                // Zoom level for orientation change if provided
+                if (orientationZoom) {
+                    if (newRes.width < newRes.height) {
+                        if (orientationZoom.hasOwnProperty('portrait'))
+                            (_a = this === null || this === void 0 ? void 0 : this.webRtcController) === null || _a === void 0 ? void 0 : _a.emitUIInteraction({
+                                zoom: orientationZoom.portrait
+                            });
+                    }
+                    else if (orientationZoom.hasOwnProperty('landscape')) {
+                        (_b = this === null || this === void 0 ? void 0 : this.webRtcController) === null || _b === void 0 ? void 0 : _b.emitUIInteraction({
+                            zoom: orientationZoom.landscape
+                        });
+                    }
+                }
                 if (videoPlayer) {
                     if (!unrealVersion || (unrealVersion === null || unrealVersion === void 0 ? void 0 : unrealVersion.startsWith("4.27"))) {
                         const descriptor = { Console: `r.setres ${Math.round(limitedWidth)}x${Math.round(limitedHeight)}w` };
-                        (_a = this === null || this === void 0 ? void 0 : this.webRtcController) === null || _a === void 0 ? void 0 : _a.emitUIInteraction(descriptor);
+                        (_c = this === null || this === void 0 ? void 0 : this.webRtcController) === null || _c === void 0 ? void 0 : _c.emitUIInteraction(descriptor);
                     }
                     else {
                         videoPlayer.onMatchViewportResolutionCallback(Math.round(limitedWidth), Math.round(limitedHeight));
@@ -24257,11 +24340,14 @@ class ArcwarePixelStreaming extends lib_pixelstreamingfrontend_ue5_5_1.PixelStre
         }
     }
     injectCustomUI() {
-        var _a;
-        const customUI = document === null || document === void 0 ? void 0 : document.getElementById("stream-ui");
-        const videoElementParent = (_a = this === null || this === void 0 ? void 0 : this.videoElementParent) === null || _a === void 0 ? void 0 : _a.parentElement;
-        if (customUI && videoElementParent)
-            videoElementParent === null || videoElementParent === void 0 ? void 0 : videoElementParent.appendChild(customUI);
+        (0, common_1.waitForElement)('#stream-ui')
+            .then(el => {
+            var _a;
+            const videoElementParent = (_a = this === null || this === void 0 ? void 0 : this.videoElementParent) === null || _a === void 0 ? void 0 : _a.parentElement;
+            if (videoElementParent) {
+                videoElementParent === null || videoElementParent === void 0 ? void 0 : videoElementParent.appendChild(el);
+            }
+        });
     }
 }
 exports.ArcwarePixelStreaming = ArcwarePixelStreaming;
@@ -24325,7 +24411,12 @@ exports.ArcwareSettingsSchema = zod_1.z.object({
     /** Width with which instance should be started */
     startWidth: zod_1.z.number().optional(),
     /** Height with which instance should be started */
-    startHeight: zod_1.z.number().optional()
+    startHeight: zod_1.z.number().optional(),
+    /** Zoom functionality */
+    orientationZoom: zod_1.z.object({
+        landscape: zod_1.z.number(),
+        portrait: zod_1.z.number(),
+    }).strict().optional()
 });
 
 
@@ -25123,7 +25214,7 @@ exports.DiagnosticsCollector = DiagnosticsCollector;
 
 
 Object.defineProperty(exports, "__esModule", ({ value: true }));
-exports.normalizeType = exports.randomHash = exports.extFromMime = exports.sanitizeFilename = exports.truncateByBytes = exports.parseUnknownToObject = void 0;
+exports.capScale = exports.waitForElement = exports.normalizeType = exports.randomHash = exports.extFromMime = exports.sanitizeFilename = exports.truncateByBytes = exports.parseUnknownToObject = void 0;
 /** Conservative normalizer: accepts object, strict JSON string, or JSON-ish like {foo: "bar"} */
 function parseUnknownToObject(input, opts = { allowJsonish: true }) {
     if (input && typeof input === "object")
@@ -25222,6 +25313,47 @@ function normalizeType(v) {
     return typeof v === "string" ? v.trim().toLowerCase() : "";
 }
 exports.normalizeType = normalizeType;
+function waitForElement(selector, { root = document, timeout = 3000 } = {}) {
+    return new Promise((resolve) => {
+        const existing = root.querySelector(selector);
+        if (existing)
+            return resolve(existing);
+        const observer = new MutationObserver(() => {
+            const el = root.querySelector(selector);
+            if (el) {
+                clearTimeout(timer);
+                observer.disconnect();
+                resolve(el); // fires once
+            }
+        });
+        observer.observe(root.documentElement || root, { childList: true, subtree: true });
+        const timer = setTimeout(() => {
+            observer.disconnect();
+        }, timeout);
+    });
+}
+exports.waitForElement = waitForElement;
+function capScale(size, max) {
+    const result = { width: 0, height: 0 };
+    /* result.width = size.width > max.width ? max.width : size.width;
+    result.height = size.height > max.height ? max.height : size.height; */
+    result.width = Math.floor(size.width);
+    result.height = Math.floor(size.height);
+    if (result.height > max.height) {
+        const heightScale = max.height / result.height;
+        result.height = max.height;
+        result.width *= heightScale;
+    }
+    if (result.width > max.width) {
+        const heightScale = max.width / result.width;
+        result.width = max.width;
+        result.height *= heightScale;
+    }
+    result.width = (result.width % 2) + result.width;
+    result.height = (result.height % 2) + result.height;
+    return result;
+}
+exports.capScale = capScale;
 
 
 /***/ }),
@@ -26427,6 +26559,20 @@ exports.ZQueue = zod_1.z.object({
 });
 
 
+/***/ }),
+
+/***/ 1919:
+/***/ ((__unused_webpack_module, exports, __webpack_require__) => {
+
+
+Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.ZRender = void 0;
+const zod_1 = __webpack_require__(8754);
+exports.ZRender = zod_1.z.object({
+    type: zod_1.z.literal("render")
+});
+
+
 /***/ }),
 
 /***/ 4201:
@@ -26784,9 +26930,10 @@ tslib_1.__exportStar(__webpack_require__(1224), exports);
 tslib_1.__exportStar(__webpack_require__(4882), exports);
 tslib_1.__exportStar(__webpack_require__(3751), exports);
 tslib_1.__exportStar(__webpack_require__(9864), exports);
+tslib_1.__exportStar(__webpack_require__(1919), exports);
 const Stats_1 = __webpack_require__(3403);
 exports.Send = {
-    stats: Stats_1.ZStats,
+    stats: Stats_1.ZStats
 };
 
 

package/index.esm.js

@@ -23428,7 +23428,7 @@ class ArcwareConfig extends _epicgames_ps_lib_pixelstreamingfrontend_ue5_5__WEBP
         if (!config.initialSettings.ss)
             config.initialSettings.ss = DefaultUrl;
         super(config);
-        this.VERSION = "1.3.8";
+        this.VERSION = "1.3.10";
         this.settings = settings;
         this.session = new _domain_Session__WEBPACK_IMPORTED_MODULE_0__.Session();
         this._initialSettings = config.initialSettings;
@@ -23547,7 +23547,7 @@ function ArcwareInit({ shareId, projectId }, configuration, forceRefresh = false
         useUrlParams: (configuration === null || configuration === void 0 ? void 0 : configuration.useUrlParams) === true,
         initialSettings: Object.assign({ ss: _ArcwareConfig__WEBPACK_IMPORTED_MODULE_0__.DefaultUrl, AutoConnect: false, StartVideoMuted: true, AutoPlayVideo: true, KeyboardInput: true, MouseInput: true, GamepadInput: true, TouchInput: true, XRControllerInput: true, UseMic: true, SuppressBrowserKeys: true, FakeMouseWithTouches: false, ForceMonoAudio: false, HoveringMouse: true }, configuration === null || configuration === void 0 ? void 0 : configuration.initialSettings),
         settings: Object.assign({ shareId,
-            projectId, fullscreenButton: true, audioButton: true, stopButton: false, infoButton: false, micButton: false, settingsButton: false, connectionStrengthIcon: false, connectionIdentifierLoggingDisabled: undefined, errorHandler: undefined, loveLetterHandler: undefined, loveLetterLogging: undefined, queueHandler: undefined, sessionIdHandler: undefined, startHeight: undefined, startWidth: undefined }, configuration === null || configuration === void 0 ? void 0 : configuration.settings)
+            projectId, fullscreenButton: true, audioButton: true, stopButton: false, infoButton: false, micButton: false, settingsButton: false, connectionStrengthIcon: false, connectionIdentifierLoggingDisabled: undefined, errorHandler: undefined, loveLetterHandler: undefined, loveLetterLogging: undefined, queueHandler: undefined, sessionIdHandler: undefined, startHeight: undefined, startWidth: undefined, orientationZoom: undefined }, configuration === null || configuration === void 0 ? void 0 : configuration.settings)
     });
     const PixelStreaming = new _ArcwarePixelStreaming__WEBPACK_IMPORTED_MODULE_1__.ArcwarePixelStreaming(Config);
     const Application = new _ArcwareApplication__WEBPACK_IMPORTED_MODULE_2__.ArcwareApplication({ stream: PixelStreaming });
@@ -23581,11 +23581,13 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _domain_EventHandler__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(3379);
 /* harmony import */ var _domain_Stats__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(9764);
 /* harmony import */ var _domain_debounce__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(9580);
-/* harmony import */ var _ui_LoveLetters__WEBPACK_IMPORTED_MODULE_13__ = __webpack_require__(4572);
-/* harmony import */ var _ui_ArcwareLogoLoader__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(6469);
+/* harmony import */ var _ui_LoveLetters__WEBPACK_IMPORTED_MODULE_14__ = __webpack_require__(4572);
+/* harmony import */ var _ui_ArcwareLogoLoader__WEBPACK_IMPORTED_MODULE_13__ = __webpack_require__(6469);
 /* harmony import */ var _ui_MicrophoneOverlay__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(3613);
 /* harmony import */ var _domain_ConnectionIdentifier__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(5999);
 /* harmony import */ var _features_DiagnosticsCollector__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(8429);
+/* harmony import */ var _features_common__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(2483);
+
 
 
 
@@ -23750,6 +23752,7 @@ class ArcwarePixelStreaming extends _epicgames_ps_lib_pixelstreamingfrontend_ue5
         this.addMessageHandler("ping", _arcware_cloud_shared_pixelstreaming_websdk__WEBPACK_IMPORTED_MODULE_0__.Messages.ZPing, this.onPing);
         this.addMessageHandler("queue", _arcware_cloud_shared_pixelstreaming_websdk__WEBPACK_IMPORTED_MODULE_0__.Messages.ZQueue, this.onQueue);
         this.addMessageHandler("version", _arcware_cloud_shared_pixelstreaming_websdk__WEBPACK_IMPORTED_MODULE_0__.Messages.ZVersion, this.onVersion);
+        this.addMessageHandler("render", _arcware_cloud_shared_pixelstreaming_websdk__WEBPACK_IMPORTED_MODULE_0__.Messages.ZRender, this.onRender);
         // Create a debounced version of the handleResolutionChange function
         const debouncedResolutionChange = (0,_domain_debounce__WEBPACK_IMPORTED_MODULE_8__["default"])(() => {
             this.handleResolutionChange();
@@ -23816,6 +23819,64 @@ class ArcwarePixelStreaming extends _epicgames_ps_lib_pixelstreamingfrontend_ue5
             }
         });
     }
+    isVideoRenderingNow(video) {
+        if (!video)
+            return false;
+        const hasDims = video.videoWidth > 0 && video.videoHeight > 0;
+        const hasData = video.readyState >= HTMLMediaElement.HAVE_CURRENT_DATA; // ≥2
+        const playing = !video.paused && !video.ended;
+        // Be conservative: require at least two signals to avoid metadata-only false positives
+        return (hasDims && hasData) || (hasDims && playing) || (hasData && playing);
+    }
+    waitForFirstFrameWithTimeout(ms = 2000) {
+        var _a, _b, _c;
+        return (0,tslib__WEBPACK_IMPORTED_MODULE_9__.__awaiter)(this, void 0, void 0, function* () {
+            const video = (_c = (_b = (_a = this.webRtcController) === null || _a === void 0 ? void 0 : _a.videoPlayer) === null || _b === void 0 ? void 0 : _b.getVideoElement) === null || _c === void 0 ? void 0 : _c.call(_b);
+            if (this.isVideoRenderingNow(video))
+                return true;
+            let t;
+            const ok = yield Promise.race([
+                new Promise((resolve) => {
+                    var _a, _b;
+                    const done = () => {
+                        cleanup();
+                        resolve(true);
+                    };
+                    const cleanup = () => {
+                        var _a, _b;
+                        video.removeEventListener("playing", onPlaying);
+                        video.removeEventListener("resize", onResize);
+                        if ("cancelVideoFrameCallback" in HTMLVideoElement.prototype && rvfcId != null) {
+                            (_b = (_a = video).cancelVideoFrameCallback) === null || _b === void 0 ? void 0 : _b.call(_a, rvfcId);
+                        }
+                    };
+                    const onPlaying = () => this.isVideoRenderingNow(video) && done();
+                    const onResize = () => this.isVideoRenderingNow(video) && done();
+                    video.addEventListener("playing", onPlaying, { once: true });
+                    video.addEventListener("resize", onResize, { once: true });
+                    const rvfcId = "requestVideoFrameCallback" in HTMLVideoElement.prototype
+                        ? (_b = (_a = video).requestVideoFrameCallback) === null || _b === void 0 ? void 0 : _b.call(_a, () => done())
+                        : null;
+                }),
+                new Promise((resolve) => {
+                    t = window.setTimeout(() => resolve(false), ms);
+                })
+            ]);
+            if (t)
+                clearTimeout(t);
+            return ok;
+        });
+    }
+    onRender(_msg) {
+        return (0,tslib__WEBPACK_IMPORTED_MODULE_9__.__awaiter)(this, void 0, void 0, function* () {
+            const isRendering = yield this.waitForFirstFrameWithTimeout();
+            const payload = {
+                type: "render",
+                isRendering: isRendering
+            };
+            this.send(payload); // uses buffered send
+        });
+    }
     /** On ping the session creation timestamp will be updated. */
     onPing(message) {
         var _a, _b;
@@ -24068,15 +24129,16 @@ class ArcwarePixelStreaming extends _epicgames_ps_lib_pixelstreamingfrontend_ue5
         }
     }
     handleResolutionChange() {
-        var _a, _b, _c, _d, _e, _f, _g;
+        var _a, _b, _c, _d, _e, _f, _g, _h;
         if (!(this === null || this === void 0 ? void 0 : this.streamInfo) || !(this === null || this === void 0 ? void 0 : this.webRtcController) || !((_b = (_a = this === null || this === void 0 ? void 0 : this.webRtcController) === null || _a === void 0 ? void 0 : _a.videoPlayer) === null || _b === void 0 ? void 0 : _b.getVideoElement())) {
             return;
         }
         const resolution = (_d = (_c = this === null || this === void 0 ? void 0 : this.streamInfo) === null || _c === void 0 ? void 0 : _c.streamInfo) === null || _d === void 0 ? void 0 : _d.resolution;
         const unrealVersion = (_g = (_f = (_e = this === null || this === void 0 ? void 0 : this.streamInfo) === null || _e === void 0 ? void 0 : _e.streamInfo) === null || _f === void 0 ? void 0 : _f.meta) === null || _g === void 0 ? void 0 : _g.version;
+        const orientationZoom = (_h = this.config.settings) === null || _h === void 0 ? void 0 : _h.orientationZoom;
         if (resolution && (resolution === null || resolution === void 0 ? void 0 : resolution.dynamic)) {
             setTimeout(() => {
-                var _a;
+                var _a, _b, _c;
                 const { videoPlayer } = this === null || this === void 0 ? void 0 : this.webRtcController;
                 const videoElementParent = videoPlayer === null || videoPlayer === void 0 ? void 0 : videoPlayer.getVideoParentElement();
                 const browserWidth = videoElementParent === null || videoElementParent === void 0 ? void 0 : videoElementParent.getBoundingClientRect().width;
@@ -24093,10 +24155,32 @@ class ArcwarePixelStreaming extends _epicgames_ps_lib_pixelstreamingfrontend_ue5
                     limitedHeight = maxHeight;
                     limitedWidth = maxHeight * aspectRatio;
                 }
+                // width: clientWidth * Math.max(window.devicePixelRatio, 1)  - for retina device, 1 is min upscale factor
+                const newRes = (0,_features_common__WEBPACK_IMPORTED_MODULE_12__.capScale)({
+                    width: browserWidth * Math.max(window.devicePixelRatio, 1.25),
+                    height: browserHeight * Math.max(window.devicePixelRatio, 1.25),
+                }, {
+                    width: maxWidth,
+                    height: maxHeight,
+                });
+                // Zoom level for orientation change if provided
+                if (orientationZoom) {
+                    if (newRes.width < newRes.height) {
+                        if (orientationZoom.hasOwnProperty('portrait'))
+                            (_a = this === null || this === void 0 ? void 0 : this.webRtcController) === null || _a === void 0 ? void 0 : _a.emitUIInteraction({
+                                zoom: orientationZoom.portrait
+                            });
+                    }
+                    else if (orientationZoom.hasOwnProperty('landscape')) {
+                        (_b = this === null || this === void 0 ? void 0 : this.webRtcController) === null || _b === void 0 ? void 0 : _b.emitUIInteraction({
+                            zoom: orientationZoom.landscape
+                        });
+                    }
+                }
                 if (videoPlayer) {
                     if (!unrealVersion || (unrealVersion === null || unrealVersion === void 0 ? void 0 : unrealVersion.startsWith("4.27"))) {
                         const descriptor = { Console: `r.setres ${Math.round(limitedWidth)}x${Math.round(limitedHeight)}w` };
-                        (_a = this === null || this === void 0 ? void 0 : this.webRtcController) === null || _a === void 0 ? void 0 : _a.emitUIInteraction(descriptor);
+                        (_c = this === null || this === void 0 ? void 0 : this.webRtcController) === null || _c === void 0 ? void 0 : _c.emitUIInteraction(descriptor);
                     }
                     else {
                         videoPlayer.onMatchViewportResolutionCallback(Math.round(limitedWidth), Math.round(limitedHeight));
@@ -24156,7 +24240,7 @@ class ArcwarePixelStreaming extends _epicgames_ps_lib_pixelstreamingfrontend_ue5
     }
     initLoveLettersContainer() {
         var _a;
-        const logoLoader = new _ui_ArcwareLogoLoader__WEBPACK_IMPORTED_MODULE_12__.ArcwareLogoLoader();
+        const logoLoader = new _ui_ArcwareLogoLoader__WEBPACK_IMPORTED_MODULE_13__.ArcwareLogoLoader();
         if (!this.loveLettersContainer) {
             const loveLettersContainer = document === null || document === void 0 ? void 0 : document.createElement("div");
             const { videoPlayer } = this === null || this === void 0 ? void 0 : this.webRtcController;
@@ -24193,7 +24277,7 @@ class ArcwarePixelStreaming extends _epicgames_ps_lib_pixelstreamingfrontend_ue5
         if (letter !== undefined) {
             const formattedLoveLetter = letter === null || letter === void 0 ? void 0 : letter.replace(/LL: |\.$/g, "");
             (_a = this === null || this === void 0 ? void 0 : this.loveLettersList) === null || _a === void 0 ? void 0 : _a.push(formattedLoveLetter);
-            const loveLettersBox = new _ui_LoveLetters__WEBPACK_IMPORTED_MODULE_13__.LoveLetters();
+            const loveLettersBox = new _ui_LoveLetters__WEBPACK_IMPORTED_MODULE_14__.LoveLetters();
             loveLettersBox === null || loveLettersBox === void 0 ? void 0 : loveLettersBox.addLetter(formattedLoveLetter, (_b = this === null || this === void 0 ? void 0 : this.loveLettersList) === null || _b === void 0 ? void 0 : _b.length);
             setTimeout(() => {
                 this.processLoveLetterQueue();
@@ -24282,11 +24366,14 @@ class ArcwarePixelStreaming extends _epicgames_ps_lib_pixelstreamingfrontend_ue5
         }
     }
     injectCustomUI() {
-        var _a;
-        const customUI = document === null || document === void 0 ? void 0 : document.getElementById("stream-ui");
-        const videoElementParent = (_a = this === null || this === void 0 ? void 0 : this.videoElementParent) === null || _a === void 0 ? void 0 : _a.parentElement;
-        if (customUI && videoElementParent)
-            videoElementParent === null || videoElementParent === void 0 ? void 0 : videoElementParent.appendChild(customUI);
+        (0,_features_common__WEBPACK_IMPORTED_MODULE_12__.waitForElement)('#stream-ui')
+            .then(el => {
+            var _a;
+            const videoElementParent = (_a = this === null || this === void 0 ? void 0 : this.videoElementParent) === null || _a === void 0 ? void 0 : _a.parentElement;
+            if (videoElementParent) {
+                videoElementParent === null || videoElementParent === void 0 ? void 0 : videoElementParent.appendChild(el);
+            }
+        });
     }
 }
 
@@ -24352,7 +24439,12 @@ const ArcwareSettingsSchema = zod__WEBPACK_IMPORTED_MODULE_1__.z.object({
     /** Width with which instance should be started */
     startWidth: zod__WEBPACK_IMPORTED_MODULE_1__.z.number().optional(),
     /** Height with which instance should be started */
-    startHeight: zod__WEBPACK_IMPORTED_MODULE_1__.z.number().optional()
+    startHeight: zod__WEBPACK_IMPORTED_MODULE_1__.z.number().optional(),
+    /** Zoom functionality */
+    orientationZoom: zod__WEBPACK_IMPORTED_MODULE_1__.z.object({
+        landscape: zod__WEBPACK_IMPORTED_MODULE_1__.z.number(),
+        portrait: zod__WEBPACK_IMPORTED_MODULE_1__.z.number(),
+    }).strict().optional()
 });
 
 
@@ -25160,12 +25252,14 @@ class DiagnosticsCollector {
 
 __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   "capScale": () => (/* binding */ capScale),
 /* harmony export */   "extFromMime": () => (/* binding */ extFromMime),
 /* harmony export */   "normalizeType": () => (/* binding */ normalizeType),
 /* harmony export */   "parseUnknownToObject": () => (/* binding */ parseUnknownToObject),
 /* harmony export */   "randomHash": () => (/* binding */ randomHash),
 /* harmony export */   "sanitizeFilename": () => (/* binding */ sanitizeFilename),
-/* harmony export */   "truncateByBytes": () => (/* binding */ truncateByBytes)
+/* harmony export */   "truncateByBytes": () => (/* binding */ truncateByBytes),
+/* harmony export */   "waitForElement": () => (/* binding */ waitForElement)
 /* harmony export */ });
 /** Conservative normalizer: accepts object, strict JSON string, or JSON-ish like {foo: "bar"} */
 function parseUnknownToObject(input, opts = { allowJsonish: true }) {
@@ -25259,6 +25353,45 @@ function randomHash() {
 function normalizeType(v) {
     return typeof v === "string" ? v.trim().toLowerCase() : "";
 }
+function waitForElement(selector, { root = document, timeout = 3000 } = {}) {
+    return new Promise((resolve) => {
+        const existing = root.querySelector(selector);
+        if (existing)
+            return resolve(existing);
+        const observer = new MutationObserver(() => {
+            const el = root.querySelector(selector);
+            if (el) {
+                clearTimeout(timer);
+                observer.disconnect();
+                resolve(el); // fires once
+            }
+        });
+        observer.observe(root.documentElement || root, { childList: true, subtree: true });
+        const timer = setTimeout(() => {
+            observer.disconnect();
+        }, timeout);
+    });
+}
+function capScale(size, max) {
+    const result = { width: 0, height: 0 };
+    /* result.width = size.width > max.width ? max.width : size.width;
+    result.height = size.height > max.height ? max.height : size.height; */
+    result.width = Math.floor(size.width);
+    result.height = Math.floor(size.height);
+    if (result.height > max.height) {
+        const heightScale = max.height / result.height;
+        result.height = max.height;
+        result.width *= heightScale;
+    }
+    if (result.width > max.width) {
+        const heightScale = max.width / result.width;
+        result.width = max.width;
+        result.height *= heightScale;
+    }
+    result.width = (result.width % 2) + result.width;
+    result.height = (result.height % 2) + result.height;
+    return result;
+}
 
 
 /***/ }),
@@ -26492,6 +26625,22 @@ const ZQueue = zod__WEBPACK_IMPORTED_MODULE_0__.z.object({
 });
 
 
+/***/ }),
+
+/***/ 1919:
+/***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   "ZRender": () => (/* binding */ ZRender)
+/* harmony export */ });
+/* harmony import */ var zod__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(1604);
+
+const ZRender = zod__WEBPACK_IMPORTED_MODULE_0__.z.object({
+    type: zod__WEBPACK_IMPORTED_MODULE_0__.z.literal("render")
+});
+
+
 /***/ }),
 
 /***/ 4201:
@@ -26829,6 +26978,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   "ZLoveLetter": () => (/* reexport safe */ _LoveLetter__WEBPACK_IMPORTED_MODULE_1__.ZLoveLetter),
 /* harmony export */   "ZPing": () => (/* reexport safe */ _Ping__WEBPACK_IMPORTED_MODULE_5__.ZPing),
 /* harmony export */   "ZQueue": () => (/* reexport safe */ _Queue__WEBPACK_IMPORTED_MODULE_6__.ZQueue),
+/* harmony export */   "ZRender": () => (/* reexport safe */ _Render__WEBPACK_IMPORTED_MODULE_9__.ZRender),
 /* harmony export */   "ZSessionId": () => (/* reexport safe */ _SessionId__WEBPACK_IMPORTED_MODULE_2__.ZSessionId),
 /* harmony export */   "ZStats": () => (/* reexport safe */ _Stats__WEBPACK_IMPORTED_MODULE_4__.ZStats),
 /* harmony export */   "ZStreamInfo": () => (/* reexport safe */ _StreamInfo__WEBPACK_IMPORTED_MODULE_3__.ZStreamInfo),
@@ -26843,6 +26993,8 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _Queue__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(4882);
 /* harmony import */ var _Version__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(3751);
 /* harmony import */ var _WebSdkSettings__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(9864);
+/* harmony import */ var _Render__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(1919);
+
 
 
 
@@ -26854,7 +27006,7 @@ __webpack_require__.r(__webpack_exports__);
 
 
 const Send = {
-    stats: _Stats__WEBPACK_IMPORTED_MODULE_4__.ZStats,
+    stats: _Stats__WEBPACK_IMPORTED_MODULE_4__.ZStats
 };
 
 

package/index.umd.js

@@ -23430,7 +23430,7 @@ class ArcwareConfig extends lib_pixelstreamingfrontend_ue5_5_1.Config {
         if (!config.initialSettings.ss)
             config.initialSettings.ss = exports.DefaultUrl;
         super(config);
-        this.VERSION = "1.3.8";
+        this.VERSION = "1.3.10";
         this.settings = settings;
         this.session = new Session_1.Session();
         this._initialSettings = config.initialSettings;
@@ -23546,7 +23546,7 @@ function ArcwareInit({ shareId, projectId }, configuration, forceRefresh = false
         useUrlParams: (configuration === null || configuration === void 0 ? void 0 : configuration.useUrlParams) === true,
         initialSettings: Object.assign({ ss: ArcwareConfig_1.DefaultUrl, AutoConnect: false, StartVideoMuted: true, AutoPlayVideo: true, KeyboardInput: true, MouseInput: true, GamepadInput: true, TouchInput: true, XRControllerInput: true, UseMic: true, SuppressBrowserKeys: true, FakeMouseWithTouches: false, ForceMonoAudio: false, HoveringMouse: true }, configuration === null || configuration === void 0 ? void 0 : configuration.initialSettings),
         settings: Object.assign({ shareId,
-            projectId, fullscreenButton: true, audioButton: true, stopButton: false, infoButton: false, micButton: false, settingsButton: false, connectionStrengthIcon: false, connectionIdentifierLoggingDisabled: undefined, errorHandler: undefined, loveLetterHandler: undefined, loveLetterLogging: undefined, queueHandler: undefined, sessionIdHandler: undefined, startHeight: undefined, startWidth: undefined }, configuration === null || configuration === void 0 ? void 0 : configuration.settings)
+            projectId, fullscreenButton: true, audioButton: true, stopButton: false, infoButton: false, micButton: false, settingsButton: false, connectionStrengthIcon: false, connectionIdentifierLoggingDisabled: undefined, errorHandler: undefined, loveLetterHandler: undefined, loveLetterLogging: undefined, queueHandler: undefined, sessionIdHandler: undefined, startHeight: undefined, startWidth: undefined, orientationZoom: undefined }, configuration === null || configuration === void 0 ? void 0 : configuration.settings)
     });
     const PixelStreaming = new ArcwarePixelStreaming_1.ArcwarePixelStreaming(Config);
     const Application = new ArcwareApplication_1.ArcwareApplication({ stream: PixelStreaming });
@@ -23583,6 +23583,7 @@ const ArcwareLogoLoader_1 = __webpack_require__(6469);
 const MicrophoneOverlay_1 = __webpack_require__(3613);
 const ConnectionIdentifier_1 = __webpack_require__(5999);
 const DiagnosticsCollector_1 = __webpack_require__(8429);
+const common_1 = __webpack_require__(2483);
 class ArcwarePixelStreaming extends lib_pixelstreamingfrontend_ue5_5_1.PixelStreaming {
     resetInitGuardsAndHooks() {
         this.videoInitializedSent = false;
@@ -23735,6 +23736,7 @@ class ArcwarePixelStreaming extends lib_pixelstreamingfrontend_ue5_5_1.PixelStre
         this.addMessageHandler("ping", shared_pixelstreaming_websdk_1.Messages.ZPing, this.onPing);
         this.addMessageHandler("queue", shared_pixelstreaming_websdk_1.Messages.ZQueue, this.onQueue);
         this.addMessageHandler("version", shared_pixelstreaming_websdk_1.Messages.ZVersion, this.onVersion);
+        this.addMessageHandler("render", shared_pixelstreaming_websdk_1.Messages.ZRender, this.onRender);
         // Create a debounced version of the handleResolutionChange function
         const debouncedResolutionChange = (0, debounce_1.default)(() => {
             this.handleResolutionChange();
@@ -23801,6 +23803,64 @@ class ArcwarePixelStreaming extends lib_pixelstreamingfrontend_ue5_5_1.PixelStre
             }
         });
     }
+    isVideoRenderingNow(video) {
+        if (!video)
+            return false;
+        const hasDims = video.videoWidth > 0 && video.videoHeight > 0;
+        const hasData = video.readyState >= HTMLMediaElement.HAVE_CURRENT_DATA; // ≥2
+        const playing = !video.paused && !video.ended;
+        // Be conservative: require at least two signals to avoid metadata-only false positives
+        return (hasDims && hasData) || (hasDims && playing) || (hasData && playing);
+    }
+    waitForFirstFrameWithTimeout(ms = 2000) {
+        var _a, _b, _c;
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const video = (_c = (_b = (_a = this.webRtcController) === null || _a === void 0 ? void 0 : _a.videoPlayer) === null || _b === void 0 ? void 0 : _b.getVideoElement) === null || _c === void 0 ? void 0 : _c.call(_b);
+            if (this.isVideoRenderingNow(video))
+                return true;
+            let t;
+            const ok = yield Promise.race([
+                new Promise((resolve) => {
+                    var _a, _b;
+                    const done = () => {
+                        cleanup();
+                        resolve(true);
+                    };
+                    const cleanup = () => {
+                        var _a, _b;
+                        video.removeEventListener("playing", onPlaying);
+                        video.removeEventListener("resize", onResize);
+                        if ("cancelVideoFrameCallback" in HTMLVideoElement.prototype && rvfcId != null) {
+                            (_b = (_a = video).cancelVideoFrameCallback) === null || _b === void 0 ? void 0 : _b.call(_a, rvfcId);
+                        }
+                    };
+                    const onPlaying = () => this.isVideoRenderingNow(video) && done();
+                    const onResize = () => this.isVideoRenderingNow(video) && done();
+                    video.addEventListener("playing", onPlaying, { once: true });
+                    video.addEventListener("resize", onResize, { once: true });
+                    const rvfcId = "requestVideoFrameCallback" in HTMLVideoElement.prototype
+                        ? (_b = (_a = video).requestVideoFrameCallback) === null || _b === void 0 ? void 0 : _b.call(_a, () => done())
+                        : null;
+                }),
+                new Promise((resolve) => {
+                    t = window.setTimeout(() => resolve(false), ms);
+                })
+            ]);
+            if (t)
+                clearTimeout(t);
+            return ok;
+        });
+    }
+    onRender(_msg) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const isRendering = yield this.waitForFirstFrameWithTimeout();
+            const payload = {
+                type: "render",
+                isRendering: isRendering
+            };
+            this.send(payload); // uses buffered send
+        });
+    }
     /** On ping the session creation timestamp will be updated. */
     onPing(message) {
         var _a, _b;
@@ -24053,15 +24113,16 @@ class ArcwarePixelStreaming extends lib_pixelstreamingfrontend_ue5_5_1.PixelStre
         }
     }
     handleResolutionChange() {
-        var _a, _b, _c, _d, _e, _f, _g;
+        var _a, _b, _c, _d, _e, _f, _g, _h;
         if (!(this === null || this === void 0 ? void 0 : this.streamInfo) || !(this === null || this === void 0 ? void 0 : this.webRtcController) || !((_b = (_a = this === null || this === void 0 ? void 0 : this.webRtcController) === null || _a === void 0 ? void 0 : _a.videoPlayer) === null || _b === void 0 ? void 0 : _b.getVideoElement())) {
             return;
         }
         const resolution = (_d = (_c = this === null || this === void 0 ? void 0 : this.streamInfo) === null || _c === void 0 ? void 0 : _c.streamInfo) === null || _d === void 0 ? void 0 : _d.resolution;
         const unrealVersion = (_g = (_f = (_e = this === null || this === void 0 ? void 0 : this.streamInfo) === null || _e === void 0 ? void 0 : _e.streamInfo) === null || _f === void 0 ? void 0 : _f.meta) === null || _g === void 0 ? void 0 : _g.version;
+        const orientationZoom = (_h = this.config.settings) === null || _h === void 0 ? void 0 : _h.orientationZoom;
         if (resolution && (resolution === null || resolution === void 0 ? void 0 : resolution.dynamic)) {
             setTimeout(() => {
-                var _a;
+                var _a, _b, _c;
                 const { videoPlayer } = this === null || this === void 0 ? void 0 : this.webRtcController;
                 const videoElementParent = videoPlayer === null || videoPlayer === void 0 ? void 0 : videoPlayer.getVideoParentElement();
                 const browserWidth = videoElementParent === null || videoElementParent === void 0 ? void 0 : videoElementParent.getBoundingClientRect().width;
@@ -24078,10 +24139,32 @@ class ArcwarePixelStreaming extends lib_pixelstreamingfrontend_ue5_5_1.PixelStre
                     limitedHeight = maxHeight;
                     limitedWidth = maxHeight * aspectRatio;
                 }
+                // width: clientWidth * Math.max(window.devicePixelRatio, 1)  - for retina device, 1 is min upscale factor
+                const newRes = (0, common_1.capScale)({
+                    width: browserWidth * Math.max(window.devicePixelRatio, 1.25),
+                    height: browserHeight * Math.max(window.devicePixelRatio, 1.25),
+                }, {
+                    width: maxWidth,
+                    height: maxHeight,
+                });
+                // Zoom level for orientation change if provided
+                if (orientationZoom) {
+                    if (newRes.width < newRes.height) {
+                        if (orientationZoom.hasOwnProperty('portrait'))
+                            (_a = this === null || this === void 0 ? void 0 : this.webRtcController) === null || _a === void 0 ? void 0 : _a.emitUIInteraction({
+                                zoom: orientationZoom.portrait
+                            });
+                    }
+                    else if (orientationZoom.hasOwnProperty('landscape')) {
+                        (_b = this === null || this === void 0 ? void 0 : this.webRtcController) === null || _b === void 0 ? void 0 : _b.emitUIInteraction({
+                            zoom: orientationZoom.landscape
+                        });
+                    }
+                }
                 if (videoPlayer) {
                     if (!unrealVersion || (unrealVersion === null || unrealVersion === void 0 ? void 0 : unrealVersion.startsWith("4.27"))) {
                         const descriptor = { Console: `r.setres ${Math.round(limitedWidth)}x${Math.round(limitedHeight)}w` };
-                        (_a = this === null || this === void 0 ? void 0 : this.webRtcController) === null || _a === void 0 ? void 0 : _a.emitUIInteraction(descriptor);
+                        (_c = this === null || this === void 0 ? void 0 : this.webRtcController) === null || _c === void 0 ? void 0 : _c.emitUIInteraction(descriptor);
                     }
                     else {
                         videoPlayer.onMatchViewportResolutionCallback(Math.round(limitedWidth), Math.round(limitedHeight));
@@ -24267,11 +24350,14 @@ class ArcwarePixelStreaming extends lib_pixelstreamingfrontend_ue5_5_1.PixelStre
         }
     }
     injectCustomUI() {
-        var _a;
-        const customUI = document === null || document === void 0 ? void 0 : document.getElementById("stream-ui");
-        const videoElementParent = (_a = this === null || this === void 0 ? void 0 : this.videoElementParent) === null || _a === void 0 ? void 0 : _a.parentElement;
-        if (customUI && videoElementParent)
-            videoElementParent === null || videoElementParent === void 0 ? void 0 : videoElementParent.appendChild(customUI);
+        (0, common_1.waitForElement)('#stream-ui')
+            .then(el => {
+            var _a;
+            const videoElementParent = (_a = this === null || this === void 0 ? void 0 : this.videoElementParent) === null || _a === void 0 ? void 0 : _a.parentElement;
+            if (videoElementParent) {
+                videoElementParent === null || videoElementParent === void 0 ? void 0 : videoElementParent.appendChild(el);
+            }
+        });
     }
 }
 exports.ArcwarePixelStreaming = ArcwarePixelStreaming;
@@ -24335,7 +24421,12 @@ exports.ArcwareSettingsSchema = zod_1.z.object({
     /** Width with which instance should be started */
     startWidth: zod_1.z.number().optional(),
     /** Height with which instance should be started */
-    startHeight: zod_1.z.number().optional()
+    startHeight: zod_1.z.number().optional(),
+    /** Zoom functionality */
+    orientationZoom: zod_1.z.object({
+        landscape: zod_1.z.number(),
+        portrait: zod_1.z.number(),
+    }).strict().optional()
 });
 
 
@@ -25133,7 +25224,7 @@ exports.DiagnosticsCollector = DiagnosticsCollector;
 
 
 Object.defineProperty(exports, "__esModule", ({ value: true }));
-exports.normalizeType = exports.randomHash = exports.extFromMime = exports.sanitizeFilename = exports.truncateByBytes = exports.parseUnknownToObject = void 0;
+exports.capScale = exports.waitForElement = exports.normalizeType = exports.randomHash = exports.extFromMime = exports.sanitizeFilename = exports.truncateByBytes = exports.parseUnknownToObject = void 0;
 /** Conservative normalizer: accepts object, strict JSON string, or JSON-ish like {foo: "bar"} */
 function parseUnknownToObject(input, opts = { allowJsonish: true }) {
     if (input && typeof input === "object")
@@ -25232,6 +25323,47 @@ function normalizeType(v) {
     return typeof v === "string" ? v.trim().toLowerCase() : "";
 }
 exports.normalizeType = normalizeType;
+function waitForElement(selector, { root = document, timeout = 3000 } = {}) {
+    return new Promise((resolve) => {
+        const existing = root.querySelector(selector);
+        if (existing)
+            return resolve(existing);
+        const observer = new MutationObserver(() => {
+            const el = root.querySelector(selector);
+            if (el) {
+                clearTimeout(timer);
+                observer.disconnect();
+                resolve(el); // fires once
+            }
+        });
+        observer.observe(root.documentElement || root, { childList: true, subtree: true });
+        const timer = setTimeout(() => {
+            observer.disconnect();
+        }, timeout);
+    });
+}
+exports.waitForElement = waitForElement;
+function capScale(size, max) {
+    const result = { width: 0, height: 0 };
+    /* result.width = size.width > max.width ? max.width : size.width;
+    result.height = size.height > max.height ? max.height : size.height; */
+    result.width = Math.floor(size.width);
+    result.height = Math.floor(size.height);
+    if (result.height > max.height) {
+        const heightScale = max.height / result.height;
+        result.height = max.height;
+        result.width *= heightScale;
+    }
+    if (result.width > max.width) {
+        const heightScale = max.width / result.width;
+        result.width = max.width;
+        result.height *= heightScale;
+    }
+    result.width = (result.width % 2) + result.width;
+    result.height = (result.height % 2) + result.height;
+    return result;
+}
+exports.capScale = capScale;
 
 
 /***/ }),
@@ -26437,6 +26569,20 @@ exports.ZQueue = zod_1.z.object({
 });
 
 
+/***/ }),
+
+/***/ 1919:
+/***/ ((__unused_webpack_module, exports, __webpack_require__) => {
+
+
+Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.ZRender = void 0;
+const zod_1 = __webpack_require__(8754);
+exports.ZRender = zod_1.z.object({
+    type: zod_1.z.literal("render")
+});
+
+
 /***/ }),
 
 /***/ 4201:
@@ -26794,9 +26940,10 @@ tslib_1.__exportStar(__webpack_require__(1224), exports);
 tslib_1.__exportStar(__webpack_require__(4882), exports);
 tslib_1.__exportStar(__webpack_require__(3751), exports);
 tslib_1.__exportStar(__webpack_require__(9864), exports);
+tslib_1.__exportStar(__webpack_require__(1919), exports);
 const Stats_1 = __webpack_require__(3403);
 exports.Send = {
-    stats: Stats_1.ZStats,
+    stats: Stats_1.ZStats
 };
 
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@arcware-cloud/pixelstreaming-websdk",
   "description": "WebSDK for easy implementation of pixel streaming with Arcware Cloud Services. Heavily based on the '@epicgames-ps' library.",
-  "version": "1.3.8",
+  "version": "1.3.10",
   "type": "commonjs",
   "main": "./index.umd.js",
   "module": "./index.umd.js",

package/types/lib/ArcwareConfig.d.ts

@@ -26,7 +26,7 @@ export declare class ArcwareConfig extends Config {
     readonly session: Session;
     readonly settings: Settings;
     private _initialSettings;
-    readonly VERSION = "1.3.8";
+    readonly VERSION = "1.3.10";
     constructor(config: ArcwareConfigParams);
     /** Setup connection string. */
     get urlFlags(): string;

package/types/lib/ArcwarePixelStreaming.d.ts

@@ -50,6 +50,9 @@ export declare class ArcwarePixelStreaming extends PixelStreaming {
      */
     /** On version requested, the version of the WebSDK would be returned. */
     private onVersion;
+    private isVideoRenderingNow;
+    private waitForFirstFrameWithTimeout;
+    private onRender;
     /** On ping the session creation timestamp will be updated. */
     private onPing;
     /** Handle incoming configurations. */

package/types/lib/domain/ArcwareSettingsSchema.d.ts

@@ -123,6 +123,17 @@ export declare const ArcwareSettingsSchema: z.ZodObject<{
     startWidth: z.ZodOptional<z.ZodNumber>;
     /** Height with which instance should be started */
     startHeight: z.ZodOptional<z.ZodNumber>;
+    /** Zoom functionality */
+    orientationZoom: z.ZodOptional<z.ZodObject<{
+        landscape: z.ZodNumber;
+        portrait: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        landscape?: number;
+        portrait?: number;
+    }, {
+        landscape?: number;
+        portrait?: number;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     session?: string;
     token?: string;
@@ -164,6 +175,10 @@ export declare const ArcwareSettingsSchema: z.ZodObject<{
     connectionIdentifierLoggingDisabled?: boolean;
     startWidth?: number;
     startHeight?: number;
+    orientationZoom?: {
+        landscape?: number;
+        portrait?: number;
+    };
 }, {
     session?: string;
     token?: string;
@@ -205,5 +220,9 @@ export declare const ArcwareSettingsSchema: z.ZodObject<{
     connectionIdentifierLoggingDisabled?: boolean;
     startWidth?: number;
     startHeight?: number;
+    orientationZoom?: {
+        landscape?: number;
+        portrait?: number;
+    };
 }>;
 export type Settings = z.infer<typeof ArcwareSettingsSchema>;

package/types/lib/features/common.d.ts

@@ -1,3 +1,4 @@
+import { Size } from "@arcware-cloud/shared/signalling-communication";
 /** Conservative normalizer: accepts object, strict JSON string, or JSON-ish like {foo: "bar"} */
 export declare function parseUnknownToObject(input: unknown, opts?: {
     allowJsonish?: boolean;
@@ -11,3 +12,8 @@ export declare function extFromMime(mime: string): string;
 /** Short random fallback */
 export declare function randomHash(): string;
 export declare function normalizeType(v: unknown): string;
+export declare function waitForElement(selector: string, { root, timeout }?: {
+    root?: Document;
+    timeout?: number;
+}): Promise<any>;
+export declare function capScale(size: Size, max: Size): Size;

package/types/shared/lib/Messages/Render.d.ts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+export declare const ZRender: z.ZodObject<{
+    type: z.ZodLiteral<"render">;
+}, "strip", z.ZodTypeAny, {
+    type?: "render";
+}, {
+    type?: "render";
+}>;
+export type Render = z.infer<typeof ZRender>;

package/types/shared/lib/Messages/index.d.ts

@@ -7,6 +7,7 @@ export * from "./Ping";
 export * from "./Queue";
 export * from "./Version";
 export * from "./WebSdkSettings";
+export * from "./Render";
 export declare const Send: {
     stats: import("zod").ZodObject<{
         type: import("zod").ZodLiteral<"stats">;