USBDevice: controlTransferIn() 方法

可用性有限

此特性不是基线特性，因为它在一些最广泛使用的浏览器中不起作用。

实验性： 这是一项实验性技术
在生产中使用此技术之前，请仔细检查浏览器兼容性表格。

安全上下文： 此功能仅在安全上下文（HTTPS）中可用，且支持此功能的浏览器数量有限。

注意：此功能在 Web Workers 中可用。

USBDevice 接口的 controlTransferIn() 方法会返回一个 Promise。当命令或状态请求已发送（已由）USB 设备接收后，该 Promise 会解析为一个 USBInTransferResult。

语法

controlTransferIn(setup, length)

一个用于设置选项的对象。可用的选项有：

requestType: 必须是以下三个值之一，用于指定传输是 "standard"（所有 USB 设备通用）、"class"（某个行业标准设备类通用）还是 "vendor"（特定厂商）。
recipient: 指定设备上传输的目标，可以是 "device"、"interface"、"endpoint" 或 "other" 之一。
请求: 特定厂商的命令。
value: 特定厂商请求参数。
index: 接收者的接口编号。

要从设备读取的最大字节数。实际数据在已解析 Promise 的 USBInTransferResult 中。

规范
WebUSB API # dom-usbdevice-controltransferin

此页面最后修改时间为 2025年6月23日，由 MDN 贡献者贡献。