有线直连解决了什么问题
蓝牙 HID 解决了免签名问题，无线蓝牙在机房、多设备群控现场偶尔不稳。2.4G 蓝牙信道上设备一多就互相干扰，延迟会波动，严重的直接断连。OTG HID 改用有线：开发板换成 ESP32S3，通过 OTG 线直连 iPhone。手机把它识别成 EasyClick NCM+HID input 外设，屏幕上出现鼠标小圆点。免签名、免代理 IPA，截图同样走 image.captureFullScreenNoAuto。不受蓝牙干扰，只支持 iOS 17+。
OTG HID 和蓝牙 HID 的控制逻辑相同，都是模拟 HID 设备，让手机把它当成外设。蓝牙走无线，OTG 走有线。有线延迟更稳，也不吃蓝牙干扰，但占掉手机唯一的数据线接口。接口被占，中控就靠无线调试来连。
| 硬件 | 说明 | 注意事项 |
|---|---|---|
| ESP32S3 开发板 | 目前仅支持 S3，不支持 C3 或其他型号 | 淘宝/拼多多/1688 自购，固件免费 |
| 三合一转接头 | 网线 + OTG + 充电三合一 | 因为数据线被 OTG 占用，需要转接头同时解决供电、联网 |
| OTG 线 | 连接开发板与手机 | 注意 Lightning 或 Type-C 接口与手机匹配 |
三合一转接头是 OTG 方案里少不了的配件。没有它，数据线被开发板占用后既充不了电，也走不了有线网。用 WiFi 也能联网，有线更稳。
五步配置：刷固件、绑定、配网、无线调试、测试
先刷固件。到网盘 iOS 资源 → USB 版本 → OTG 固件下载，刷入方式和安卓一致。确认选的是 iOS USB 的 OTG 固件，别选成蓝牙固件或安卓固件。刷完记下开发板 MAC 地址，后面绑定要用。刷固件时关掉中控软件，免得串口被占用。
刷完在中控里绑定。右键设备 → OTG HID 设置 → 绑定 OTG 设备，选择已连接的串口。找不到就去掉「只显示已绑定的」再强制刷新。也可以直接输入 MAC 后 8 位。绑定之后，中控列表的「蓝牙/OTG MAC」栏会显示硬件地址。
接着配网。中控右键 → OTG HID 设置 → 设置 WIFI（配网），填上 WiFi SSID 和密码后点设置。再重启开发板或者重新拔插。然后中控右键 → 扫描开发板 IP，扫到之后「蓝牙/OTG 硬件 IP」栏会显示 IP。配好网，开发板就不用再连电脑，之后通电就能和中控通信。ESP32S3 只支持 2.4G WiFi。
然后开手机的无线调试。OTG 占了数据线，手机和中控只能走无线，这一步也最容易卡住。先「设置 → 通用 → 传输或还原 iPhone → 还原位置与隐私」抹掉旧的信任关系。数据线插电脑，弹窗点信任。电脑上装好爱思助手 → 工具箱 → 爱思投屏，一路把 Bonjour 服务装上，装到「进程管理器 → Bonjour 服务启动」为止。再回到中控右键设备 → 无线调试开关 → 开启无线调试，最后重启手机。手机会以无线方式连到中控，连接方式显示 Network。Bonjour 是苹果的零配置网络发现协议，中控靠它发现无线连着的 iPhone。没装好，或者服务没起来，就找不到无线设备。
最后测一遍。手机系统选项和蓝牙 HID 一样，辅助触控、全键盘控制这些都要开。跟踪灵敏度拉到最左。把 OTG 设备接上手机。看到鼠标小圆点，或者「设置 → 以太网」里出现 EasyClick NCM+HID input，就算识别成功。再到中控右键 → OTG HID 设置 → 测试 OTG。点鼠标移动、HOME 按键，手机有动作就通了。小圆点出来了但点击没反应，先看辅助触控的跟踪灵敏度和跟踪加速度有没有都拉到最左。这两项没调好是新手最常见的问题。
配置完成后的通信通道：
中控电脑 ──WiFi/局域网──→ 开发板(ESP32S3) ──OTG 有线──→ iPhone
↑
配网后独立工作，无需连电脑中控通过 WiFi 向开发板下发指令。开发板再通过 OTG 线把 HID 事件发给手机。手机这边走无线调试（Network 模式）和中控保持连接，往回传截图数据。
输入、排查与部署清单
功能体系和蓝牙 HID 基本一致。区别是事件函数前缀从 bleEvent 换成 otgEvent：
| 功能 | 说明 | 函数/方式 |
|---|---|---|
| 输入文字 | 有代理用 inputText；装了脱机版主程序用 imeApi；都没有用快捷指令助手 |
同蓝牙方案三级降级 |
| 键盘快捷键 | 中控新增快捷键，配合「全键盘控制 → 命令」，脚本用 otgEvent.keyPressChar 调用 |
gui + 字符组合键 |
| 截图 | image.captureFullScreenNoAuto 或 image.startPreCapScreen 预截图 |
不走屏幕镜像 |
| OCR/YOLO/图色/模板匹配 | 全部可用 | 与蓝牙方案一致 |
| 节点功能 | 不可用 | 需代理 IPA 支持 |
// OTG 方案触发键盘快捷键
otgEvent.keyPressChar('b'); // 触发 gui+b
// 无屏幕镜像截图
const img = image.captureFullScreenNoAuto();
// 预截图提速
image.startPreCapScreen();常见问题排查：
| 现象 | 处理方式 |
|---|---|
| 手机开启不了无线调试 | 「还原位置与隐私」后重新信任；确保 Bonjour 服务已启动；手机与电脑同一局域网且能 ping 通；中控开不了就改用爱思助手「功能开关 → 开启 WIFI 调试链接」 |
| 连不上/不稳定 | 检查 OTG 是否识别（以太网里看 NCM 设备）；开发板 IP 是否扫到；重新配网或重启开发板 |
| 鼠标不准确 | 核对手机辅助触控选项；otgEvent.resetZero 归零；设置缩放比与屏幕尺寸；横竖屏切换时更新对应尺寸 |
| 开发板 IP 扫不到 | 确认 WiFi 密码正确；使用 2.4G 网络；重启开发板后重新扫描；检查开发板是否配网成功 |
| Bonjour 服务安装失败 | 关闭杀毒软件后重装；以管理员身份运行爱思助手；手动到服务管理器检查 Bonjour Service 是否存在并启动 |
与蓝牙 HID 对比速记：
| 维度 | OTG HID | 蓝牙 HID |
|---|---|---|
| 连接方式 | 有线 OTG | 无线蓝牙 |
| 抗干扰 | 强 | 受蓝牙信道影响 |
| 延迟稳定性 | 稳定 | 有波动 |
| 系统支持 | iOS 17+ | iOS 18+ 兼容良好 |
| 数据线占用 | 占用 | 不占用 |
| 配置复杂度 | 较高（需无线调试） | 较低 |
规模化部署前，按清单逐项确认：
- ESP32S3 开发板数量与手机数量匹配，每台手机一块板；
- 三合一转接头（网线 + OTG + 充电）准备到位；
- OTG 线接口与手机型号匹配（Lightning 或 Type-C）；
- 所有开发板已刷入正确的 OTG 固件并记录 MAC 地址；
- 所有开发板已完成配网，中控能扫描到 IP；
- 电脑已安装 Bonjour 服务，无线调试功能正常；
- 手机系统选项（辅助触控、全键盘控制等）全部正确开启；
- 手机系统版本 ≥ iOS 17。
几个注意事项。无线调试首次配置必须用数据线，先有线连上建立信任关系，之后才能无线通信。系统更新可能重置无线调试，iOS 更新后失效就得重走一遍流程。OTG 方案不支持 iOS 17 以下设备，设备群里有低版本的要混用蓝牙 HID。群控时用三合一转接头接网线，比 WiFi 稳。
FAQ
Q1：OTG HID 方案是什么？ A：用 ESP32S3 开发板通过 OTG 线直连 iPhone，模拟 HID 输入设备实现控制。免签名、免代理 IPA，截图不走屏幕镜像，且不受蓝牙干扰，仅支持 iOS 17+。
Q2：OTG HID 和蓝牙 HID 哪个好？ A：OTG 走有线，不受蓝牙干扰、延迟更稳定，但只支持 iOS 17+ 且数据线被占用，需用无线调试连中控；蓝牙 HID 支持版本更广、无需占用数据线。稳定优先选 OTG，灵活优先选蓝牙。
Q3：OTG HID 需要签名 IPA 吗？
A：不需要。OTG 方案与蓝牙 HID 一样免签名、免装代理，截图用 image.captureFullScreenNoAuto，不走屏幕镜像。
Q4：数据线被 OTG 占用了，手机怎么联网？ A：建议使用三合一转接头（网线 + OTG + 充电），同时解决供电、联网、控机；手机与中控之间通过无线调试（Network 模式）连接，需要安装 Bonjour 服务。
Q5：OTG HID 能批量控制手机吗？ A：可以。每台手机一块 OTG 开发板，中控通过无线调试批量管理多台设备，配合批量脚本下发实现群控。
Q6：无线调试开启不了怎么办？ A：先「还原位置与隐私」抹除旧信任关系，重新用数据线连电脑并点信任；确保 Bonjour 服务已启动（爱思投屏会引导安装）；手机与电脑在同一局域网且能 ping 通；中控开不了可用爱思助手「功能开关 → 开启 WIFI 调试链接」替代。
Q7：OTG HID 用什么开发板？ A：目前仅支持 ESP32S3 开发板，不支持 ESP32C3 或其他型号。固件免费，到 EasyClick iOS 资源 → USB 版本 → OTG 固件下载，注意不要选成蓝牙固件。
Q8：OTG 配网后还需要连电脑吗？ A：不需要。配网和绑定时需要用电脑串口操作，但配好 WiFi、扫到开发板 IP 后，开发板只需通电即可与中控通信，不再需要插电脑。
Q9：OTG HID 怎么测试是否成功？ A：将 OTG 设备接上手机，看到鼠标小圆点或手机「设置 → 以太网」出现 EasyClick NCM+HID input 即识别成功；中控右键 → OTG HID 设置 → 测试 OTG，点鼠标移动/HOME 按键，手机有动作即配置成功。
关于 EasyClick：手机自动化脚本开发平台，覆盖安卓免 ROOT、iOS 免越狱、鸿蒙三大手机生态，还提供苹果脚本编写、苹果群控、安卓群控、远程云控、AI 群控手机等。→ 了解全部产品
想要真实跑起来？
本文介绍的方案均可在 EasyClick 手机自动化平台落地。官网提供完整文档、开发工具与群控云控产品，免费体验。