escrcpy 的 OTG 模式：无需 USB 调试即可控制 Android 设备的 AOA/HID 实战指南

escrcpy 的 OTG 模式：无需 USB 调试即可控制 Android 设备的 AOA/HID 实战指南

【免费下载链接】escrcpy📱 Display and control your Android device graphically with scrcpy.项目地址: https://gitcode.com/GitHub_Trending/es/escrcpy

本文基于 escrcpy 仓库内置的 scrcpy 参考文档（docs/en/reference/scrcpy/otg.md）展开。OTG 模式是 scrcpy 家族中最特殊的运行方式之一：它绕过adb与 scrcpy server，直接通过 USB 链路上的 AOAv2 协议向设备模拟物理键盘、鼠标与游戏手柄，从而在完全不开启 USB 调试的情况下控制 Android 设备。读完本文，你将掌握--otg的完整用法、AOA/UHID 两种 HID 模拟方案的取舍，以及"仅控制不镜像"的进阶配置，并能看到该能力在 escrcpy 图形界面中的落地实现。

OTG 模式的原理：从 API 注入到 USB 级 HID 模拟

默认情况下，scrcpy 是在Android API 层级注入输入事件（sdk模式）：事件经由 scrcpy server 在设备内部以系统接口形式注入，因此依赖adb建立的连接与调试授权。

OTG 模式则完全不同。它发送HID（Human Interface Device）事件，使 scrcpy 在 Android 设备看来，就像一台通过 OTG 线缆直连的物理键盘和物理鼠标。具体采用 AOA 方案时：

• 基于AOAv2 协议（Android Open Accessory 2.0）工作，通信发生在 USB 协议层；
• 不使用 scrcpy server，因此adb（USB 调试）完全不需要；
• 视频与音频被自动禁用，--keyboard=aoa与--mouse=aoa被隐式设置；
• 游戏手柄默认禁用，必须显式传入--gamepad=aoa（OTG 模式下短写为-G）。

直观地理解：启用 OTG 后，你电脑的键盘、鼠标、游戏手柄在系统层面被"虚拟成"插在手机 OTG 口上的外设，手机无需开启任何调试开关即可响应。

启用与基本使用

启用 OTG 模式只需一条命令：

scrcpy --otg

如果电脑上连接了多个 USB 设备，需要显式指定序列号：

scrcpy --otg -s 0123456789abcdef

这是 OTG 模式与普通模式最显著的分水岭：它仅在设备通过 USB 线缆连接时有效，无线连接无法使用 AOA 方案（因为 AOA 工作在 USB 物理链路上）。

灵活控制键盘、鼠标与游戏手柄

OTG 模式下可以独立关闭某类输入设备：

# 禁用键盘（只保留鼠标控制） scrcpy --otg --keyboard=disabled # 禁用鼠标（只保留键盘控制） scrcpy --otg --mouse=disabled

启用游戏手柄（AOA 模式下游戏手柄默认关闭）：

scrcpy --otg --gamepad=aoa scrcpy --otg -G # 简写形式

参数速查

深入理解：AOA 与 UHID 两种 HID 模拟方案

OTG 依赖的 AOA 并非唯一的"物理设备模拟"手段。scrcpy 还提供 UHID 方案，二者的底层差异直接决定了适用场景：

细节依据见 keyboard.md 与 mouse.md：

• UHID模拟出的 HID 键盘支持所有字符与输入法（IME），可关闭屏幕键盘，且能通过 TCP/IP 无线工作，但受限于设备内核权限，在部分旧版 Android 上可能失败；
• AOA在 USB 层直接工作，不经过 adb 守护进程，因此在 Windows 上存在一个已知约束：镜像时 USB 设备已被 adb 进程占用，AOA 可能只在 OTG 模式下可用（详见下文"Windows 上的 OTG 问题"）；
• 游戏手柄的 AOA 模式还有一个已知缺陷：Android 可能把多个物理手柄误识别为单个异常手柄，需要多手柄场景时官方建议改用 UHID（见 gamepad.md）。

"仅控制不镜像"：OTG 的替代与延伸

OTG 存在的意义，是在没有 USB 调试的情况下控制设备。如果你已经开启了 USB 调试，只是想"只控制不镜像"，则完全不必动用 OTG——直接禁用视频与音频即可，并可自由选择 UHID 或 AOA：

# UHID 方案（推荐，支持无线） scrcpy --no-video --no-audio --keyboard=uhid --mouse=uhid --gamepad=uhid scrcpy --no-video --no-audio -KMG # 简写形式 # AOA 方案（仅 USB） scrcpy --no-video --no-audio --keyboard=aoa --mouse=aoa --gamepad=aoa

这里有一个容易被忽略的关键差异：UHID 依然依赖 adb 通道（scrcpy server 注入），因此它可以无线工作；而 AOA 走 USB 物理链路，天然不支持无线。如果你追求"免 USB 调试"则选 AOA（即 OTG 场景），如果追求"无线也能纯控制"则选 UHID。

常见问题：Windows 上的 OTG 故障

在 Windows 上运行scrcpy --otg（或--keyboard=aoa/--mouse=aoa）时，如果报错：

ERROR: Could not find any USB device

或者只检测到与本机无关的 USB 设备，通常是USB 驱动问题，而不是 scrcpy 本身的缺陷。排查建议见 docs/en/help/scrcpy.md#otg-issues-on-windows：核心思路是确认设备以正确的模式被 Windows 枚举（如缺失 AOA 协议支持需要安装对应厂商驱动）。

另一个 Windows 特有约束值得再次强调：由于 Windows 不允许两个进程同时独占同一 USB 设备，镜像模式下 adb 守护进程已打开设备，AOA 模式可能只在纯 OTG 模式（无 adb 参与）下才能工作。

escrcpy 中的 OTG 落地：从命令行到图形界面

escrcpy 将上述能力封装进了桌面端图形界面。设备列表的"更多操作"下拉中提供了 OTG 入口，其组件定义在 desktop/src/views/device/components/more-dropdown/components/otg/index.vue，点击后调用useOtgAction().invoke()启动。

核心逻辑位于 desktop/src/hooks/use-otg-action/index.js，从源码可以看到它构造 scrcpy 参数的方式：

const args = preferenceStore.scrcpyParameter(deviceId, { overrides: { '--no-video': true, '--no-audio': true, '--always-on-top': true, '--mouse': 'uhid', '--keyboard': 'uhid', }, excludes: [ '--turn-screen-off', ], })

几个值得注意的实现细节（均可在源码中验证）：

• 复用了偏好配置：scrcpyParameter()会基于用户在偏好设置中保存的 scrcpy 参数生成命令行，overrides用于强制覆盖，excludes用于剔除与 OTG 场景冲突的选项（如--turn-screen-off熄屏）；
• 视频与音频被强制关闭，与参考文档中"OTG 模式视频音频禁用"的语义一致；
• 有趣的是，escrcpy 界面上的"OTG"动作实际选用的是uhid而非aoa。这意味着在该实现下设备仍需 adb 连接（UHID 依赖 scrcpy server），这与命令行原生 OTG 的"免 adb"存在差异——从源码推断，这更像是对"仅控制不镜像 + 物理设备模拟"体验的封装，若需要完全免 adb 的 AOA 方案，仍可直接使用 scrcpy 命令行；同时它也复用了--always-on-top保证控制窗口置顶；
• 启动后通过window.$preload.scrcpy.mirror()调用底层进程，并设置resolveOnReady: true等待就绪，出错时以ElMessage.warning提示用户。

总结

OTG 模式是 scrcpy 家族中"去 adb 化"的极致形态：通过 AOAv2 在 USB 层模拟物理 HID 设备，让电脑的键鼠手柄像直接插在手机上一样工作，适合没有开启（或无法开启）USB 调试的安卓设备；而"仅控制不镜像"的普通模式配合 UHID，则是需要无线控制的更灵活选择。掌握--otg、--keyboard/mouse/gamepad的模式切换与-KMG/-G等短写，即可在镜像、纯控制、免调试控制三种形态间自由切换。

【免费下载链接】escrcpy📱 Display and control your Android device graphically with scrcpy.项目地址: https://gitcode.com/GitHub_Trending/es/escrcpy