Devicebase介绍

Devicebase 为 AI Agent 提供了一套完整、可靠的设备控制 API，覆盖手机、浏览器与电脑设备，从基础操作到高级自动化的全场景需求。

核心能力

设备列表与管理

获取已接入的设备列表，查看设备实时状态，调度空闲设备进行任务。

  • 列出所有设备
  • 按状态筛选
  • 设备属性查询
  • 批量操作
python-devicebase-sdk
# 序列号由设备列表发现，无需预先知道
from devicebase import list_devices

for device in list_devices(device_type="mobile", state="free"):
    print(device.serialno, device.state, device.model)

屏幕截图与录制

实时获取设备屏幕截图，录制操作视频，用于 Agent 可视化判断和结果验证。

  • 即时截图 (<100ms)
  • 持续屏幕流
  • 视频录制
  • 多分辨率支持
python-devicebase-sdk
from devicebase import DeviceBaseClient

with DeviceBaseClient(api_key="your-api-key", serialno="your-serialno") as client:
    # 截取设备屏幕（JPEG 字节流）
    screenshot_bytes = client.get_screenshot()

设备操作命令

执行各种设备操作命令，包括点击、滑动、输入文本等模拟用户交互的操作。

  • 模拟触摸点击
  • 长按滑动
  • 文本输入
  • 按键事件
python-devicebase-sdk
from devicebase import DeviceBaseClient

with DeviceBaseClient(api_key="your-api-key", serialno="your-serialno") as client:
    # 执行自动化命令（坐标为整数）
    client.tap(100, 200)
    client.launch_app("com.tencent.mm")

浏览器自动化

通过统一 REST API 控制远程浏览器（Chromium/CDP）。AI Agent 可导航网页、操作多标签、点击与填写表单、读取页面文本和 DOM 属性，完成网页注册、搜索、数据采集等任务；也可切换到网页远程操作台人工接管。

  • URL 导航与刷新
  • 前进 / 后退 / 多标签管理
  • 点击 / 填写 / 下拉选择
  • 页面文本与属性读取
  • 执行 JavaScript
  • 快捷键与浏览器启动/关闭
python-devicebase-sdk
from devicebase import DeviceBaseHttpClient

with DeviceBaseHttpClient(api_key="your-api-key") as client:
    # 浏览器设备的 serialno 来自设备列表
    serialno = "your-serialno"
    client.browser_navigate(serialno, "https://devicebase.cn")
    client.browser_fill(serialno, "#search", "devicebase")
    print(client.browser_text(serialno, "#search").payload)

电脑桌面控制

通过统一 REST API 控制远程电脑桌面（nut-js 输入注入）。AI Agent 可移动并点击鼠标、拖拽与滚动、键入文本、触发系统快捷键、启动应用，完成桌面软件操作等真实工作流；同样提供网页远程操作台人工接管。

  • 鼠标移动 / 单击 / 双击 / 拖拽
  • 滚轮滚动
  • 键盘键入文本与按键
  • 系统级快捷键
  • 启动应用程序
  • 屏幕尺寸与鼠标位置读取
python-devicebase-sdk
from devicebase import DeviceBaseHttpClient

with DeviceBaseHttpClient(api_key="your-api-key") as client:
    # 电脑设备的 serialno 来自设备列表
    serialno = "your-serialno"
    client.computer_click(serialno, 960, 540)
    client.computer_scroll(serialno, "down", amount=3)
    client.computer_type_text(serialno, "hello, devicebase")
    client.computer_hotkey(serialno, ["Meta", "c"])

接入自有设备

通过 Devicebase 客户端将你的自有设备接入平台。USB 连接手机/平板，客户端自动发现并注册设备，让你的真实设备可供 AI Agent 或代码远程调用。

  • USB 即插即用
  • 自动发现与注册
  • 多设备同时接入
  • 支持 macOS / Windows / Linux

Devicebase 客户端

轻量级 PC 代理程序 · 自动发现设备
支持 macOS / Windows / Linux

免费下载

完整功能列表

我们提供的能力覆盖了 AI Agent 控制真实设备的各个方面

设备列表查询
设备状态监控
屏幕截图
实时屏幕流
屏幕录制
触摸操作
文本输入
应用安装/卸载
应用启动/停止
剪贴板操作
系统信息获取
设备性能监控
权限管理
设备重启
使用量统计
自有设备 USB 接入
设备自动发现与注册
多设备并行管理
浏览器页面导航
浏览器点击/填写
浏览器页面内容读取
浏览器多标签管理
电脑鼠标与滚轮控制
电脑键盘输入与快捷键