前言
在 Windows 10 开发中，Human Interface Device（HID）是一种非常重要的设备类型。HID 设备可以通过内置的 USB 或蓝牙接口连接到计算机，并通过各种输入元素（如按钮、滑块和轮盘）与用户进行交互。而 @nodert-win10/windows.devices.humaninterfacedevice 这个 npm 包就提供了非常方便的方法来操作 HID 设备。
安装
使用 npm 可以很容易地安装此包。在命令行中输入以下命令即可安装：
npm install @nodert-win10/windows.devices.humaninterfacedevice
使用
在安装之后，就可以使用 windows.devices.humaninterfacedevice 这个模块来使用 HID 设备。接下来，我们将详细介绍如何使用此模块。
导入模块
首先，需要在代码文件中导入此模块。可以使用以下代码：
const HID = require('@nodert-win10/windows.devices.humaninterfacedevice');
获取 HID 设备
使用 HID.getHidDeviceClassAsync 函数，可以获取可用的 HID 设备列表。此函数返回一个 HidDeviceClass 对象，该对象表示 HID 设备的集合。使用以下代码获取设备列表：
let deviceSelector = HID.HidDevice.getDeviceSelector(usagePage, usageId); let devices = await HID.HidDevice.getHidDeviceClassAsync(deviceSelector, accessibility);
这里的参数 usagePage 和 usageId 用于指定要查询的 HID 设备的类型。accessibility 参数表示所需要的设备访问权限，可选值包括 HidDeviceAccessMode.readWrite 和 HidDeviceAccessMode.readOnly。这个函数返回一个 Promise，需要使用 await 等待异步操作完成。
打开和关闭 HID 设备
在获取到 HidDeviceClass 对象后，可以使用 openDeviceAsync 函数打开 HID 设备。使用下面的代码打开指定的 HID 设备：
let device = await devices.getAt(0).openDeviceAsync(HID.HidDeviceAccessMode.readWrite, HID.HidDeviceSharingMode.exclusive);
同理，使用 close 函数可以关闭设备：
await device.close();
接收 HID 设备的输入
在打开 HID 设备之后，使用 InputReportReceived 事件可以接收 HID 设备的输入。使用以下代码订阅该事件：
device.inputReportReceived = function(eventArgs) { // 处理事件 };
在事件处理程序中，可以使用 eventArgs.report.readReportData 函数来读取输入报告中的数据。例如，使用以下代码来处理鼠标设备的输入：
device.inputReportReceived = function(eventArgs) { let x = eventArgs.report.readReportData(1)[0]; let y = eventArgs.report.readReportData(2)[0]; console.log(`鼠标移动了: (${x},${y})`); };
发送 HID 设备的输出
在打开 HID 设备之后，使用 sendOutputReportAsync 函数可以向 HID 设备发送输出。使用以下代码向指定的 HID 设备发送输出：
let buffer = new Uint8Array([1, 2, 3]).buffer; await device.sendOutputReportAsync(buffer);
示例代码
以下是完整的示例代码，可以运行并测试 @nodert-win10/windows.devices.humaninterfacedevice 的所有功能：
-- -------------------- ---- ------- ----- --- - -------------------------------------------------------------- --- -------------- - ------------------------------------------------------ ------------------- --- ------- - ----- ---------------------------------------------------- ----------------------------------- --- ------ - ----- ------------------------------------------------------------------- ------------------------------------ -------------------------- - ------------------- - --- - - -------------------------------------- --- - - -------------------------------------- ------------------- -------------- -- --- ------ - --- -------------- -- ----------- ----- -------------------------------------展开代码
总结
通过本文介绍，我们了解了如何使用 @nodert-win10/windows.devices.humaninterfacedevice 这个 npm 包来操作 HID 设备。从获取 HID 设备列表到打开和关闭设备，再到接收和发送 HID 设备的输入和输出，本文对 HID 设备的所有关键操作都进行了详细介绍。我们希望读者能够通过本文学到更多关于 HID 设备的知识，并在实际开发中灵活使用。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60066bce967216659e244ac9
