开工前要备齐的东西
OTG 走有线，硬件跟蓝牙方案不是一套，动手前先对一遍清单。
| 硬件 | 说明 | 注意事项 |
|---|---|---|
| ESP32S3 开发板 | 目前仅支持 S3，不支持 C3 或其他型号 | 淘宝/拼多多/1688 自购，固件免费 |
| 三合一转接头 | 网线 + OTG + 充电三合一 | 因为数据线被 OTG 占用，需要转接头同时解决供电、联网 |
| OTG 线 | 连接开发板与手机 | 注意 Lightning 或 Type-C 接口与手机匹配 |
上图是中控认到设备之后的状态，连接方式那一栏会显示 Network，不走有线。
另外两件事提前做掉，能省掉后面大半的麻烦。一是电脑装好爱思助手并跑一遍爱思投屏，把 Bonjour 服务装上，中控靠它发现无线连接的 iPhone，机房里三十台设备一起上时，Bonjour 没装好会大面积搜不到；二是确认手机系统是 iOS 17 以上，低版本跑不了 OTG。
五步跑通：刷固件、绑定、配网、无线调试、验证
刷入固件。 到网盘 iOS 资源 → USB 版本 → OTG 固件下载，刷入方式与安卓一致。三个点容易错：确认选的是 iOS USB 的 OTG 固件，别下成蓝牙固件或安卓固件；刷完把开发板 MAC 地址抄下来，绑定要用；刷的时候关掉中控软件，不然串口被占着刷不进去。
绑定 OTG 设备。 中控右键设备 → OTG HID 设置 → 绑定 OTG 设备；选已连接的串口，找不到就去掉「只显示已绑定的」再强制刷新；也可以直接输 MAC 后 8 位绑定。绑完中控列表「蓝牙/OTG MAC」栏会显示硬件地址。
配网（OTG 联网）。 中控右键 → OTG HID 设置 → 设置 WIFI（配网），填 WiFi 名称和密码后点设置；重启开发板或者重新拔插；再右键 → 扫描开发板 IP，扫到之后「蓝牙/OTG 硬件 IP」栏就有地址了。ESP32S3 只支持 2.4G WiFi，5G 的网扫不到。现场十几台设备挤在同一个路由器下时，扫 IP 容易漏扫，建议给开发板单独开一个 2.4G 的 SSID。配好之后开发板就不用再连电脑，通电就能跟中控通信。
开启手机无线调试。 这一步卡住的人最多。数据线被 OTG 占了，手机只能走无线连中控：手机「设置 → 通用 → 传输或还原 iPhone → 还原位置与隐私」抹掉旧的信任关系；数据线插电脑，弹窗点信任；确认进程管理器里 Bonjour 服务是启动状态；中控右键设备 → 无线调试开关 → 开启无线调试；重启手机。重启后连接方式显示 Network 就成了。
验证。 接上 OTG 设备，看手机有没有出现鼠标小圆点，或者「设置 → 以太网」里有没有 EasyClick NCM+HID input，两个有一个就算识别成功。然后中控右键 → OTG HID 设置 → 测试 OTG，点鼠标移动和 HOME 按键，手机跟着动就说明通了。
出问题先查这张表：
| 现象 | 处理方式 |
|---|---|
| 手机开启不了无线调试 | 「还原位置与隐私」后重新信任；确保 Bonjour 服务已启动；手机与电脑同一局域网且能 ping 通；中控开不了就改用爱思助手「功能开关 → 开启 WIFI 调试链接」 |
| 连不上/不稳定 | 检查 OTG 是否识别（以太网里看 NCM 设备）；开发板 IP 是否扫到；重新配网或重启开发板 |
| 鼠标不准确 | 核对手机辅助触控选项；otgEvent.resetZero 归零；设置缩放比与屏幕尺寸；横竖屏切换时更新对应尺寸 |
| 开发板 IP 扫不到 | 确认 WiFi 密码正确；使用 2.4G 网络；重启开发板后重新扫描；检查开发板是否配网成功 |
| Bonjour 服务安装失败 | 关闭杀毒软件后重装；以管理员身份运行爱思助手；手动到服务管理器检查 Bonjour Service 是否存在并启动 |
脚本里怎么调 otgEvent
功能体系跟蓝牙 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();跑起来之后的通信通道长这样，排查问题时可以按这段通道一段段对：
中控电脑 ──WiFi/局域网──→ 开发板(ESP32S3) ──OTG 有线──→ iPhone
↑
配网后独立工作，无需连电脑中控通过 WiFi 给开发板下发指令，开发板经 OTG 线把 HID 事件发给手机；手机这边走无线调试（Network 模式）回传截图数据。
FAQ
Q1：OTG HID 的固件该下哪个版本？ A：到网盘 iOS 资源 → USB 版本 → OTG 固件，注意别选成蓝牙固件或安卓固件。刷之前先关掉中控软件，避免串口被占用；刷完记下 MAC 地址，后面绑定要用。
Q2：绑定 OTG 设备时找不到串口怎么办？ A：去掉「只显示已绑定的」勾选再强制刷新一次；也可以直接输入 MAC 地址后 8 位手动绑定。绑定成功后中控列表的「蓝牙/OTG MAC」栏会显示硬件地址。
Q3：OTG 开发板为什么要配网？ A：开发板要联网才能跟中控通信。在中控右键 OTG HID 设置里填 WiFi 名称和密码，重启开发板后扫描 IP，扫到就说明通了。注意 ESP32S3 只认 2.4G 网络。
Q4：无线调试开不起来，先查哪几处？ A：按顺序查四件事：手机有没有「还原位置与隐私」抹掉旧信任关系；电脑装没装 Bonjour 服务；手机和电脑在不在同一局域网；中控开不了就用爱思助手的「功能开关 → 开启 WIFI 调试链接」替代。
Q5：配好网之后开发板还要插电脑吗？ A：不用。只有刷固件和绑定这两步需要走电脑串口；配好 WiFi、扫到 IP 之后，开发板通电就能跟中控通信，可以拔掉。
Q6：怎么确认 OTG 已经接上了？ A：两个信号任选其一：手机屏幕上出现鼠标小圆点，或者手机「设置 → 以太网」里出现 EasyClick NCM+HID input。然后中控右键 OTG HID 设置 → 测试 OTG，点鼠标移动或 HOME 键看手机有没有反应。
Q7：鼠标小圆点出来了，但点击没反应？
A：先查辅助触控里的跟踪灵敏度和跟踪加速度，两个都要拉到最左，这是新手最常见的坑；还不准就用 otgEvent.resetZero 归零，再核对缩放比和屏幕尺寸设置。
Q8：OTG 方案的脚本函数跟蓝牙有什么不同？
A：功能基本一致，只是事件函数前缀从 bleEvent 换成 otgEvent，比如 otgEvent.keyPressChar 触发快捷键。截图、OCR、YOLO、图色、模板匹配这些都能照常用。
关于 iEasyClick：手机自动化 AI 智能体平台，覆盖安卓免 root、iOS 免越狱（代理/蓝牙 HID/OTG HID）、鸿蒙 Next 三大生态，提供脚本开发、苹果群控、本地中控投屏与云控系统。→ 了解全部产品
想要真实跑起来？
本文介绍的方案均可基于 EasyClick 能力在 iEasyClick 落地。官网提供完整文档、开发工具与自动化产品，免费体验。