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 或更高版本,直接集成打包键鼠功能模块。
如需进一步自定义协议或扩展支持,欢迎查看开发文档或联系官方支持。