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

HIDDevice:inputreport 事件

· 52CE 我爱测

WebHID APIwindow_and_worker_except_shared

WebHID APIwindow_and_worker_except_shared

HIDDevice 接口的 inputreport 事件在从 HID 设备接收新报告时会触发。

语法

在诸如 EventTarget.addEventListener 之类的方法中使用事件名称,或设置事件处理器属性。

addEventListener("inputreport", (event) => {});

oninputreport = (event) => {};

事件类型

一个 HIDInputReportEvent。继承自 Event。

HIDInputReportEvent

事件属性

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

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

示例

以下示例演示如何监听 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

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

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