EasyClick iOS USB版本如何蓝牙BLE实现自动化

1 阅读3分钟

EasyClick iOS USB版本通过以下步骤和功能实现基于蓝牙BLE(特别是ESP32C3开发板)的自动化:

核心原理

  • 硬件方案:使用ESP32C3开发板刷写专用蓝牙固件,通过BLE连接iOS设备,模拟鼠标、键盘等HID输入,实现自动化操作。
  • 免代理IPA:与纯软件方案不同,此方案可以不安装代理IPA,直接使用image.captureFullScreenNoAuto等函数截图,避免走屏幕镜像,从而降低风控风险。
  • 功能组合:蓝牙模拟动作与代理IPA的功能互不冲突,可以组合或分开使用。

实现步骤

准备硬件与固件

购买ESP32C3开发板(带焊或不带焊引脚)。 从官方网盘的“iOS资源文件夹-USB版本-蓝牙固件文件”下载对应固件。 参考安卓蓝牙教程将固件刷入开发板,并获取其MAC地址。

绑定设备

在iOS USB中控中,右键点击设备,选择“蓝牙HID设置 -> 绑定蓝牙BLE”。 选择已连接的串口,或直接输入蓝牙MAC地址后8位进行绑定。

手机端连接与设置

在手机设置中,通过蓝牙找到并连接开发板。 必须开启以下辅助功能选项(位于“设置 -> 辅助功能”):

触控:开启“辅助触控”,并将“跟踪灵敏度”调到最左(龟速)。 鼠标键:初始化延迟和最大速度调到最左。 通用:“触控板与鼠标”中的“跟踪加速度”调到最左。 键盘与键入:开启“全键盘控制”,并可在“命令”选项中自定义快捷键。

功能测试

在中控右键菜单选择“蓝牙HID设置 -> 测试蓝牙BLE”。 选择通信方式(串口或Wi-Fi),点击“鼠标移动”或“HOME”键,观察手机是否有对应动作。

脚本开发与配合

在IDE的图色面板中,使用“无自动化抓图”按钮截图,测试时使用“实时测试(无自动化)”按钮。 脚本中使用 image.captureFullScreenNoAuto 或 image.startPreCapScreen 进行截图。 调用 bleEvent 模块的API(如 bleEvent.mouseMove, bleEvent.clickPoint, bleEvent.keyPressChar 等)执行点击、滑动、输入、快捷键等操作。 注意:蓝牙BLE方案下,节点功能不可用,但OCR、YOLO、图色、模板匹配等功能均可正常使用。

关键API与功能

  • 通信方式:支持串口(USB直连)和Wi-Fi两种方式与开发板通信。

  • 鼠标控制:移动、点击、长按、双击、滑动、多点触控等。

  • 键盘与输入:

  • 系统按键(Home、任务切换)。

  • 自定义键盘快捷键(配合手机“全键盘控制”)。

  • 输入功能:有代理IPA时可直接调用输入函数;无代理时可部署“iOS快捷指令助手”服务,通过快捷指令配合蓝牙快捷键实现文本粘贴或媒体文件插入相册。

  • 校准与防漂移:使用 bleEvent.setScale 设置鼠标补偿比率,bleEvent.setScreenSize 设置屏幕尺寸,bleEvent.resetZero 校准坐标,以防止鼠标漂移。

常见问题排查

  • 蓝牙连接失败:按住开发板RST键5秒后重试,或在手机上忽略设备后重新连接。一个开发板只能绑定一个设备。
  • 鼠标漂移或不准确:检查手机辅助功能设置是否正确,校准坐标,设置正确的屏幕缩放比和尺寸。
  • 版本要求:蓝牙BLE相关功能需要 EC iOS USB版本9.20.0+ 支持。

总结:EasyClick通过“ESP32C3开发板 + 专用蓝牙固件 + bleEvent API + 无自动化截图”的组合,为iOS免越狱环境提供了一套高效、稳定且能有效规避风控的硬件自动化解决方案。

更多内容请看文档 ieasyclick.com/iosdocs/zh-…