鸿蒙群控，是指用一台电脑集中管理并批量操控多台鸿蒙设备（HarmonyOS Next）的技术方案，和安卓群控、苹果群控属于同一类工具。这里要解决的，是鸿蒙自动化的 ESP32 刷入与绑定测试。
前置条件，和选板选固件
先把门槛说清楚：鸿蒙群控的蓝牙 HID 需要鸿蒙 USB 中控 3.2.0 及以上，低于这个版本右键菜单里没有蓝牙 HID 设置，脚本侧的蓝牙事件也不可用。
原理上，在鸿蒙 Next（HarmonyOS Next）上，这块 ESP32 板子把中控的指令翻译成蓝牙 HID 发给手机。手机只当 HID Host，也就是把自己当成接了个外接键盘。电脑或中控通过串口或 WiFi 连板子，板子再对手机发按键和触控。它和鸿蒙自动化服务、鸿蒙投屏、USB HID 可以组合，也可以单独用蓝牙做点击和按键。实际项目里更常见的是组合：截图找图走自动化通道，点击走蓝牙板。iOS 那套 USB HID 是另一条线：EC iOS USB 10.7.0（2026-09-08）起、不装板、手机建议 iOS 17 及以上，并且和「启动自动化」互斥。鸿蒙这块板不要刷 iOS USB 专用固件。
板子要自己买，固件免费。下单前把四项定下来，这四项任意一项错了都要重刷：
| 项目 | 选项 | 说明 |
|---|---|---|
| 芯片 | ESP32-C3 / ESP32-S3 | 固件分别对应 |
| 板型 | 焊接引脚 / 不焊引脚 | 固件分开 |
| 功能 | 含键盘 / 不含键盘 | 系统键和快捷键依赖含键盘版本 |
| 平台 | 鸿蒙、安卓 USB 版本 | 不要刷 iOS USB 专用固件 |
固件在网盘的产品资源里，进鸿蒙资源文件夹，再进 USB 版本的蓝牙固件目录。刷写步骤本身和安卓一致。刷的时候注意两点：芯片型号和板型要和固件严格对应；刷完给开发板重新上电，别一直挂着刷写工具。刷写工具用完记得关掉。串口被占着的时候，中控打不开串口，表现就是绑定时看不到设备或者读不到 MAC。
绑定、测试和脚本调用
在中控里选中一台已连接的设备，右键进蓝牙 HID 设置，点绑定蓝牙 BLE。
对话框里选串口，列表为空时先取消只显示未绑定之类的筛选、点强制刷新，仍找不到就手工填 MAC，填的是蓝牙 MAC 的后 8 位。蓝牙 MAC 从哪读？开发板的蓝牙名称一般就是 MAC 后 8 位，中控绑定串口时也会自动读出，建议买回来就贴标签，多机管理时省去反复核对。绑定成功后，设备列表里的蓝牙 MAC 一栏会显示刚绑的硬件地址，绑定的关系是 UDID 对 bleMac，一台手机对一块板，这也解释了一个限制：一块板同时只能连一台手机。
绑定只是建立了对应关系，通路通不通要单独测。先在手机的设置里进蓝牙，搜索并配对该开发板，名称是 MAC 后 8 位，图标可能是键盘或鼠标，系统弹出输入设备一类的权限确认就点允许。回中控右键进蓝牙 HID 设置，点测试蓝牙 BLE，通信方式默认串口，然后点触控长按或 HOME 按键。
手机有反应就说明整条通路通了；没反应按这个顺序试：手机上忽略设备后重新配对，开发板按 RST 重启，再测一次。
写鸿蒙脚本时，蓝牙事件的对象前缀是 bleEvent，调用顺序是：先设通信方式，串口模式走 bleEvent.setSendCmdType(1)、网络模式走 setSendCmdType(2)（板子需已配网）；设屏幕尺寸 bleEvent.setScreenSize(宽, 高)，宽高可以用截图的像素尺寸；串口模式下开串口 bleEvent.openSerial；然后是点击、滑动、按键，对应 clickPoint、swipeToPoint、systemKey、keyPressChar。systemKey 支持 home、back、recents 等系统键，keyPressChar 用来发英数与快捷键，中文长文本仍建议开启自动化后走代理输入。返回空值或空字符串表示成功，返回其他字符串是错误信息。判断成功时按这个约定写，别拿布尔真值去比。
屏幕尺寸这一步最容易被跳过。蓝牙点击走的是绝对像素坐标，不先设尺寸，坐标算出来就是偏的。横竖屏切换之后还得重新设一次。
连不上、点不准怎么排查
蓝牙连不上，按这个顺序：按住开发板 RST 约 5 秒松开，手机上忽略设备后重搜；确认板子只连了一台手机；刷过固件的话重新上电；手机蓝牙开关一次再搜。中控列表里蓝牙 MAC 不更新，先确认中控版本不低于 3.2.0 且已正常启动；绑定成功后可以重开一次绑定对话框核对当前 MAC，必要时解绑后重新强制绑定。点不动或者点的位置不对，回到脚本看三件事：有没有先设屏幕尺寸、通信方式选对没有、绑定的 MAC 和当前串口是不是同一块板。
开发板灯语可以帮忙判断状态：配对成功常亮约三秒后熄灭，蓝牙断开慢闪约十次，查找蓝牙快闪约十五次。最后提醒一句容易被忽略的：开发者选项里的 USB 调试是给自动化和截图用的，和 BLE 配对不能互相替代；手机侧要保持蓝牙开启，配对关系断了，脚本发出去的事件就没人接。
关于 EasyClick：手机自动化脚本开发平台，覆盖安卓免 ROOT、iOS 免越狱、鸿蒙三大手机生态，还提供苹果脚本编写、苹果群控、安卓群控、远程云控、AI 群控手机等。→ 了解全部产品
想要真实跑起来？
本文介绍的方案均可基于 EasyClick 能力在 iEasyClick 落地。官网提供完整文档、开发工具与自动化产品，免费体验。