@midscene/android-playground 1.12.4 → 1.12.5-beta-20260907092148.0

package/dist/es/bin.mjs

@@ -47,6 +47,13 @@ const androidPlaygroundPlatform = definePlaygroundPlatform({
             options?.scrcpyPort ? Promise.resolve(options.scrcpyPort) : findAvailablePort(SCRCPY_SERVER_PORT)
         ]);
         const scrcpyPort = resolvedScrcpyPort;
+        const scrcpyHost = options?.scrcpyServer?.host;
+        const scrcpyPreviewOptions = {
+            scrcpyPort,
+            ...scrcpyHost ? {
+                scrcpyHost
+            } : {}
+        };
         if (playgroundPort !== PLAYGROUND_SERVER_PORT) console.log(`⚠️  Port ${PLAYGROUND_SERVER_PORT} is busy, using port ${playgroundPort} instead`);
         if (scrcpyPort !== SCRCPY_SERVER_PORT) console.log(`⚠️  Port ${SCRCPY_SERVER_PORT} is busy, using port ${scrcpyPort} instead`);
         const sessionManager = {
@@ -95,9 +102,7 @@ const androidPlaygroundPlatform = definePlaygroundPlatform({
                 return {
                     agent,
                     agentFactory: connectAgent,
-                    preview: createScrcpyPreviewDescriptor({
-                        scrcpyPort
-                    }, {
+                    preview: createScrcpyPreviewDescriptor(scrcpyPreviewOptions, {
                         title: 'Android device preview'
                     }),
                     displayName: deviceId,
@@ -132,9 +137,7 @@ const androidPlaygroundPlatform = definePlaygroundPlatform({
                     server.scrcpyPort = scrcpyPort;
                 }
             },
-            preview: createScrcpyPreviewDescriptor({
-                scrcpyPort
-            }, {
+            preview: createScrcpyPreviewDescriptor(scrcpyPreviewOptions, {
                 title: 'Android device preview'
             }),
             metadata: {
@@ -612,11 +615,16 @@ class ScrcpyServer {
         });
     }
     async launch(port) {
-        this.port = port || this.defaultPort;
-        return new Promise((resolve)=>{
+        this.port = port ?? this.defaultPort;
+        return new Promise((resolve, reject)=>{
             const listenPort = this.port ?? this.defaultPort;
-            this.httpServer.listen(listenPort, '0.0.0.0', ()=>{
-                console.log(`Scrcpy server running at: http://0.0.0.0:${this.port}`);
+            const onError = (error)=>reject(error);
+            this.httpServer.once('error', onError);
+            this.httpServer.listen(listenPort, this.host, ()=>{
+                this.httpServer.off('error', onError);
+                const address = this.httpServer.address();
+                if (address && 'string' != typeof address) this.port = address.port;
+                console.log(`Scrcpy server running at: http://${this.host}:${this.port}`);
                 this.startDeviceMonitoring();
                 resolve(this);
             });
@@ -663,9 +671,12 @@ class ScrcpyServer {
         scrcpy_server_define_property(this, "adbClient", null);
         scrcpy_server_define_property(this, "currentDeviceId", null);
         scrcpy_server_define_property(this, "devicePollInterval", null);
+        scrcpy_server_define_property(this, "host", void 0);
         scrcpy_server_define_property(this, "deviceListSource", void 0);
         scrcpy_server_define_property(this, "deviceListSourceUnsubscribe", void 0);
         scrcpy_server_define_property(this, "lastDeviceList", '');
+        this.host = options.host ?? '127.0.0.1';
+        if (!this.host.trim()) throw new Error('Scrcpy host must not be empty');
         this.deviceListSource = options.deviceListSource;
         this.app = express();
         this.httpServer = createServer(this.app);
@@ -697,7 +708,9 @@ const bin_staticDir = node_path.join(__dirname, '../../static');
 const main = async ()=>{
     const { default: open } = await import("open");
     try {
-        const scrcpyServer = new ScrcpyServer();
+        const scrcpyServer = new ScrcpyServer({
+            host: process.env.MIDSCENE_SCRCPY_HOST
+        });
         const prepared = await androidPlaygroundPlatform.prepare({
             staticDir: bin_staticDir,
             scrcpyServer

package/dist/es/index.mjs

@@ -47,6 +47,13 @@ const androidPlaygroundPlatform = definePlaygroundPlatform({
             options?.scrcpyPort ? Promise.resolve(options.scrcpyPort) : findAvailablePort(SCRCPY_SERVER_PORT)
         ]);
         const scrcpyPort = resolvedScrcpyPort;
+        const scrcpyHost = options?.scrcpyServer?.host;
+        const scrcpyPreviewOptions = {
+            scrcpyPort,
+            ...scrcpyHost ? {
+                scrcpyHost
+            } : {}
+        };
         if (playgroundPort !== PLAYGROUND_SERVER_PORT) console.log(`⚠️  Port ${PLAYGROUND_SERVER_PORT} is busy, using port ${playgroundPort} instead`);
         if (scrcpyPort !== SCRCPY_SERVER_PORT) console.log(`⚠️  Port ${SCRCPY_SERVER_PORT} is busy, using port ${scrcpyPort} instead`);
         const sessionManager = {
@@ -95,9 +102,7 @@ const androidPlaygroundPlatform = definePlaygroundPlatform({
                 return {
                     agent,
                     agentFactory: connectAgent,
-                    preview: createScrcpyPreviewDescriptor({
-                        scrcpyPort
-                    }, {
+                    preview: createScrcpyPreviewDescriptor(scrcpyPreviewOptions, {
                         title: 'Android device preview'
                     }),
                     displayName: deviceId,
@@ -132,9 +137,7 @@ const androidPlaygroundPlatform = definePlaygroundPlatform({
                     server.scrcpyPort = scrcpyPort;
                 }
             },
-            preview: createScrcpyPreviewDescriptor({
-                scrcpyPort
-            }, {
+            preview: createScrcpyPreviewDescriptor(scrcpyPreviewOptions, {
                 title: 'Android device preview'
             }),
             metadata: {
@@ -612,11 +615,16 @@ class ScrcpyServer {
         });
     }
     async launch(port) {
-        this.port = port || this.defaultPort;
-        return new Promise((resolve)=>{
+        this.port = port ?? this.defaultPort;
+        return new Promise((resolve, reject)=>{
             const listenPort = this.port ?? this.defaultPort;
-            this.httpServer.listen(listenPort, '0.0.0.0', ()=>{
-                console.log(`Scrcpy server running at: http://0.0.0.0:${this.port}`);
+            const onError = (error)=>reject(error);
+            this.httpServer.once('error', onError);
+            this.httpServer.listen(listenPort, this.host, ()=>{
+                this.httpServer.off('error', onError);
+                const address = this.httpServer.address();
+                if (address && 'string' != typeof address) this.port = address.port;
+                console.log(`Scrcpy server running at: http://${this.host}:${this.port}`);
                 this.startDeviceMonitoring();
                 resolve(this);
             });
@@ -663,9 +671,12 @@ class ScrcpyServer {
         scrcpy_server_define_property(this, "adbClient", null);
         scrcpy_server_define_property(this, "currentDeviceId", null);
         scrcpy_server_define_property(this, "devicePollInterval", null);
+        scrcpy_server_define_property(this, "host", void 0);
         scrcpy_server_define_property(this, "deviceListSource", void 0);
         scrcpy_server_define_property(this, "deviceListSourceUnsubscribe", void 0);
         scrcpy_server_define_property(this, "lastDeviceList", '');
+        this.host = options.host ?? '127.0.0.1';
+        if (!this.host.trim()) throw new Error('Scrcpy host must not be empty');
         this.deviceListSource = options.deviceListSource;
         this.app = express();
         this.httpServer = createServer(this.app);

package/dist/lib/bin.js

@@ -63,6 +63,13 @@ const androidPlaygroundPlatform = (0, playground_namespaceObject.definePlaygroun
             options?.scrcpyPort ? Promise.resolve(options.scrcpyPort) : (0, node_namespaceObject.findAvailablePort)(constants_namespaceObject.SCRCPY_SERVER_PORT)
         ]);
         const scrcpyPort = resolvedScrcpyPort;
+        const scrcpyHost = options?.scrcpyServer?.host;
+        const scrcpyPreviewOptions = {
+            scrcpyPort,
+            ...scrcpyHost ? {
+                scrcpyHost
+            } : {}
+        };
         if (playgroundPort !== constants_namespaceObject.PLAYGROUND_SERVER_PORT) console.log(`⚠️  Port ${constants_namespaceObject.PLAYGROUND_SERVER_PORT} is busy, using port ${playgroundPort} instead`);
         if (scrcpyPort !== constants_namespaceObject.SCRCPY_SERVER_PORT) console.log(`⚠️  Port ${constants_namespaceObject.SCRCPY_SERVER_PORT} is busy, using port ${scrcpyPort} instead`);
         const sessionManager = {
@@ -111,9 +118,7 @@ const androidPlaygroundPlatform = (0, playground_namespaceObject.definePlaygroun
                 return {
                     agent,
                     agentFactory: connectAgent,
-                    preview: (0, playground_namespaceObject.createScrcpyPreviewDescriptor)({
-                        scrcpyPort
-                    }, {
+                    preview: (0, playground_namespaceObject.createScrcpyPreviewDescriptor)(scrcpyPreviewOptions, {
                         title: 'Android device preview'
                     }),
                     displayName: deviceId,
@@ -148,9 +153,7 @@ const androidPlaygroundPlatform = (0, playground_namespaceObject.definePlaygroun
                     server.scrcpyPort = scrcpyPort;
                 }
             },
-            preview: (0, playground_namespaceObject.createScrcpyPreviewDescriptor)({
-                scrcpyPort
-            }, {
+            preview: (0, playground_namespaceObject.createScrcpyPreviewDescriptor)(scrcpyPreviewOptions, {
                 title: 'Android device preview'
             }),
             metadata: {
@@ -638,11 +641,16 @@ class ScrcpyServer {
         });
     }
     async launch(port) {
-        this.port = port || this.defaultPort;
-        return new Promise((resolve)=>{
+        this.port = port ?? this.defaultPort;
+        return new Promise((resolve, reject)=>{
             const listenPort = this.port ?? this.defaultPort;
-            this.httpServer.listen(listenPort, '0.0.0.0', ()=>{
-                console.log(`Scrcpy server running at: http://0.0.0.0:${this.port}`);
+            const onError = (error)=>reject(error);
+            this.httpServer.once('error', onError);
+            this.httpServer.listen(listenPort, this.host, ()=>{
+                this.httpServer.off('error', onError);
+                const address = this.httpServer.address();
+                if (address && 'string' != typeof address) this.port = address.port;
+                console.log(`Scrcpy server running at: http://${this.host}:${this.port}`);
                 this.startDeviceMonitoring();
                 resolve(this);
             });
@@ -689,9 +697,12 @@ class ScrcpyServer {
         scrcpy_server_define_property(this, "adbClient", null);
         scrcpy_server_define_property(this, "currentDeviceId", null);
         scrcpy_server_define_property(this, "devicePollInterval", null);
+        scrcpy_server_define_property(this, "host", void 0);
         scrcpy_server_define_property(this, "deviceListSource", void 0);
         scrcpy_server_define_property(this, "deviceListSourceUnsubscribe", void 0);
         scrcpy_server_define_property(this, "lastDeviceList", '');
+        this.host = options.host ?? '127.0.0.1';
+        if (!this.host.trim()) throw new Error('Scrcpy host must not be empty');
         this.deviceListSource = options.deviceListSource;
         this.app = external_express_default()();
         this.httpServer = (0, external_node_http_namespaceObject.createServer)(this.app);
@@ -723,7 +734,9 @@ const bin_staticDir = external_node_path_default().join(__dirname, '../../static
 const main = async ()=>{
     const { default: open } = await import("open");
     try {
-        const scrcpyServer = new ScrcpyServer();
+        const scrcpyServer = new ScrcpyServer({
+            host: process.env.MIDSCENE_SCRCPY_HOST
+        });
         const prepared = await androidPlaygroundPlatform.prepare({
             staticDir: bin_staticDir,
             scrcpyServer

package/dist/lib/index.js

@@ -78,6 +78,13 @@ const androidPlaygroundPlatform = (0, playground_namespaceObject.definePlaygroun
             options?.scrcpyPort ? Promise.resolve(options.scrcpyPort) : (0, node_namespaceObject.findAvailablePort)(constants_namespaceObject.SCRCPY_SERVER_PORT)
         ]);
         const scrcpyPort = resolvedScrcpyPort;
+        const scrcpyHost = options?.scrcpyServer?.host;
+        const scrcpyPreviewOptions = {
+            scrcpyPort,
+            ...scrcpyHost ? {
+                scrcpyHost
+            } : {}
+        };
         if (playgroundPort !== constants_namespaceObject.PLAYGROUND_SERVER_PORT) console.log(`⚠️  Port ${constants_namespaceObject.PLAYGROUND_SERVER_PORT} is busy, using port ${playgroundPort} instead`);
         if (scrcpyPort !== constants_namespaceObject.SCRCPY_SERVER_PORT) console.log(`⚠️  Port ${constants_namespaceObject.SCRCPY_SERVER_PORT} is busy, using port ${scrcpyPort} instead`);
         const sessionManager = {
@@ -126,9 +133,7 @@ const androidPlaygroundPlatform = (0, playground_namespaceObject.definePlaygroun
                 return {
                     agent,
                     agentFactory: connectAgent,
-                    preview: (0, playground_namespaceObject.createScrcpyPreviewDescriptor)({
-                        scrcpyPort
-                    }, {
+                    preview: (0, playground_namespaceObject.createScrcpyPreviewDescriptor)(scrcpyPreviewOptions, {
                         title: 'Android device preview'
                     }),
                     displayName: deviceId,
@@ -163,9 +168,7 @@ const androidPlaygroundPlatform = (0, playground_namespaceObject.definePlaygroun
                     server.scrcpyPort = scrcpyPort;
                 }
             },
-            preview: (0, playground_namespaceObject.createScrcpyPreviewDescriptor)({
-                scrcpyPort
-            }, {
+            preview: (0, playground_namespaceObject.createScrcpyPreviewDescriptor)(scrcpyPreviewOptions, {
                 title: 'Android device preview'
             }),
             metadata: {
@@ -653,11 +656,16 @@ class ScrcpyServer {
         });
     }
     async launch(port) {
-        this.port = port || this.defaultPort;
-        return new Promise((resolve)=>{
+        this.port = port ?? this.defaultPort;
+        return new Promise((resolve, reject)=>{
             const listenPort = this.port ?? this.defaultPort;
-            this.httpServer.listen(listenPort, '0.0.0.0', ()=>{
-                console.log(`Scrcpy server running at: http://0.0.0.0:${this.port}`);
+            const onError = (error)=>reject(error);
+            this.httpServer.once('error', onError);
+            this.httpServer.listen(listenPort, this.host, ()=>{
+                this.httpServer.off('error', onError);
+                const address = this.httpServer.address();
+                if (address && 'string' != typeof address) this.port = address.port;
+                console.log(`Scrcpy server running at: http://${this.host}:${this.port}`);
                 this.startDeviceMonitoring();
                 resolve(this);
             });
@@ -704,9 +712,12 @@ class ScrcpyServer {
         scrcpy_server_define_property(this, "adbClient", null);
         scrcpy_server_define_property(this, "currentDeviceId", null);
         scrcpy_server_define_property(this, "devicePollInterval", null);
+        scrcpy_server_define_property(this, "host", void 0);
         scrcpy_server_define_property(this, "deviceListSource", void 0);
         scrcpy_server_define_property(this, "deviceListSourceUnsubscribe", void 0);
         scrcpy_server_define_property(this, "lastDeviceList", '');
+        this.host = options.host ?? '127.0.0.1';
+        if (!this.host.trim()) throw new Error('Scrcpy host must not be empty');
         this.deviceListSource = options.deviceListSource;
         this.app = external_express_default()();
         this.httpServer = (0, external_node_http_namespaceObject.createServer)(this.app);

package/dist/types/platform.d.ts

@@ -1,5 +1,7 @@
 import { type AndroidAgentOpt } from '@midscene/android';
 export interface ScrcpyServerController {
+    /** Bind host, used to connect local Playground pages to this sidecar. */
+    readonly host?: string;
     currentDeviceId: string | null;
     launch(port?: number): Promise<unknown>;
     close(): unknown;

package/dist/types/scrcpy-server.d.ts

@@ -19,6 +19,8 @@ export interface ScrcpyDeviceListSource {
     subscribe(listener: (devices: ScrcpyListedDevice[]) => void): () => void;
 }
 export interface ScrcpyServerOptions {
+    /** Defaults to loopback. Set explicitly to expose previews remotely. */
+    host?: string;
     deviceListSource?: ScrcpyDeviceListSource;
 }
 export declare function resolveRequestedDeviceId(options: ScrcpyConnectDeviceRequest | undefined, currentDeviceId: string | null): string | undefined;
@@ -31,6 +33,7 @@ export default class ScrcpyServer {
     adbClient: AdbServerClient | null;
     currentDeviceId: string | null;
     devicePollInterval: NodeJS.Timeout | null;
+    readonly host: string;
     private deviceListSource?;
     private deviceListSourceUnsubscribe?;
     lastDeviceList: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@midscene/android-playground",
-  "version": "1.12.4",
+  "version": "1.12.5-beta-20260907092148.0",
   "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/android": "1.12.4",
-    "@midscene/playground": "1.12.4",
-    "@midscene/core": "1.12.4",
-    "@midscene/shared": "1.12.4"
+    "@midscene/android": "1.12.5-beta-20260907092148.0",
+    "@midscene/core": "1.12.5-beta-20260907092148.0",
+    "@midscene/playground": "1.12.5-beta-20260907092148.0",
+    "@midscene/shared": "1.12.5-beta-20260907092148.0"
   },
   "devDependencies": {
     "@rslib/core": "^0.18.3",

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.0769c3b5.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.fc4360f7.js"></script><link href="/static/css/index.67caac18.css" rel="stylesheet"></head><body><div id="root"></div></body></html>