HID键鼠使用指南
更新: 2025/7/20 字数: 0 字 时长: 0 分钟
隔离性
HID键鼠 是一种采用基于物理级的自动化方式，无需依赖无障碍、ADB、Root等系统权限，具备更高的环境隔离性。
简介
本指南介绍如何通过 Bot.js App（版本 ≥ v19238） 实现手机或设备的 键鼠控制功能。
支持通过 蓝牙 和 OTG/USB 两种方式进行 HID 输入，适配多种控制场景。
✅ 无需依赖传统权限机制，不要求辅助功能（无障碍）、ADB、Root 等系统授权。
📦 直接使用 Bot.js App 打包即可运行，无需额外安装服务端。
HID 输入协议说明
- 蓝牙与 OTG/USB 通信协议采用统一指令架构，仅 HID 键码存在差异。
- 当前支持以下输入形式：
- 键盘输入（标准 HID 键码）
- 鼠标移动/点击事件
- 单点触控（仅 ESP32 开发板暂时支持）
使用设备与硬件要求
与传统基于系统权限的方案（如无障碍、ADB、Root 模式）不同，HID 模式依赖实际硬件支持：
- 需要准备 ESP32 开发板（推荐带有 USB HID 或 BLE HID 支持的型号）
- 使用官方提供的 HID 固件烧录至设备
- 与目标手机建立 USB 或蓝牙连接后，即可实现自动化控制
⚠️ 相比软件权限方案，HID 方式具有更高的可靠性和物理隔离，避免软件层面的干扰，但 硬件成本更高、搭建略复杂，适用于需要高稳定性自动化测试场景。
蓝牙使用注意事项
虽然蓝牙提供无线便利，但在使用过程中需注意以下几点：
- 通信延迟约为 100 毫秒，在快速操作或游戏中可能会有明显卡顿。
- 同一环境下连接设备数量建议不超过 30 个，超过后可能出现：
- 响应延迟明显增加
- 部分设备无法正常通信
- 出现输入丢失或冲突现象
推荐使用场景
| 通信方式 | 优点 | 缺点 |
|---|---|---|
| USB/OTG | 稳定、低延迟 | 需要有线连接 |
| 蓝牙 | 无线便捷 | 存在延迟与干扰 |
开发与打包提示
- 请使用 Bot.js App v19238 或更高版本，直接集成打包键鼠功能模块。
如需进一步自定义协议或扩展支持，欢迎查看开发文档或联系官方支持。