大网数据广告活动
Web 标准与前端开发

HIDDevice

· 52CE 我爱测

WebHID APIwindow_and_worker_except_shared

WebHID APIwindow_and_worker_except_shared

WebHID API 的 HIDDevice 接口表示人机接口(HID)设备。它提供了用于访问设备信息的属性,打开和关闭的方法,以及发送和接收报告的功能。

实例属性

此接口也从其父接口 EventTarget 继承属性。

  • HIDDevice.opened
    • : 返回一个 Boolean 值,如果设备已打开连接,则为 true。
  • HIDDevice.vendorId
    • : 返回 HID 设备的供应商 ID。
  • HIDDevice.productId
    • : 返回 HID 设备的产品 ID。
  • HIDDevice.productName
    • : 返回一个包含 HID 设备产品名称的字符串。
  • HIDDevice.collections
    • : 返回 HID 设备的报告格式数组。

事件

  • HIDDevice.inputreport_event
    • : 当设备发送报告时触发。

实例方法

此接口也从其父接口 EventTarget 继承方法。

  • HIDDevice.open()
    • : 打开此 HID 设备的连接,并返回一个会在连接成功时兑现的 Promise。
  • HIDDevice.close()
    • : 关闭此 HID 设备的连接,并返回一个会在连接关闭时兑现的 Promise。
  • HIDDevice.forget()
    • : 关闭此 HID 设备的连接并重置访问权限,然后返回一个会在权限被重置时兑现的 Promise。
  • HIDDevice.sendReport()
    • : 向此 HID 设备发送输出报告,并返回一个会在报告发送成功时兑现的 Promise。
  • HIDDevice.sendFeatureReport()
    • : 向此 HID 设备发送一个特征报告,并返回一个会在报告发送成功时兑现的 Promise。
  • HIDDevice.receiveFeatureReport()
    • : 从 HID 设备接收一个特征报告,以 Promise 的形式兑现为 DataView。从而允许以类型化的方式访问此消息的内容。

示例

以下示例演示如何监听 inputreport 事件,该事件允许应用程序检测到 Joy-Con 右手柄设备上的哪个按钮被按下。

device.addEventListener("inputreport", (event) => {
  const { data, device, reportId } = event;

  // 处理 Joy-Con 右手柄设备和特定的报告 ID
  if (device.productId !== 0x2007 && reportId !== 0x3f) return;

  const value = data.getUint8(0);
  if (value === 0) return;

  const someButtons = { 1: "A", 2: "X", 4: "B", 8: "Y" };
  console.log(`用户按下了 ${someButtons[value]}。`);
});

在以下示例中,用 sendFeatureReport 使设备闪烁。

const reportId = 1;
for (let i = 0; i < 10; i++) {
  // 关闭
  await device.sendFeatureReport(reportId, Uint32Array.from([0, 0]));
  await new Promise((resolve) => setTimeout(resolve, 100));
  // 打开
  await device.sendFeatureReport(reportId, Uint32Array.from([512, 0]));
  await new Promise((resolve) => setTimeout(resolve, 100));
}

你可以在文章连接到不常见的 HID 设备中看到更多示例和实时演示。

规范

浏览器兼容性

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。