前置条件与版本要求
先把门槛说清楚：鸿蒙群控的蓝牙 HID 需要鸿蒙 USB 中控 3.2.0 及以上，低于这个版本右键菜单里没有蓝牙 HID 设置，脚本侧的蓝牙事件也不可用。
原理上，在鸿蒙 Next（HarmonyOS Next）上，这块 ESP32 板子的作用是把中控的指令翻译成蓝牙 HID 发给手机。手机只当 HID Host，也就是把自己当成接了个外接键盘；电脑或中控通过串口或 WiFi 连板子，板子再对手机发按键和触控。
它和鸿蒙自动化服务、鸿蒙投屏、USB HID 都互不冲突，可以组合，也可以单独用蓝牙做点击和按键。实际项目里更常见的是组合：截图找图走自动化通道，点击走蓝牙板。
第一步：选板和选固件
鸿蒙蓝牙 HID 的板子要自己买，固件免费。下单前把四项定下来，这四项任意一项错了都要重刷：
| 项目 | 选项 | 说明 |
|---|---|---|
| 芯片 | ESP32-C3 / ESP32-S3 | 固件分别对应 |
| 板型 | 焊接引脚 / 不焊引脚 | 固件分开 |
| 功能 | 含键盘 / 不含键盘 | 系统键和快捷键依赖含键盘版本 |
| 平台 | 鸿蒙、安卓 USB 版本 | 不要刷 iOS USB 专用固件 |
固件在网盘的产品资源里，进鸿蒙资源文件夹，再进 USB 版本的蓝牙固件目录。刷写步骤本身和安卓一致，用不着另找方法。
第二步：刷入固件
刷的时候注意两点：芯片型号和板型要和固件严格对应；刷完给开发板重新上电，别一直挂着刷写工具。
刷写工具用完记得关掉。串口被刷写工具占着的时候，中控打不开串口，表现就是绑定时看不到设备或者读不到 MAC。
第三步：中控绑定蓝牙 BLE
在中控里选中一台已连接的设备，右键进蓝牙 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：手机自动化 AI 智能体平台，覆盖安卓免 root、iOS 免越狱、鸿蒙 Next 三大生态，提供脚本开发、苹果群控、本地中控投屏与云控系统。→ 了解全部产品
想要真实跑起来？
本文介绍的方案均可基于 EasyClick 能力在 iEasyClick 落地。官网提供完整文档、开发工具与自动化产品，免费体验。