WebHID API可在支持的浏览器中实现网页与HID设备的双向通信。首先需在HTTPS环境下检查浏览器兼容性:if ('hid' in navigator)。通过navigator.hid.requestDevice()请求用户授权并选择设备,可使用vendorId、productId等过滤。连接后调用device.open()并监听inputreport事件接收数据,数据为DataView格式,需解析为Uint8Array处理。如设备支持,可用sendReport发送输出报告控制硬件。目前Chrome 89+支持,核心难点在于理解设备特定的数据协议。

WebHID API 让网页可以直接与键盘、鼠标、游戏手柄等 HID 设备通信,适用于需要精细控制硬件的场景。要使用 WebHID 接入设备,需通过浏览器请求用户授权并建立连接。
启用与检测 WebHID 支持
目前 WebHID 主要在 Chrome 89+ 和部分基于 Chromium 的浏览器中支持。使用前先检查浏览器是否支持:
if ('hid' in navigator) {
console.log('WebHID 可用');
} else {
console.log('当前浏览器不支持 WebHID');
}
注意:页面必须运行在 HTTPS 环境下(或本地开发时的 localhost),否则 API 不可用。
请求连接 HID 设备
调用 navigator.hid.requestDevice() 弹出设备选择框,用户可从中授权一个或多个设备:
const devices = await navigator.hid.requestDevice({
filters: [{ vendorId: 0x1234, productId: 0x5678 }] // 按厂商/产品 ID 过滤
});
如果不指定 filters,用户可以看到所有可识别的 HID 设备。常见字段还包括 usagePage 和 usage,用于按功能筛选(如游戏控制器、条码扫描器)。
监听输入数据
设备连接后,需打开会话并监听输入报告:
币商智能量化机器人交易系统具备接入火币,ok币,币安,比特儿系统的API接口,用户只需开通API权限即可接入,由于无转出转入权限,所以非常安全,设置机器人点位24小时自动量化交易。
for (const device of devices) {
await device.open();
device.addEventListener('inputreport', (event) => {
const { data, reportId } = event;
const bytes = new Uint8Array(data.buffer);
console.log(`收到数据,Report ID: ${reportId}`, bytes);
});
}
inputreport 事件会在设备发送数据时触发,data 是一个 DataView 对象,需根据设备协议解析原始字节。
发送输出报告(可选)
若设备支持写入操作(如控制 LED 或震动反馈),可通过 sendReport 发送数据:
await device.sendReport(reportId, new Uint8Array([0x01, 0x02, 0x03]));
reportId 和数据格式需参考设备文档,错误的格式可能导致无响应或设备异常。
基本上就这些。只要设备被正确识别且用户授权,WebHID 能实现稳定的双向通信。难点通常在于理解设备的数据格式和用途定义。建议配合官方 SDK 或抓包工具分析原始数据流。









