USB AOA 直连 · Windows 桌面端

免 USB 调试
一根数据线装进电脑

黑猫投屏是基于 USB AOA 协议的安卓投屏与自动化平台——无需开启 USB 调试、免 root、免同一 WiFi。插线即投,键鼠回控,并把无障碍自动化、找图找色与识别引擎全部开放成本机 REST API。

免 USB 调试 免 root 免同一 WiFi 62 个本机 REST 接口 H.264 硬解
黑猫投屏 · 已连接
连接方式USB AOA · 免 USB 调试
视频管线H.264 硬解 最高 90fps
本机服务127.0.0.1:7799
0 个
对外 REST 接口 · 登录即用
0 fps
5 档画质上限 · H.264 硬解
0 依赖
免 USB 调试 · 免 root · 免 WiFi
0 kHz
立体声同步 · 每设备独立静音
CORE FEATURES

不只是投屏,是一台
可以编程的手机工作站

市面工具大多停在「看得到」。黑猫投屏把连接、控制、观察、识别四层能力全部做透,并开放给你已有的任何脚本语言。

01

AOA 直连,免 USB 调试

走 Android Open Accessory 配件协议,不开开发者模式、不装 ADB 驱动、不用同一 WiFi,插线授权即用;另有局域网无线模式扫码连接。

WinUSB 驱动自动安装 · 即插即用
02

HID 级注入回控

触摸与按键经 AOA HID 通道注入,比无障碍手势更底层;内置压感、面积、时序随机化与 ±1px 坐标微抖多维度拟人化,默认开启。

物理键盘全键转发 · 修饰键 + 6 键 rollover
03

无障碍能力全 REST 化

节点树查询、选择器查找等待、点击滑动、文本粘贴、窗口枚举、批量动作……无障碍即服务,本机 HTTP + WebSocket 全量暴露。

41 个 /api/a11y/* 接口 · 事件实时推送
04

共享内存找图找色

视频帧以命名共享内存暴露为标准 24bpp BMP,按键精灵、大漠、易语言、AutoHotkey、C、Python 一次映射长期保活,零拷贝不丢帧。

OpenFileMappingW 即接 · 旋转换分辨率不重建映射
05

本地验证码识别引擎

字符、数字、字母、滑块缺口、点选五类验证码本地 ONNX 推理,DirectML 加速——任意 DX12 显卡即可,不依赖在线接口。

/api/captcha/recognize · 毫秒级净耗时
06

多设备协同群控

框选协同组,触摸、按键、文本、文件一键广播到全部设备;文件分发并行传输、进度可视;多台同时投屏统一管理。

Task.WhenAll 并行 · 传输进度实时
INSIDE THE PRODUCT

四层能力,一条数据线

从插上线到跑起你的第一个自动化脚本,中间没有任何「配置环境」环节。

CONNECT · 连接

插线授权即投,无线扫码也行

手机端装好黑猫投屏 App,USB 线插上电脑,在手机上确认一次 AOA 配件授权,画面立刻出现。不需要开发者选项,不需要 adb devices,也不需要配置驱动路径。

  • WinUSB 驱动自动安装,首次连接零手工配置
  • 横竖屏自适应,分辨率变化实时通知、画面即时跟随
  • 局域网无线模式:手机扫码直连电脑网卡,自动推荐默认路由网段
  • 电量、设备信息随连接上报,状态一目了然
GET /api/devices
{
  "ok": true,
  "data": [
    {
      "path": "9A271FFAZ000QP",
      "model": "Pixel 4",
      "alias": "我的手机",
      "width": 1080, "height": 2400,
      "a11y_enabled": true,
      "active": true
    }
  ]
}
CONTROL · 控制

HID 注入:像真手机被摸了一下

点击、滑动、拖拽、系统键全部走 AOA HID 通道注入内核输入子系统,而非模拟无障碍手势。滑动自带多帧插值与仿人抖动,文本经输入法粘贴通道写入,绕开剪贴板嗅探。

  • 归一化坐标 0-1,换分辨率脚本不用改一个字
  • 多指触摸 finger_id 独立跟踪,复杂手势可拆解
  • 物理键盘实时转发成手机 HID 键盘,修饰键与 6 键 rollover 全支持
  • 拟人化默认开启:压感、接触面积、时序、±1px 坐标微抖
POST /api/hid/swipe
# 归一化坐标,自带多帧插值 + 仿人抖动
POST http://127.0.0.1:7799/api/hid/swipe
{
  "x1": 0.5, "y1": 0.72,
  "x2": 0.5, "y2": 0.30,
  "durationMs": 320
}

# 系统按键(返回主页)
POST /api/hid/syskey  { "key": "home" }
OBSERVE · 观察

无障碍即服务:41 个接口读屏写屏

Android 无障碍服务的节点树、选择器、动作、文本、焦点、窗口、通知全部 REST 化。你可以「读」屏幕——节点树、查找等待;也可以「写」屏幕——点击、滑动、粘贴、批量动作。

  • 选择器 + 等待语义:/api/a11y/wait-and-click 一步到位
  • 批量动作一次下发,减少往返延迟
  • WebSocket 实时推送无障碍事件与设备上下线
  • 坐标统一 0-1 归一化,像素坐标彻底退场
Python · 等待并点击
import requests

BASE = "http://127.0.0.1:7799"

requests.post(f"{BASE}/api/a11y/wait-and-click",
    json={
        "selector": {"text": "登录", "clickable": True},
        "timeout_ms": 8000,
    }, timeout=30).json()
# 出现即点,超时即报,无需轮询截图
VISION · 识别

共享内存找色 + 本地验证码识别

找图找色不必截图轮询:每台设备的视频帧实时写入命名共享内存(标准 24bpp BMP),你的进程一次 OpenFileMappingW 长期保活,零拷贝读取。验证码交给本地识别引擎——字符、数字、字母、滑块、点选五类全覆盖,ONNX + DirectML 本地推理。

  • 长边超 1080 自动下采样,旋转、换分辨率不重建映射
  • 识别接口无 image 时自动抓当前画面,一行调用
  • 滑块缺口直接返回归一化偏移,喂给 swipe 即可过验
  • 推理子进程隔离探测,native 崩溃不伤主程序
Python · 零拷贝找色
import ctypes, mmap

k32 = ctypes.windll.kernel32
h = k32.OpenFileMappingW(0x0004, False,
    r"Local\MofeiFrame_{vid}_{pid}_{bus}{addr}_{serial}")
# 标准 24bpp BMP,一次映射长期保活
buf = mmap.mmap(-1, 0, access=mmap.ACCESS_READ)

# 验证码一行识别(自动抓当前画面)
requests.post(BASE + "/api/captcha/recognize",
    json={"type": "CharMixed"}).json()
WORKFLOW · 工作台

录制、话术、快捷键、协同,开箱即用

不写一行代码也能先跑起来:录制触摸与按键生成 JSON 脚本回放;常用话术一键发送;16 组快捷键自由换绑;框选多台设备一键广播。

  • 脚本录制回放:pointer / syskey / ime 动作,JSON 可手改
  • 协同广播:触摸、系统键、文本、文件并行下发
  • 自定义快捷键:裸键防误触、冲突检测、打字优先
  • 批注 / 截图 / 虚拟摄像头:画面可标注、可导出、可被会议软件识别
script.json · 录制产物
[
  { "type": "pointer", "x": 0.5,  "y": 0.48, "t": 0 /* 点按 */ },
  { "type": "ime_send",   "text": "黑猫投屏", "t": 820 },
  { "type": "syskey",  "key": "back",        "t": 1500 }
]
// 归一化坐标 + 相对时间,任何分辨率可回放
WHY NOT ADB

对比 USB 调试方案,差在哪一步

绝大多数投屏与群控工具基于 ADB——那要求你先打开手机的开发者模式、开启 USB 调试、再装好驱动。黑猫投屏从协议层就绕开了这条链路。

维度 黑猫投屏 · AOA USB 调试 · ADB 方案 WiFi 无线投屏
手机端准备 免开不开开发者模式,插线授权即用 必开开发者模式 + USB 调试 + 授权弹窗 看厂商依赖系统投屏入口或第三方 App
电脑端依赖 免驱WinUSB 驱动自动安装 要装ADB 驱动 + 平台工具环境 免驱一般无需驱动
网络依赖 零依赖画面与控制数据全程走 USB 线缆 零依赖本地转发(无线调试除外) 强依赖带宽波动即卡顿掉线
画面链路 H.264 硬解独立管线,最高 90fps,5 档画质 scrcpy 等转发方案,画质帧率可调 多经路由器或厂商云中转,延迟不可控
控制注入 HIDAOA HID 硬件级注入 + 拟人化抖动 inputadb input 事件特征明显 有限多数仅观看或受控于厂商协议
自动化接口 62 个REST + WebSocket + 共享内存,登录即用 自建uiautomator 生态,需自行封装服务 基本无面向演示场景,无控制 API
多设备 框选协同组一键广播,文件并行分发 可多连,但需脚本管理多个 adb 会话 通常一台对一台
隐私 本地数据不出线缆,API 仅监听 127.0.0.1 本地数据不出 USB 出网画面经路由器甚至厂商服务器

说句公道话:ADB 方案能装 APK、能执行 shell 命令,适合刷机运维场景——但这些能力不属于投屏与自动化。黑猫投屏放弃 shell 通道,换来的是零调试门槛与 HID 级注入。完整逐项对比见方案对比页。

USE CASES

谁在用黑猫投屏

01

多机运营

十几台手机同屏排列,框选成组一键广播;话术、文件、批量操作并行下发,一台电脑就是指挥台。

02

自动化测试

用熟悉的语言调用 62 个 REST 接口:节点树断言、控件点击、文本注入、截图取证,测试脚本维护成本直线下降。

03

RPA 与脚本开发

共享内存零拷贝找图找色接入按键精灵、大漠、易语言、AutoHotkey、Python——你只管写逻辑,底座全部现成。

04

演示与协作

大屏投屏演示 App,批注圈点、虚拟摄像头输出给会议软件;音频同步直传,每台设备独立静音。

FAQ

常见问题

不需要。黑猫投屏走 Android Open Accessory(AOA)配件协议,与 ADB / USB 调试完全无关。手机装好 App 后插线,确认一次配件授权即可,全程不碰开发者选项。
不需要。投屏、HID 回控、无障碍自动化、文件推送全部在免 root 状态下工作。
不会。USB 模式下画面、音频、控制指令全程只走数据线;本机 API 服务仅监听 127.0.0.1:7799,外部无法访问。局域网无线模式数据也只在你自己的路由器内流转。软件账号登录需要联网,此外不依赖任何在线服务。
scrcpy 优秀,但它基于 ADB:要求开启 USB 调试、装好驱动环境,注入依赖 adb input。黑猫投屏的差别在协议层:AOA 免调试免驱动,控制走 HID 通道且自带拟人化,再叠加无障碍 REST 化、共享内存找色、本地验证码识别与协同群控——是「投屏 + 自动化平台」而非单一投屏器。
AOA 协议没有安装通道,这是有意的取舍(换来免调试接入)。黑猫投屏支持把 APK 与任意文件推送到手机的下载 / 图片 / 视频 / 相册四个目录,你在手机上点一下即可完成安装;批量分发同样支持并行推送。
Windows 10 / 11 x64,安装即用——.NET 8 自包含发布,无需额外装运行时;验证码识别引擎可用任意 DX12 显卡加速,无独显也能跑 CPU 模式。安卓侧 7.0 及以上。

插上线,五分钟跑起第一个脚本

下载安装包,手机装上黑猫投屏 App,一根数据线开始。