黑猫投屏是基于 USB AOA 协议的安卓投屏与自动化平台——无需开启 USB 调试、免 root、免同一 WiFi。插线即投,键鼠回控,并把无障碍自动化、找图找色与识别引擎全部开放成本机 REST API。
市面工具大多停在「看得到」。黑猫投屏把连接、控制、观察、识别四层能力全部做透,并开放给你已有的任何脚本语言。
走 Android Open Accessory 配件协议,不开开发者模式、不装 ADB 驱动、不用同一 WiFi,插线授权即用;另有局域网无线模式扫码连接。
触摸与按键经 AOA HID 通道注入,比无障碍手势更底层;内置压感、面积、时序随机化与 ±1px 坐标微抖多维度拟人化,默认开启。
节点树查询、选择器查找等待、点击滑动、文本粘贴、窗口枚举、批量动作……无障碍即服务,本机 HTTP + WebSocket 全量暴露。
视频帧以命名共享内存暴露为标准 24bpp BMP,按键精灵、大漠、易语言、AutoHotkey、C、Python 一次映射长期保活,零拷贝不丢帧。
字符、数字、字母、滑块缺口、点选五类验证码本地 ONNX 推理,DirectML 加速——任意 DX12 显卡即可,不依赖在线接口。
框选协同组,触摸、按键、文本、文件一键广播到全部设备;文件分发并行传输、进度可视;多台同时投屏统一管理。
从插上线到跑起你的第一个自动化脚本,中间没有任何「配置环境」环节。
手机端装好黑猫投屏 App,USB 线插上电脑,在手机上确认一次 AOA 配件授权,画面立刻出现。不需要开发者选项,不需要 adb devices,也不需要配置驱动路径。
{
"ok": true,
"data": [
{
"path": "9A271FFAZ000QP",
"model": "Pixel 4",
"alias": "我的手机",
"width": 1080, "height": 2400,
"a11y_enabled": true,
"active": true
}
]
}
点击、滑动、拖拽、系统键全部走 AOA HID 通道注入内核输入子系统,而非模拟无障碍手势。滑动自带多帧插值与仿人抖动,文本经输入法粘贴通道写入,绕开剪贴板嗅探。
# 归一化坐标,自带多帧插值 + 仿人抖动 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" }
Android 无障碍服务的节点树、选择器、动作、文本、焦点、窗口、通知全部 REST 化。你可以「读」屏幕——节点树、查找等待;也可以「写」屏幕——点击、滑动、粘贴、批量动作。
/api/a11y/wait-and-click 一步到位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() # 出现即点,超时即报,无需轮询截图
找图找色不必截图轮询:每台设备的视频帧实时写入命名共享内存(标准 24bpp BMP),你的进程一次 OpenFileMappingW 长期保活,零拷贝读取。验证码交给本地识别引擎——字符、数字、字母、滑块、点选五类全覆盖,ONNX + DirectML 本地推理。
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()
不写一行代码也能先跑起来:录制触摸与按键生成 JSON 脚本回放;常用话术一键发送;16 组快捷键自由换绑;框选多台设备一键广播。
[
{ "type": "pointer", "x": 0.5, "y": 0.48, "t": 0 /* 点按 */ },
{ "type": "ime_send", "text": "黑猫投屏", "t": 820 },
{ "type": "syskey", "key": "back", "t": 1500 }
]
// 归一化坐标 + 相对时间,任何分辨率可回放
绝大多数投屏与群控工具基于 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 级注入。完整逐项对比见方案对比页。
十几台手机同屏排列,框选成组一键广播;话术、文件、批量操作并行下发,一台电脑就是指挥台。
用熟悉的语言调用 62 个 REST 接口:节点树断言、控件点击、文本注入、截图取证,测试脚本维护成本直线下降。
共享内存零拷贝找图找色接入按键精灵、大漠、易语言、AutoHotkey、Python——你只管写逻辑,底座全部现成。
大屏投屏演示 App,批注圈点、虚拟摄像头输出给会议软件;音频同步直传,每台设备独立静音。
127.0.0.1:7799,外部无法访问。局域网无线模式数据也只在你自己的路由器内流转。软件账号登录需要联网,此外不依赖任何在线服务。