android BLE HID模拟点击

### 实现Android设备通过BLE HID协议模拟鼠标点击或键盘输入

为了使Android设备能够作为BLE HID（Human Interface Device）外设工作并执行诸如鼠标点击或键盘输入的操作，开发者需利用特定API和遵循一定的开发流程。

#### 初始化BluetoothHidDevice对象
创建`BluetoothHidDevice`实例之前，先要获取到`BluetoothAdapter`单例对象。接着注册一个广播接收者监听来自远程中央节点的连接请求，并设置回调接口用于处理数据传输事件[^3]。

// 获取默认的蓝牙适配器
final BluetoothManager bluetoothManager =
        (BluetoothManager) getSystemService(Context.BLUETOOTH_SERVICE);
mBluetoothAdapter = bluetoothManager.getAdapter();

// 创建BluetoothHidDeviceCallback匿名内部类
BluetoothHidDevice.Callback callback = new BluetoothHidDevice.Callback() {
    @Override
    public void onConnectionStateChanged(BluetoothDevice device, int state) {}

    @Override
    public boolean sendReport(BluetoothDevice device, byte id,
                              byte[] report) {return true;}

    @Override
    public void onCreateVirtualUnplug(BluetoothDevice device) {}
};

// 注册BluetoothHidDevice服务配置文件
IntentFilter filter = new IntentFilter();
filter.addAction(BluetoothHidDevice.ACTION_CONNECTION_STATE_CHANGED);
registerReceiver(mBroadcastReceiver, filter);

mBluetoothHidDevice = new BluetoothHidDevice(this, mServiceRecord, callback);

#### 设置虚拟按键映射表
对于想要发送给主机端的具体动作，比如鼠标的左键点击或是按下某个字母键，则需要定义相应的报告描述符(report descriptor)，它规定了每种类型的输入所对应的字节序列。这部分通常由硬件制造商提供标准模板，但对于软件层面来说也可以自行构建简单版本满足基本需求[^5]。

#### 发送控制指令
当接收到用户触发的动作信号时，调用`sendReport()`方法向已建立链接的目标设备传递封装好的命令包。这里以模拟一次回车键为例：

private static final byte KEYBOARD_ENTER = 0x28;

public void simulateKeyPress(int keyCode){
    // 构造键盘输入报文
    byte[] keyDownReport = {(byte)(keyCode & 0xFF)};
    
    // 向目标设备发送按键消息
    if (!mBluetoothHidDevice.sendReport(device, REPORT_ID_KEYBOARD, keyDownReport)) {
        Log.e(TAG,"Failed to send keyboard press event");
    }
}

针对鼠标的移动及按钮状态变化同样适用此逻辑，只需调整参数即可完成不同种类的人机交互行为仿真[^1]。