ToB企服应用市场:ToB评测及商务社交产业平台
标题:
webUsb初识
[打印本页]
作者:
何小豆儿在此
时间:
2025-1-6 19:22
标题:
webUsb初识
webUSB初识 --派大星的开发日记
个人开发纪录笔记,仅个人明白,有错误还请指出
概述
WebUSB API 提供了一种将非标准化通用串行总线(USB)兼容设备服务暴露到Web的方法,使USB设备更安全、更易于使用。这项技术目前是实验性的,而且仅在支持的欣赏器的安全上下文中(HTTPS)可用。
概念和用法
USB是连接到盘算机的有线外设的究竟标准,包括键盘、鼠标、视频设备等。
除了标准化设备外,还有许多需要自定义驱动程序的非标准化设备,这些设备之前无法从Web访问。
WebUSB允许这些非标准化USB设备在Web中可用,无需下载和安装驱动程序。
接口
USB:提供从网页中查找和连接USB设备的属性和方法。
USBConnectionEvent:传递给USB的connect或disconnect事件的事件类型。
USBDevice:提供对已配对的USB设备的元数据的访问以及控制方法。
USBInTransferResult和USBOutTransferResult:体现数据传输的结果。
USBIsochronousInTransferPacket和USBIsochronousOutTransferPacket:体现同步端点上数据传输的单个包的状态。
USBIsochronousInTransferResult和USBIsochronousOutTransferResult:体现同步端点上数据传输的结果。
USBConfiguration:提供有关USB设备的特定设置及其支持的接口的信息。
USBInterface和USBAlternateInterface:提供USB设备所提供的接口信息。
USBEndPoint:提供有关USB设备所提供的端点的信息。
设备获取 --需要用户授权
连接设备
let fetchDevices = async () => {
let devices = await navigator.usb.requestDevice({
filters: [
//可以添加`在这里插入代码片`显示条件
]
})
console.log(devices);
};
let btn = document.getElementById('btn');
btn.onclick = fetchDevices;
复制代码
查找已连接的设备
navigator.usb.getDevices().then((devices) => {
devices.forEach((device) => {
console.log(device.productName);
console.log(device.manufacturerName);
});
});
复制代码
返回的数据均是USBdevice实例
实例属性
USBDevice.configuration:只读,当前选择的配对USB设备的接口的USBConfiguration对象。
USBDevice.configurations:只读,设备特定接口的数组,用于控制配对的USB设备。
USBDevice.deviceClass:只读,用于加载与设备兼容的USB驱动程序的三个属性之一。
USBDevice.deviceProtocol:只读,用于加载与设备兼容的USB驱动程序的三个属性之一。
USBDevice.deviceSubclass:只读,用于加载与设备兼容的USB驱动程序的三个属性之一。
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.usbVersionMinor:只读,设备支持的USB协议版本的次要部分。
USBDevice.usbVersionSubminor:只读,设备支持的USB协议版本的修订部分。
USBDevice.vendorId:只读,usb.org官方分配的供应商ID。
实例方法,在次只先容常用的几个
transferIn(endpointNumber)
参数:endpointNumber(必需)- 要从中接收数据的端点的编号。
返回值:Promise<USBInTransferResult> - 剖析为包罗传输结果的对象。
transferOut(endpointNumber, data)
参数:endpointNumber(必需)- 要发送数据到的端点的编号;
data(必需)- 要发送的数据。
返回值:Promise<USBOutTransferResult> - 剖析为包罗传输结果的对象。
selectConfiguration(configurationValue)
参数:configurationValue(必需)- 要选择的设置的编号。
返回值:Promise<void> - 当设置被成功选择时办理。
open()
参数:无
返回值:Promise<void> - 当设备会话成功开始时办理。
claimInterface(interfaceNumber)
参数:interfaceNumber(必需)- 要声明独占访问的接口编号。
返回值:Promise<void> - 当接口被成功声明为独占时办理。
controlTransferIn(setup)
参数:setup(必需)- 控制传输的参数,包括哀求类型、哀求、值、索引和长度。
返回值:Promise<USBInTransferResult> - 剖析为包罗控制传输结果的对象。
controlTransferOut(setup)
参数:setup(必需)- 控制传输的参数,包括哀求类型、哀求、值、索引和长度。
返回值:Promise<USBOutTransferResult> - 剖析为包罗控制传输结果的对象。
close()
参数:无
返回值:Promise<void> - 当全部打开的接口被释放而且设备会话竣事时办理。
selectAlternateInterface(interfaceNumber, alternateSetting)
参数:interfaceNumber(必需)- 接口编号;alternateSetting(必需)- 选择的替换接口设置。
返回值:Promise<void> - 当指定的替换接口被成功选择时办理。
大致流程
/**
* 请求用户选择USB设备
* @returns {Promise<USBDevice>} 选中的USB设备对象
*/
let fetchDevices = async () => {
try {
// 根据条件过滤设备
// filters: [
// { vendorId: 0x2341 }, // 供应商ID,用于匹配特定供应商的设备
// { productId: 0x1234 }, // 产品ID,用于匹配特定产品的设备
// { classCode: 0x02 }, // 设备类代码,用于匹配特定类别的设备
// { subclass: 0x01 }, // 子类代码,用于匹配特定子类的设备
// { protocolCode: 0x01 } // 协议代码,用于匹配特定协议的设备
// ]
let device = await navigator.usb.requestDevice({
filters: [
{ vendorId: 0x2341 } // 示例vendorId,需要替换成实际值
]
});
console.log('选中的设备:', device);
return device;
} catch (error) {
console.error('选择设备失败:', error);
}
};
/**
* 打开USB设备会话
* @param {USBDevice} device - USB设备对象
* @returns {Promise<void>}
*/
let openDevice = async (device) => {
try {
await device.open();
console.log('设备会话已打开');
} catch (error) {
console.error('打开设备会话失败:', error);
}
};
/**
* 声明USB设备的接口
* @param {USBDevice} device - USB设备对象
* @param {number} interfaceNumber - 接口编号
* @returns {Promise<void>}
*/
let claimInterface = async (device, interfaceNumber) => {
try {
await device.claimInterface(interfaceNumber);
console.log('接口已声明');
} catch (error) {
console.error('声明接口失败:', error);
}
};
/**
* 向USB设备发送控制传输数据
* @param {USBDevice} device - USB设备对象
* @param {number} endpointNumber - 端点编号
* @param {Uint8Array} data - 要发送的数据
* @returns {Promise<void>}
*/
let sendControlTransferOut = async (device, endpointNumber, data) => {
try {
// controlTransferOut参数说明:
// requestType: 'standard' | 'class' | 'vendor' - 控制传输的类型
// - 'standard': 标准请求,用于基本控制操作
// - 'class': 类请求,针对特定USB设备类
// - 'vendor': 供应商请求,供应商自定义的请求
// recipient: 'device' | 'interface' | 'endpoint' | 'other' - 控制传输的接收者
// - 'device': 接收者为USB设备
// - 'interface': 接收者为USB设备的特定接口
// - 'endpoint': 接收者为USB设备的特定端点
// - 'other': 其他类型的接收者
const result = await device.controlTransferOut({
requestType: 'vendor', // 供应商定义的控制传输
recipient: 'device', // 控制传输的接收者为设备
request: 0x01, // 请求码,供应商定义
value: 0x00, // 值,供应商定义
index: 0x00, // 索引,供应商定义
length: data.byteLength
}, data);
console.log('控制传输输出成功', result);
} catch (error) {
console.error('控制传输输出失败:', error);
}
};
/**
* 关闭USB设备会话
* @param {USBDevice} device - USB设备对象
* @returns {Promise<void>}
*/
let closeDevice = async (device) => {
try {
await device.close();
console.log('设备会话已关闭');
} catch (error) {
console.error('关闭设备会话失败:', error);
}
};
// 主函数:执行发送数据的整体流程
let sendDataToDevice = async () => {
const device = await fetchDevices(); // 请求设备
if (device) {
await openDevice(device); // 打开设备会话
await claimInterface(device, 0); // 声明接口,这里以接口编号0为例
const dataToSend = new Uint8Array([0x01, 0x02, 0x03, 0x04]); // 要发送的数据
await sendControlTransferOut(device, 0x01, dataToSend); // 发送数据
await closeDevice(device); // 关闭设备会话
}
};
// 执行主函数
sendDataToDevice();
复制代码
往interface写入数据的时间,记得要有out权限哦,in/out一样是不可以的。如果遇到了无法办理的问题,记得试一下webHid
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!更多信息从访问主页:qidao123.com:ToB企服之家,中国第一个企服评测及商务社交产业平台。
欢迎光临 ToB企服应用市场:ToB评测及商务社交产业平台 (https://dis.qidao123.com/)
Powered by Discuz! X3.4