This is a beta feature currently in testing phase. Please note that physical
device availability may be limited, and some functionalities might experience
occasional instability. We appreciate your feedback to help us improve this
feature.
GBOX provides cloud physical devices through https://gbox.ai. You can instantly start cloud physical Android devices and operate through GBOX SDK/MCP/CLI. You can also register your local Android devices to gbox.ai and operate in the same way as cloud ones. Register Local AndroidNote: Virtual devices created through Android Studio locally are treated as local physical devices.
import GboxSDK from "gbox-sdk";import * as dotenv from "dotenv";dotenv.config();const gboxSDK = new GboxSDK({ apiKey: process.env["GBOX_API_KEY"], // This is the default and can be omitted});async function main() { const box = await gboxSDK.create({ type: "android", config: { deviceType: "physical", }, }); console.log(`Android box created: ${box.data.id}`); const liveView = await box.liveView(); console.log(`Live view URL: ${liveView.url}`);}main();
If you want to connect to a local real device,here is the tutorial:
Refer to the Register Local Device to register your real device to the cloud and get the corresponding device ID.
Enter the device ID in the SDK parameter below and execute:
Copy
Ask AI
import GboxSDK from "gbox-sdk";import * as dotenv from "dotenv";dotenv.config();const gboxSDK = new GboxSDK({ apiKey: process.env["GBOX_API_KEY"], // This is the default and can be omitted});async function main() { const box = await gboxSDK.create({ type: "android", config: { deviceType: "physical", labels: { "gbox.ai/device-id": "YOUR_DEVICE_ID", // Replace with your device ID }, }, }); console.log(`Android box created: ${box.data.id}`); const liveView = await box.liveView(); console.log(`Live view URL: ${liveView.url}`);}main();