跳转到内容

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 或更高版本,直接集成打包键鼠功能模块。

如需进一步自定义协议或扩展支持,欢迎查看开发文档或联系官方支持。