scrcpy OTG 模式实战：不依赖 ADB，用 AOA HID 协议直接控制 Android 设备

scrcpy OTG 模式实战不依赖 ADB用 AOA HID 协议直接控制 Android 设备【免费下载链接】scrcpyDisplay and control your Android device项目地址: https://gitcode.com/GitHub_Trending/sc/scrcpy本文围绕 scrcpy 仓库中的 doc/otg.md 展开讲解 scrcpy 的 OTGOn-The-Go控制模式如何在不启用 USB 调试不需要 adb的前提下通过 USB 直连把计算机的键盘、鼠标和游戏手柄插到 Android 设备上。读完后你将掌握--otg的完整用法、各输入设备的开关参数并能从 客户端源码 理解 AOA HID 通道的初始化流程与 Windows 平台的特殊限制。什么是 OTG 模式scrcpy 默认在 Android API 层注入输入事件即通过adb通道调用injectKeyEvent、injectMotionEvent等接口。作为一种替代方案scrcpy 支持发送 HID 事件让 scrcpy 表现得像一台连接到 Android 设备的物理键盘或物理鼠标事件绕过 Android API直接以 USB 外设协议进入系统输入管线。OTG 模式进一步利用AOAAndroid Open Accessory协议scrcpy 客户端进程自己扮演 USB 配件accessory角色设备侧无需 adb 服务参与。其特点是完全不用 adb——不需要开启 USB 调试设备侧不运行 scrcpy server 视频/音频部分视频和音频被禁用——OTG 模式纯粹是输入通道不做镜像键盘和鼠标自动切换为 AOA——--keyboardaoa与--mouseaoa被隐式设置从 cli.c 的参数归一化逻辑 可以看到otg为真时auto输入模式一律解析为 AOA游戏手柄默认禁用——需要显式加上--gamepadaoa或 OTG 模式下-G的短写法。因此OTG 模式的效果是计算机的键盘、鼠标和游戏手柄就像通过 OTG 线直接插到 Android 设备上一样。启用 OTG 模式基本用法scrcpy --otg # 如果同时存在多个 USB 设备用 -s 指定序列号 scrcpy --otg -s 0123456789abcdef唯一硬性前提设备必须通过 USB 连接AOA 协议本身就是 USB 配件协议走 TCP/IP 无线连接不可用这与后文的 UHID 方案形成对照。命令行入口在 cli.c 中定义--otg的帮助文本说明其语义就是模拟物理键盘和鼠标如同通过 OTG 线连接到设备main.c 中根据该标志把执行流分派到独立的 OTG 入口scrcpy_otg()与普通镜像流程完全分离。控制输入设备的启停OTG 模式下键盘和鼠标默认启用可以单独关闭scrcpy --otg --keyboarddisabled scrcpy --otg --mousedisabled游戏手柄默认关闭需要显式开启scrcpy --otg --gamepadaoa scrcpy --otg -G # 短写法其中-K、-M、-G三个短参数在非 OTG 时等价于uhid模式在 OTG 模式下自动等价于aoa见 cli.c 中 -G 的帮助文本Same as --gamepaduhid, or --gamepadaoa if --otg is set。从参数校验源码看cli.c 的 OTG 校验块OTG 模式对输入配置有三条硬约束--no-control不允许出现在 OTG 模式控制是 OTG 的全部意义--keyboard、--mouse、--gamepad在 OTG 模式下只接受aoa或disabled两个值——因为控制通道不是 adbSDK 和 UHID 通道均不存在不能同时禁用全部三类输入否则报 Cannot not disable all inputs in OTG mode。OTG 模式的源码实现流程OTG 的完整实现集中在 app/src/usb/scrcpy_otg.c 中的scrcpy_otg()函数第 59–251 行其执行链条清晰可循最小化初始化 SDL仅SDL_Init(SDL_INIT_EVENTS)若启用了手柄则额外初始化SDL_INIT_GAMECONTROLLER失败不致命键盘鼠标仍可工作。这印证了 OTG 模式不做视频渲染——不需要 SDL 的渲染/视频子系统。Windows 特例——先杀 adb server在 Windows 上只有一个进程能独占打开一个 USB 设备而 adb 进程通常已占用该设备scrcpy_otg.c 第 103–115 行。因此代码在 Windows 上启动时主动调用sc_adb_kill_server关闭 adb server让出 USB 设备。这也解释了为什么在 Windows 上必须用--otg而不能用普通的--keyboardaoa——cli.c 中的检查会直接拒绝并提示--keyboardaoa and --mouseaoa may only work in OTG mode。选择并连接 USB 设备sc_usb_select_device()按-s指定的序列号挑选设备sc_usb_connect()建立连接断开时通过回调推送SC_EVENT_USB_DEVICE_DISCONNECTED事件退出scrcpy_otg.c 第 29–35 行。初始化 AOA 协议sc_aoa_init()sc_aoa_start()实现在 app/src/usb/aoa_hid.c完成 USB 配件握手并启动 AOA 通信线程。按选项实例化各 HID 外设仅对启用的设备执行sc_keyboard_aoa_init()keyboard_aoa.c、sc_mouse_aoa_init()mouse_aoa.c、sc_gamepad_aoa_init()gamepad_aoa.c三者都挂在同一个sc_aoa通道上。初始化前还有assert确保输入模式只能是 AOA 或 DISABLEDscrcpy_otg.c 第 145–150 行。创建输入捕获窗口并进入事件循环sc_screen_otg_init()接收窗口标题、位置、尺寸、置顶、快捷键修饰键等参数scrcpy_otg.c 第 191–203 行创建用于捕获本地键盘/鼠标/手柄事件的 SDL 窗口随后event_loop()第 37–57 行阻塞等待 SDL 事件把外设事件经 AOA HID 通道下发并处理断开与退出。有序清理end:标签处按 AOA 外设 → AOA 线程 → USB 连接的反序逐项销毁scrcpy_otg.c 第 217–250 行。从源码结构看OTG 模式还会创建一个可见的 SDL 窗口支持--window-title、--window-x/y/width/height、--always-on-top等窗口参数用于捕获本地输入事件但不显示设备画面。OTG 模式的兼容性限制--otg只能与少数选项共存。cli.c 中的检查 会在启动阶段直接拒绝以下用法并给出对应错误信息不兼容的选项原因--recordfile录制依赖设备侧视频流OTG 模式无视频--turn-screen-off需通过 adb 控制通道下发--stay-awake同上--show-touches同上--power-off-on-close同上--display-idid同上V4L2 输出--v4l2-sink需要视频捕获另外 cli.c 规定若视频、音频、控制、OTG 四项全部关闭scrcpy 判定无事可做而拒绝启动——--otg正是让零镜像场景得以成立的四种模式之一。Windows 上的 OTG 问题如果在 Windows 上运行scrcpy --otg或--keyboardaoa/--mouseaoa得到ERROR: Could not find any USB device或只检测到无关的 USB 设备很可能是驱动问题。仓库的 FAQ.md 将该问题指向了上游 Issue #3654 的讨论涉及 Windows 上 Android 配件/ADB 驱动的识别冲突处理办法参考该 Issue 中的评论即可同时注意上文提到的Windows 独占 USB 设备限制只要 adb server 还活着并占着设备OTG 就无法打开它这也是 OTG 入口要主动kill-server的原因。替代方案只需控制、不需要 OTG需要明确 OTG 的定位它解决的是不开 USB 调试就无法控制设备的问题。如果设备已开启 USB 调试而你只是想只控制、不镜像完全不必进入 OTG 模式直接关掉视频音频并选择 UHID或 AOA即可scrcpy --no-video --no-audio --keyboarduhid --mouseuhid --gamepaduhid scrcpy --no-video --no-audio -KMG # 短写法 scrcpy --no-video --no-audio --keyboardaoa --mouseaoa --gamepadaoa两种写法的区别UHID输入事件经由 adb 转发给设备侧的 UHID 模块注入通道开销小且支持无线TCP/IP使用——这是 UHID 相对 AOA 的一个重要优势AOA输入事件以真正的 USB HID 外设协议发送但受限于 USB 直连以及 Windows 的独占限制见上节。相关参数语义还可以参阅 doc/keyboard.md 的 AOA 小节、doc/mouse.md 的 AOA 小节 与 doc/gamepad.md 中对各输入模式的说明。小结scrcpy 的 OTG 模式把控制设备这一能力从 adb 生态中解耦出来scrcpy --otg一条命令即可在纯 USB 连接下通过 AOA 协议把键盘、鼠标--gamepadaoa或-G再加游戏手柄模拟成插在 Android 设备上的物理 HID 外设。源码上它是一条完全独立于镜像通道的执行路径main.c→scrcpy_otg()→ USB 选择 → AOA 启动 → 各 HID 外设初始化 → SDL 事件循环并针对 Windows 的 USB 独占问题内置了 adb server 清理逻辑。适用前提要记住三点必须 USB 直连、Windows 下注意驱动与 adb 占用问题、以及 OTG 模式与录制/屏幕控制类选项不兼容。【免费下载链接】scrcpyDisplay and control your Android device项目地址: https://gitcode.com/GitHub_Trending/sc/scrcpy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考