@midscene/android-playground 1.12.7-beta-20260914023554.0 → 1.12.7

package/dist/es/bin.mjs

@@ -184,9 +184,67 @@ function _define_property(obj, key, value) {
     else obj[key] = value;
     return obj;
 }
+const SCRCPY_MAX_IN_FLIGHT_BYTES = 8388608;
+const SCRCPY_MAX_IN_FLIGHT_PACKETS = 256;
+const SCRCPY_VIDEO_ACK_TIMEOUT_MS = 10000;
+const debug = getDebug('android:playground:video', {
+    console: true
+});
+function buildScrcpyVideoPacket(packet, timestamp = Date.now()) {
+    return {
+        data: packet.data,
+        type: packet.type,
+        timestamp,
+        keyFrame: 'data' === packet.type ? packet.keyframe : void 0
+    };
+}
+class ScrcpyVideoSender {
+    fail(message) {
+        if (this.failed) return;
+        this.failed = true;
+        debug(message);
+        this.socket.conn.close(true);
+    }
+    send(packet) {
+        if (this.failed || !this.socket.connected) throw new Error('Cannot send video on a closed scrcpy connection');
+        const bytes = packet.data.byteLength;
+        if (this.inFlightPackets >= SCRCPY_MAX_IN_FLIGHT_PACKETS || this.inFlightBytes + bytes > SCRCPY_MAX_IN_FLIGHT_BYTES) {
+            const message = 'Scrcpy video receiver is too slow; reconnecting preview';
+            this.fail(message);
+            throw new Error(message);
+        }
+        this.inFlightBytes += bytes;
+        this.inFlightPackets += 1;
+        this.socket.timeout(SCRCPY_VIDEO_ACK_TIMEOUT_MS).emit('video-data', buildScrcpyVideoPacket(packet), (error)=>{
+            this.inFlightBytes -= bytes;
+            this.inFlightPackets -= 1;
+            if (error && this.socket.connected) this.fail('Scrcpy video acknowledgement timed out; reconnecting preview');
+        });
+    }
+    constructor(socket){
+        _define_property(this, "socket", void 0);
+        _define_property(this, "inFlightBytes", void 0);
+        _define_property(this, "inFlightPackets", void 0);
+        _define_property(this, "failed", void 0);
+        this.socket = socket;
+        this.inFlightBytes = 0;
+        this.inFlightPackets = 0;
+        this.failed = false;
+    }
+}
+function timeout_define_property(obj, key, value) {
+    if (key in obj) Object.defineProperty(obj, key, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
+    });
+    else obj[key] = value;
+    return obj;
+}
 class PromiseTimeoutError extends Error {
     constructor(message, timeoutMs){
-        super(message), _define_property(this, "timeoutMs", void 0);
+        super(message), timeout_define_property(this, "timeoutMs", void 0);
         this.name = 'PromiseTimeoutError';
         this.timeoutMs = timeoutMs;
     }
@@ -410,6 +468,7 @@ class ScrcpyServer {
             let activeSession = null;
             let sessionGeneration = 0;
             let adb = null;
+            const videoSender = new ScrcpyVideoSender(socket);
             const closeScrcpySession = async (reason, sessionToClose = activeSession)=>{
                 if (!sessionToClose) return;
                 sessionToClose.closeReason ??= reason;
@@ -567,13 +626,7 @@ class ScrcpyServer {
                                         const { done, value } = await reader.read();
                                         if (done) break;
                                         if (!isCurrentGeneration() || activeSession !== streamSession) return;
-                                        const frameType = value.type || 'data';
-                                        socket.volatile.emit('video-data', {
-                                            data: value.data,
-                                            type: frameType,
-                                            timestamp: Date.now(),
-                                            keyFrame: value.keyFrame
-                                        });
+                                        videoSender.send(value);
                                     }
                                 } catch (error) {
                                     console.error('error processing video stream:', error);

package/dist/es/index.mjs

@@ -184,9 +184,67 @@ function _define_property(obj, key, value) {
     else obj[key] = value;
     return obj;
 }
+const SCRCPY_MAX_IN_FLIGHT_BYTES = 8388608;
+const SCRCPY_MAX_IN_FLIGHT_PACKETS = 256;
+const SCRCPY_VIDEO_ACK_TIMEOUT_MS = 10000;
+const debug = getDebug('android:playground:video', {
+    console: true
+});
+function buildScrcpyVideoPacket(packet, timestamp = Date.now()) {
+    return {
+        data: packet.data,
+        type: packet.type,
+        timestamp,
+        keyFrame: 'data' === packet.type ? packet.keyframe : void 0
+    };
+}
+class ScrcpyVideoSender {
+    fail(message) {
+        if (this.failed) return;
+        this.failed = true;
+        debug(message);
+        this.socket.conn.close(true);
+    }
+    send(packet) {
+        if (this.failed || !this.socket.connected) throw new Error('Cannot send video on a closed scrcpy connection');
+        const bytes = packet.data.byteLength;
+        if (this.inFlightPackets >= SCRCPY_MAX_IN_FLIGHT_PACKETS || this.inFlightBytes + bytes > SCRCPY_MAX_IN_FLIGHT_BYTES) {
+            const message = 'Scrcpy video receiver is too slow; reconnecting preview';
+            this.fail(message);
+            throw new Error(message);
+        }
+        this.inFlightBytes += bytes;
+        this.inFlightPackets += 1;
+        this.socket.timeout(SCRCPY_VIDEO_ACK_TIMEOUT_MS).emit('video-data', buildScrcpyVideoPacket(packet), (error)=>{
+            this.inFlightBytes -= bytes;
+            this.inFlightPackets -= 1;
+            if (error && this.socket.connected) this.fail('Scrcpy video acknowledgement timed out; reconnecting preview');
+        });
+    }
+    constructor(socket){
+        _define_property(this, "socket", void 0);
+        _define_property(this, "inFlightBytes", void 0);
+        _define_property(this, "inFlightPackets", void 0);
+        _define_property(this, "failed", void 0);
+        this.socket = socket;
+        this.inFlightBytes = 0;
+        this.inFlightPackets = 0;
+        this.failed = false;
+    }
+}
+function timeout_define_property(obj, key, value) {
+    if (key in obj) Object.defineProperty(obj, key, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
+    });
+    else obj[key] = value;
+    return obj;
+}
 class PromiseTimeoutError extends Error {
     constructor(message, timeoutMs){
-        super(message), _define_property(this, "timeoutMs", void 0);
+        super(message), timeout_define_property(this, "timeoutMs", void 0);
         this.name = 'PromiseTimeoutError';
         this.timeoutMs = timeoutMs;
     }
@@ -410,6 +468,7 @@ class ScrcpyServer {
             let activeSession = null;
             let sessionGeneration = 0;
             let adb = null;
+            const videoSender = new ScrcpyVideoSender(socket);
             const closeScrcpySession = async (reason, sessionToClose = activeSession)=>{
                 if (!sessionToClose) return;
                 sessionToClose.closeReason ??= reason;
@@ -567,13 +626,7 @@ class ScrcpyServer {
                                         const { done, value } = await reader.read();
                                         if (done) break;
                                         if (!isCurrentGeneration() || activeSession !== streamSession) return;
-                                        const frameType = value.type || 'data';
-                                        socket.volatile.emit('video-data', {
-                                            data: value.data,
-                                            type: frameType,
-                                            timestamp: Date.now(),
-                                            keyFrame: value.keyFrame
-                                        });
+                                        videoSender.send(value);
                                     }
                                 } catch (error) {
                                     console.error('error processing video stream:', error);

package/dist/lib/bin.js

@@ -210,9 +210,67 @@ function _define_property(obj, key, value) {
     else obj[key] = value;
     return obj;
 }
+const SCRCPY_MAX_IN_FLIGHT_BYTES = 8388608;
+const SCRCPY_MAX_IN_FLIGHT_PACKETS = 256;
+const SCRCPY_VIDEO_ACK_TIMEOUT_MS = 10000;
+const debug = (0, logger_namespaceObject.getDebug)('android:playground:video', {
+    console: true
+});
+function buildScrcpyVideoPacket(packet, timestamp = Date.now()) {
+    return {
+        data: packet.data,
+        type: packet.type,
+        timestamp,
+        keyFrame: 'data' === packet.type ? packet.keyframe : void 0
+    };
+}
+class ScrcpyVideoSender {
+    fail(message) {
+        if (this.failed) return;
+        this.failed = true;
+        debug(message);
+        this.socket.conn.close(true);
+    }
+    send(packet) {
+        if (this.failed || !this.socket.connected) throw new Error('Cannot send video on a closed scrcpy connection');
+        const bytes = packet.data.byteLength;
+        if (this.inFlightPackets >= SCRCPY_MAX_IN_FLIGHT_PACKETS || this.inFlightBytes + bytes > SCRCPY_MAX_IN_FLIGHT_BYTES) {
+            const message = 'Scrcpy video receiver is too slow; reconnecting preview';
+            this.fail(message);
+            throw new Error(message);
+        }
+        this.inFlightBytes += bytes;
+        this.inFlightPackets += 1;
+        this.socket.timeout(SCRCPY_VIDEO_ACK_TIMEOUT_MS).emit('video-data', buildScrcpyVideoPacket(packet), (error)=>{
+            this.inFlightBytes -= bytes;
+            this.inFlightPackets -= 1;
+            if (error && this.socket.connected) this.fail('Scrcpy video acknowledgement timed out; reconnecting preview');
+        });
+    }
+    constructor(socket){
+        _define_property(this, "socket", void 0);
+        _define_property(this, "inFlightBytes", void 0);
+        _define_property(this, "inFlightPackets", void 0);
+        _define_property(this, "failed", void 0);
+        this.socket = socket;
+        this.inFlightBytes = 0;
+        this.inFlightPackets = 0;
+        this.failed = false;
+    }
+}
+function timeout_define_property(obj, key, value) {
+    if (key in obj) Object.defineProperty(obj, key, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
+    });
+    else obj[key] = value;
+    return obj;
+}
 class PromiseTimeoutError extends Error {
     constructor(message, timeoutMs){
-        super(message), _define_property(this, "timeoutMs", void 0);
+        super(message), timeout_define_property(this, "timeoutMs", void 0);
         this.name = 'PromiseTimeoutError';
         this.timeoutMs = timeoutMs;
     }
@@ -436,6 +494,7 @@ class ScrcpyServer {
             let activeSession = null;
             let sessionGeneration = 0;
             let adb = null;
+            const videoSender = new ScrcpyVideoSender(socket);
             const closeScrcpySession = async (reason, sessionToClose = activeSession)=>{
                 if (!sessionToClose) return;
                 sessionToClose.closeReason ??= reason;
@@ -593,13 +652,7 @@ class ScrcpyServer {
                                         const { done, value } = await reader.read();
                                         if (done) break;
                                         if (!isCurrentGeneration() || activeSession !== streamSession) return;
-                                        const frameType = value.type || 'data';
-                                        socket.volatile.emit('video-data', {
-                                            data: value.data,
-                                            type: frameType,
-                                            timestamp: Date.now(),
-                                            keyFrame: value.keyFrame
-                                        });
+                                        videoSender.send(value);
                                     }
                                 } catch (error) {
                                     console.error('error processing video stream:', error);

package/dist/lib/index.js

@@ -225,9 +225,67 @@ function _define_property(obj, key, value) {
     else obj[key] = value;
     return obj;
 }
+const SCRCPY_MAX_IN_FLIGHT_BYTES = 8388608;
+const SCRCPY_MAX_IN_FLIGHT_PACKETS = 256;
+const SCRCPY_VIDEO_ACK_TIMEOUT_MS = 10000;
+const debug = (0, logger_namespaceObject.getDebug)('android:playground:video', {
+    console: true
+});
+function buildScrcpyVideoPacket(packet, timestamp = Date.now()) {
+    return {
+        data: packet.data,
+        type: packet.type,
+        timestamp,
+        keyFrame: 'data' === packet.type ? packet.keyframe : void 0
+    };
+}
+class ScrcpyVideoSender {
+    fail(message) {
+        if (this.failed) return;
+        this.failed = true;
+        debug(message);
+        this.socket.conn.close(true);
+    }
+    send(packet) {
+        if (this.failed || !this.socket.connected) throw new Error('Cannot send video on a closed scrcpy connection');
+        const bytes = packet.data.byteLength;
+        if (this.inFlightPackets >= SCRCPY_MAX_IN_FLIGHT_PACKETS || this.inFlightBytes + bytes > SCRCPY_MAX_IN_FLIGHT_BYTES) {
+            const message = 'Scrcpy video receiver is too slow; reconnecting preview';
+            this.fail(message);
+            throw new Error(message);
+        }
+        this.inFlightBytes += bytes;
+        this.inFlightPackets += 1;
+        this.socket.timeout(SCRCPY_VIDEO_ACK_TIMEOUT_MS).emit('video-data', buildScrcpyVideoPacket(packet), (error)=>{
+            this.inFlightBytes -= bytes;
+            this.inFlightPackets -= 1;
+            if (error && this.socket.connected) this.fail('Scrcpy video acknowledgement timed out; reconnecting preview');
+        });
+    }
+    constructor(socket){
+        _define_property(this, "socket", void 0);
+        _define_property(this, "inFlightBytes", void 0);
+        _define_property(this, "inFlightPackets", void 0);
+        _define_property(this, "failed", void 0);
+        this.socket = socket;
+        this.inFlightBytes = 0;
+        this.inFlightPackets = 0;
+        this.failed = false;
+    }
+}
+function timeout_define_property(obj, key, value) {
+    if (key in obj) Object.defineProperty(obj, key, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
+    });
+    else obj[key] = value;
+    return obj;
+}
 class PromiseTimeoutError extends Error {
     constructor(message, timeoutMs){
-        super(message), _define_property(this, "timeoutMs", void 0);
+        super(message), timeout_define_property(this, "timeoutMs", void 0);
         this.name = 'PromiseTimeoutError';
         this.timeoutMs = timeoutMs;
     }
@@ -451,6 +509,7 @@ class ScrcpyServer {
             let activeSession = null;
             let sessionGeneration = 0;
             let adb = null;
+            const videoSender = new ScrcpyVideoSender(socket);
             const closeScrcpySession = async (reason, sessionToClose = activeSession)=>{
                 if (!sessionToClose) return;
                 sessionToClose.closeReason ??= reason;
@@ -608,13 +667,7 @@ class ScrcpyServer {
                                         const { done, value } = await reader.read();
                                         if (done) break;
                                         if (!isCurrentGeneration() || activeSession !== streamSession) return;
-                                        const frameType = value.type || 'data';
-                                        socket.volatile.emit('video-data', {
-                                            data: value.data,
-                                            type: frameType,
-                                            timestamp: Date.now(),
-                                            keyFrame: value.keyFrame
-                                        });
+                                        videoSender.send(value);
                                     }
                                 } catch (error) {
                                     console.error('error processing video stream:', error);

package/dist/types/scrcpy-video-sender.d.ts

@@ -0,0 +1,20 @@
+import type { ScrcpyMediaStreamPacket } from '@yume-chan/scrcpy';
+import type { Socket } from 'socket.io';
+export declare const SCRCPY_MAX_IN_FLIGHT_BYTES: number;
+export declare const SCRCPY_MAX_IN_FLIGHT_PACKETS = 256;
+export declare const SCRCPY_VIDEO_ACK_TIMEOUT_MS = 10000;
+export declare function buildScrcpyVideoPacket(packet: ScrcpyMediaStreamPacket, timestamp?: number): {
+    data: Uint8Array<ArrayBufferLike>;
+    type: "configuration" | "data";
+    timestamp: number;
+    keyFrame: boolean | undefined;
+};
+export declare class ScrcpyVideoSender {
+    private readonly socket;
+    private inFlightBytes;
+    private inFlightPackets;
+    private failed;
+    constructor(socket: Socket);
+    private fail;
+    send(packet: ScrcpyMediaStreamPacket): void;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@midscene/android-playground",
-  "version": "1.12.7-beta-20260914023554.0",
+  "version": "1.12.7",
   "repository": {
     "type": "git",
     "url": "https://github.com/web-infra-dev/midscene.git",
@@ -39,10 +39,10 @@
     "express": "^4.21.2",
     "open": "10.1.0",
     "socket.io": "^4.8.1",
-    "@midscene/core": "1.12.7-beta-20260914023554.0",
-    "@midscene/android": "1.12.7-beta-20260914023554.0",
-    "@midscene/shared": "1.12.7-beta-20260914023554.0",
-    "@midscene/playground": "1.12.7-beta-20260914023554.0"
+    "@midscene/android": "1.12.7",
+    "@midscene/core": "1.12.7",
+    "@midscene/playground": "1.12.7",
+    "@midscene/shared": "1.12.7"
   },
   "devDependencies": {
     "@rslib/core": "^0.18.3",
@@ -50,6 +50,7 @@
     "@types/cors": "^2.8.17",
     "@types/express": "^4.17.21",
     "@types/node": "^18.0.0",
+    "socket.io-client": "4.8.1",
     "typescript": "^5.8.3"
   },
   "license": "MIT",

package/static/index.html

@@ -1 +1 @@
-<!doctype html><html><head><title>Midscene Android Playground</title><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><script defer src="/static/js/lib-react.574e3de9.js"></script><script defer src="/static/js/415.dadb20cf.js"></script><script defer src="/static/js/index.0ce47ddb.js"></script><link href="/static/css/index.67caac18.css" rel="stylesheet"></head><body><div id="root"></div></body></html>
+<!doctype html><html><head><title>Midscene Android Playground</title><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><script defer src="/static/js/lib-react.574e3de9.js"></script><script defer src="/static/js/415.dadb20cf.js"></script><script defer src="/static/js/index.6736e95a.js"></script><link href="/static/css/index.67caac18.css" rel="stylesheet"></head><body><div id="root"></div></body></html>