简介
ecue-programmer-stream 是一个用于控制 e:cue 灯光设备的 npm 包。它提供了丰富的 API,可以让开发者灵活地控制这些设备的各种属性。
安装
使用 npm 安装:
npm install ecue-programmer-stream
使用方法
在使用 ecue-programmer-stream 之前,需要通过 e:cue 的官方软件 e:cue Programmer 将灯光设备与电脑进行连接,确保它们在网络上能够相互通信。然后,在代码中引入 ecue-programmer-stream:
const eCue = require('ecue-programmer-stream');
接下来,我们需要取得对应的设备 ID,以便发送灯光控制指令。我们可以使用 eCue Discover 工具来自动扫描网络中可用的设备:
eCue.Discover().then((devices) => { console.log(devices); });
这将会返回当前网络中所有可用的设备和它们的相关信息,如设备 ID、IP 地址、MAC 地址等等。我们可以根据这些信息来初始化我们想要控制的设备:
const deviceId = '0.0.1.1.255'; // 假设我们要控制的灯光设备 ID 为 0.0.1.1.255 const device = eCue.Connect(deviceId);
现在,我们已经成功地连接到了我们所想要控制的设备上。接下来,我们可以使用各种 API 来控制灯光设备。
API
设备控制
device.Start()
启动灯光设备。
device.Stop()
停止灯光设备。
device.Reset()
重置灯光设备。
device.Pause()
暂停灯光设备。
色彩控制
deviceSetColor(r, g, b)
根据 RGB 值设置灯光设备的颜色。
示例:
device.setColor(255, 0, 0); // 将灯光设备的颜色设置为红色。
device.SetColorTemp(temperature)
根据色温值设置灯光设备的颜色。
示例:
device.setColorTemp(5000); // 将灯光设备的颜色设置为 5000K 的白色。
亮度控制
device.SetBrightness(brightness)
设置灯光设备的亮度。
示例:
device.setBrightness(50); // 将灯光设备的亮度设置为 50%。
调试控制
device.Listen()
将设备的输出流连接到控制台,用于调试。所有设备的输出信息都将被打印到控制台上。
示例:
device.listen();
示例代码
-- -------------------- ---- ------- ----- ---- - ---------------------------------- ----- -------- - -------------- -- ------------ -- - ----------- ----- ------ - ----------------------- -------------------- -- --- -- -------------- ------------------------- -- ----------- ---- ---------------- -- ----------------
总结
ecue-programmer-stream 提供了丰富的 API,可以让开发者方便地控制 e:cue 灯光设备。使用这个包的步骤简单,只需要导入并初始化相应的设备即可开始使用。这个 npm 包对于需要实现一些精细、有趣的灯光特效的开发者来说,无疑是一个非常有用的工具。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/600559e481e8991b448d7835