Physical Device

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 Android

Note: Virtual devices created through Android Studio locally are treated as local physical devices.

Key Features

• Real Hardware: Access to actual physical Android devices, not emulators
• Remote Control: Full touch, swipe, and gesture support
• Live View: Real-time screen streaming with minimal latency

Usage

How to create a box using cloud physical device

Typescript

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();

import os
from dotenv import load_dotenv
from gbox_sdk import GboxSDK

# Load environment variables from .env file
load_dotenv()

def main():
    api_key = os.getenv("GBOX_API_KEY")
    gbox = GboxSDK(api_key=api_key)

    box = gbox.create(
        type="android",
        config={
            "deviceType": "physical",
        }
    )

    print(f"Android box created: {box.data.id}")

    live_view = box.live_view()

    print(f"Live view URL: {live_view.url}")

if __name__ == "__main__":
    main()

Create a box using local Android device

If you want to connect to a local real device,here is the tutorial:

1. Refer to the Register Local Device to register your real device to the cloud and get the corresponding device ID.

2. Enter the device ID in the SDK parameter below and execute:

Typescript

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();

import os
from dotenv import load_dotenv
from gbox_sdk import GboxSDK

# Load environment variables from .env file
load_dotenv()

def main():
    api_key = os.getenv("GBOX_API_KEY")
    gbox = GboxSDK(api_key=api_key)

    box = gbox.create(
        type="android",
        config={
            "deviceType": "physical",
            "labels":{
                "gbox.ai/device-id": "YOUR_DEVICE_ID" # Replace with your device ID
            }
        }
    )

    print(f"Android box created: {box.data.id}")

    live_view = box.live_view()

    print(f"Live view URL: {live_view.url}")

if __name__ == "__main__":
    main()