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

HIDDevice:sendReport() 方法

· 52CE 我爱测

WebHID APIwindow_and_worker_except_shared

WebHID APIwindow_and_worker_except_shared

HIDDevice 接口的 sendReport() 方法发送 HID 设备的输出报告。

可以从 HIDDevice.collections 中检索此设备支持的每种报告格式的 reportId。

语法

sendReport(reportId, data)

参数

  • reportId
    • : 一个 8 位的报告 ID。如果设备没有报告 ID,则返回 0。
  • data
    • : ArrayBuffer、TypedArray 或 DataView 形式的字节序列。

返回值

一个 Promise,会在报告发送时兑现为 undefined。

异常

  • NotAllowedError DOMException
    • : 如果因任何原因尝试发送报告失败,则抛出异常。

示例

以下示例演示如何使 Joy-Con 设备振动。你可以在文章连接到不常见的 HID 设备中看到更多示例和实时演示。

// 首先,发送一条命令以启用振动。
// 魔数序列来自 https://github.com/mzyy94/joycon-toolweb
const enableVibrationData = [1, 0, 1, 64, 64, 0, 1, 64, 64, 0x48, 0x01];
await device.sendReport(0x01, new Uint8Array(enableVibrationData));

// 然后,发送一条命令以使 Joy-Con 设备震动。
// 实际的字节序列在示例中提供。
const rumbleData = [/* … */];
await device.sendReport(0x10, new Uint8Array(rumbleData));

规范

浏览器兼容性

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

资料来源与适用范围

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

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

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