当前位置：首页 > 文章列表 > 文章 > 前端 > JS搞不定WebHID？手把手教你用这3招轻松玩转！

JS搞不定WebHID？手把手教你用这3招轻松玩转！

2025-06-21 15:00:18 0浏览收藏

推广推荐

支持 PC / 移动端，安全直达

想知道如何用JavaScript玩转WebHID设备吗？本文手把手教你三大核心操作方法，让你轻松掌握与HID设备通信的技巧。首先，通过`navigator.hid.requestDevice()`请求设备权限，并使用`vendorId`和`productId`进行精准筛选，确保用户选择正确的设备。其次，监听`inputreport`事件接收设备数据，并通过`DataView`转换为`Uint8Array`进行解析，获取关键信息。最后，利用`sendReport`或`sendFeatureReport`方法，以`Uint8Array`格式向设备发送指令。此外，文章还深入探讨了WebHID API的兼容性、设备断开处理以及安全性保障，助你全面了解并有效利用WebHID API，无需中间驱动，直接与HID设备交互。

要使用JavaScript操作WebHID设备，核心在于掌握WebHID API的三大步骤：请求设备权限、读取数据和发送数据。首先，调用navigator.hid.requestDevice()并指定vendorId与productId过滤设备，获取授权后打开设备；其次，监听inputreport事件接收数据，并通过DataView转为Uint8Array解析；最后，使用sendReport或sendFeatureReport方法发送数据，注意数据格式需为Uint8Array。此外，需处理disconnect事件以应对设备断开，并检查浏览器兼容性。WebHID API通过用户授权机制保障安全性，确保仅在许可下访问设备。

js怎样操作WebHID设备 HID设备交互的3个核心方法

js操作WebHID设备，核心在于理解和运用浏览器的WebHID API，它让JavaScript可以直接与HID设备通信，无需中间驱动。主要涉及请求设备访问权限、读取设备数据和发送数据给设备。

解决方案

请求设备访问权限：

首先，你需要调用navigator.hid.requestDevice()来请求用户授权访问HID设备。这个函数返回一个Promise，resolve后会得到一个HIDDevice对象数组。

async function requestHIDDevice() {
  const filters = [{ vendorId: 0x1234, productId: 0x5678 }]; // 替换成你的设备ID
  try {
    const devices = await navigator.hid.requestDevice({ filters });
    if (devices.length > 0) {
      const device = devices[0];
      await device.open(); // 打开设备
      console.log("HID Device connected:", device);
      return device;
    } else {
      console.log("No HID device selected.");
      return null;
    }
  } catch (error) {
    console.error("Error accessing HID device:", error);
    return null;
  }
}

这里的filters允许你指定设备的vendorId和productId，这对于只允许用户选择特定设备非常重要。 Vendor ID 和 Product ID可以在设备管理器中找到，或者通过一些USB设备检测工具获取。

读取设备数据：
一旦设备成功打开，就可以监听inputreport事件来接收数据。
```
async function startReading(device) {
  device.addEventListener("inputreport", (event) => {
    const { data, reportId } = event;
    const uint8Array = new Uint8Array(data.buffer);
    console.log(`Received data (Report ID: ${reportId}):`, uint8Array);
    // 在这里处理接收到的数据
  });

  device.addEventListener("disconnect", () => {
      console.log("HID Device disconnected");
  });
}
```
inputreport事件会提供一个DataView对象，你需要将其转换为Uint8Array或其他合适的格式，然后解析其中的数据。 reportId 是一个重要的标识符，它允许设备发送不同类型的数据，你需要根据 reportId 来区分和处理这些数据。断开连接事件监听器也很重要，可以及时处理设备断开的情况。
发送数据给设备：
使用device.sendReport()或device.sendFeatureReport()方法可以发送数据给HID设备。
```
async function sendData(device, reportId, data) {
  try {
    await device.sendReport(reportId, data); // data 是一个 Uint8Array
    console.log("Data sent successfully.");
  } catch (error) {
    console.error("Error sending data:", error);
  }
}
```
sendReport()用于发送普通的输出报告，而sendFeatureReport()用于发送特征报告，通常用于配置设备的某些参数。 reportId 同样重要，它告诉设备如何处理接收到的数据。 data 必须是一个 Uint8Array，你需要将你的数据转换为这个格式。