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

HIDInputReportEvent

· 52CE 我爱测

WebHID APIwindow_and_worker_except_shared

WebHID APIwindow_and_worker_except_shared

WebHID API 的 HIDInputReportEvent 接口会在任何关联的 HID 设备接收到输入报告时,被传递给 HIDDevice 的 HIDDevice.inputreport_event 事件。

实例属性

此接口从其父接口 Event 继承属性。

  • HIDInputReportEvent.data
    • : 包含来自于输入报告数据的 DataView,如果 HID 接口使用报告 ID,则不包含 reportId。
  • HIDInputReportEvent.device
    • : 表示发送输入报告的 HID 接口的 HIDDevice 实例
  • HIDInputReportEvent.reportId
    • : 此报告的单字节标识前缀,如果 HID 接口不使用报告 ID,则返回 0。

实例方法

此接口从其父接口 Event 继承方法。

示例

以下示例演示如何监听 inputreport 事件,该事件允许应用程序检测到 Joy-Con 右手柄设备上的哪个按钮被按下。你可以在文章连接到不常见的 HID 设备中看到更多示例和实时演示。

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]}。`);
});

规范

浏览器兼容性

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

资料来源与适用范围

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

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

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