npm 包 @nodert-win10/windows.devices.lights 使用教程

前言

在现代操作系统中，灯光设备已经是不可或缺的了。在 Windows 10 操作系统中，灯光设备也得到了大力的支持，Windows.Devices.Lights 命名空间提供了一系列用于控制灯光设备的 API。

本文讲解如何使用 npm 包 @nodert-win10/windows.devices.lights，让你在 Node.js 中也能便捷地操作 Windows 10 中的灯光设备。

安装

打开命令行工具，使用 npm 安装 @nodert-win10/windows.devices.lights：

npm install @nodert-win10/windows.devices.lights

使用

在代码中，可以使用 require 在 Node.js 中引入 @nodert-win10/windows.devices.lights 模块：

const Light = require('@nodert-win10/windows.devices.lights');

创建灯光设备实例

在使用 API 之前，需要创建一个灯光设备实例。这里使用的是默认的灯光设备实例，如果有多个灯光设备实例，也需要指定相应的 Id。

const device = new Light();

获取灯光设备信息

可以通过 LightInfo 属性获取灯光设备的信息，包括设备名、供应商、版本等。

console.log(device.lightInfo);

获取可用的灯光灯泡

使用 getLamps 方法可以获取可用的灯光灯泡。

device.getLamps()
  .then(lamps => console.log(lamps))
  .catch(error => console.error(error));

控制灯光灯泡

使用 enable 方法可以打开灯光灯泡，使用 disable 方法可以关闭灯光灯泡。

device.getLamps()
  .then(lamps => {
    const lamp = lamps[0];
    device.enable(lamp.id).catch(error => console.error(error));
    device.disable(lamp.id).catch(error => console.error(error));
  })
  .catch(error => console.error(error));

控制灯光亮度

使用 setBrightness 方法可以设置灯光亮度，参数为灯光灯泡 Id 和亮度值，可以是 0 到 1 之间的小数。

device.getLamps()
  .then(lamps => {
    const lamp = lamps[0];
    device.setBrightness(lamp.id, 0.5).catch(error => console.error(error));
  })
  .catch(error => console.error(error));

控制灯光色温

使用 setColorTemperature 方法可以设置灯光色温，参数为灯光灯泡 Id 和色温值，可以是 0 到 1 之间的小数。

device.getLamps()
  .then(lamps => {
    const lamp = lamps[0];
    device.setColorTemperature(lamp.id, 0.5).catch(error => console.error(error));
  })
  .catch(error => console.error(error));

结语

本文介绍了如何在 Node.js 中使用 npm 包 @nodert-win10/windows.devices.lights，掌握了基本的操作流程和 API 调用方法。当然，还可以根据自己的需求进行更多的扩展和开发。

来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60066bce967216659e244abb