USBDevice

有限可用性

此功能不是基线,因为它在一些最常用的浏览器中无法正常工作。

实验性: 这是一个 实验性技术
在生产环境中使用之前,请仔细查看 浏览器兼容性表

安全上下文: 此功能仅在 安全上下文(HTTPS)中,某些或所有 支持的浏览器 中可用。

USBDevice 接口是 WebUSB API 的一部分,它提供了对已配对 USB 设备元数据的访问,以及用于控制该设备的方法。

实例属性

USBDevice.configuration 只读 实验性

一个 USBConfiguration 对象,用于已配对 USB 设备的当前选定接口。

USBDevice.configurations 只读 实验性

用于控制已配对 USB 设备的设备特定接口的 数组

USBDevice.deviceClass 只读 实验性功能

用于识别 USB 设备以加载与该设备兼容的 USB 驱动程序的三个属性之一。另外两个属性是 USBDevice.deviceSubclassUSBDevice.deviceProtocol

USBDevice.deviceProtocol 只读 实验性功能

用于识别 USB 设备以加载与该设备兼容的 USB 驱动程序的三个属性之一。另外两个属性是 USBDevice.deviceClassUSBDevice.deviceSubclass

USBDevice.deviceSubclass 只读 实验性功能

用于识别 USB 设备以加载与该设备兼容的 USB 驱动程序的三个属性之一。另外两个属性是 USBDevice.deviceClassUSBDevice.deviceProtocol

USBDevice.deviceVersionMajor 只读 实验性功能

设备在语义版本控制方案中的主版本号。

USBDevice.deviceVersionMinor 只读 实验性功能

设备在语义版本控制方案中的次版本号。

USBDevice.deviceVersionSubminor 只读 实验性功能

设备在语义版本控制方案中的补丁版本号。

USBDevice.manufacturerName 只读 实验性功能

制造 USB 设备的组织名称。

USBDevice.opened 只读 实验性功能

指示是否已与配对的 USB 设备启动会话。

USBDevice.productId 只读 实验性功能

制造商定义的代码,用于识别 USB 设备。

USBDevice.productName 只读 实验性功能

制造商定义的名称,用于识别 USB 设备。

USBDevice.serialNumber 只读 实验性功能

特定 USB 设备的制造商定义的序列号。

USBDevice.usbVersionMajor 只读 实验性功能

声明设备支持的 USB 协议版本的三个属性之一。另外两个属性是 USBDevice.usbVersionMinorUSBDevice.usbVersionSubminor

USBDevice.usbVersionMinor 只读 实验性功能

声明设备支持的 USB 协议版本的三个属性之一。另外两个属性是 USBDevice.usbVersionMajorUSBDevice.usbVersionSubminor

USBDevice.usbVersionSubminor 只读 实验性功能

声明设备支持的 USB 协议版本的三个属性之一。另外两个属性是 USBDevice.usbVersionMajorUSBDevice.usbVersionMinor

USBDevice.vendorId 只读 实验性功能

usb.org 官方分配的供应商 ID。

实例方法

USBDevice.claimInterface() 实验性功能

返回一个 Promise,该 Promise 在请求的接口被声明为独占访问权限时解析。

USBDevice.clearHalt() 实验性功能

返回一个 Promise,该 Promise 在暂停状态被清除时解析。

USBDevice.controlTransferIn() 实验性功能

返回一个 Promise,该 Promise 在命令或状态操作已传输到 USB 设备时解析为 USBInTransferResult

USBDevice.controlTransferOut() 实验性功能

返回一个 Promise,该 Promise 在命令或状态操作已从 USB 设备传输时解析为 USBOutTransferResult

USBDevice.close() 实验性功能

返回一个 Promise,该 Promise 在所有打开的接口都被释放并且设备会话已结束时解析。

USBDevice.forget() 实验性功能

返回一个 Promise,该 Promise 在所有打开的接口都被释放,设备会话已结束,并且权限被重置后解析。

USBDevice.isochronousTransferIn() 实验性功能

返回一个 Promise,该 Promise 在时间敏感信息已传输到 USB 设备时解析为 USBIsochronousInTransferResult

USBDevice.isochronousTransferOut() 实验性功能

返回一个 Promise,该 Promise 在时间敏感信息已从 USB 设备传输时解析为 USBIsochronousOutTransferResult

USBDevice.open() 实验性功能

返回一个 Promise,该 Promise 在设备会话已启动时解析。

USBDevice.releaseInterface() 实验性功能

返回一个 Promise,该 Promise 在声明的接口从独占访问权限中释放时解析。

USBDevice.reset() 实验性功能

返回一个 Promise,该 Promise 在设备被重置,所有应用程序操作被取消并且它们的 Promise 被拒绝时解析。

USBDevice.selectAlternateInterface() 实验性功能

返回一个 Promise,该 Promise 在指定的替代端点被选择时解析。

USBDevice.selectConfiguration() 实验性功能

返回一个 Promise,该 Promise 在指定的配置被选择时解析。

USBDevice.transferIn() 实验性功能

返回一个 Promise,该 Promise 在从 USB 设备接收批量或中断数据时解析为 USBInTransferResult

USBDevice.transferOut() 实验性功能

返回一个 Promise,该 Promise 在批量或中断数据发送到 USB 设备时解析为 USBOutTransferResult

规范

规范
WebUSB API
# device-usage

浏览器兼容性

BCD 表格仅在浏览器中加载