前言
在现代化的智能家居系统中，Hub 控制器是不可或缺的设备。而 Harmony Hub 是业内最有名的智能遥控器制造商 Logitech 提供的产品之一，通过它用户可以通过手机、平板、电脑等多种方式对家中各种设备进行控制。
本文将为大家详细介绍 Harmony Hub 控制器的 npm 包 harmonyhubws 的使用方法，帮助大家更加方便地控制家中的设备。
安装
在开始之前，你需要先安装 Node.js，如果你还没有安装的话。安装 Node.js 方法有很多，这里我们将介绍一种方便通用的方式，即通过 Node.js 的版本管理工具 nvm 来安装和管理 Node.js 版本。
- 安装 nvm
nvm (Node Version Manager) 是一个 Node.js 版本管理工具，可以对安装在本机的 Node.js 进行版本管理，从而更加方便地切换不同版本的 Node.js。通过以下命令来安装 nvm：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash
- 安装 Node.js
通过以下命令安装 Node.js：
nvm install 12
在安装完成后，可以通过以下命令来检查 Node.js 是否已安装成功：
node -v # 输出 Node.js 的版本号
- 安装 Harmony Hub 模块
在终端命令行中输入以下命令来安装 harmonyhubws 模块：
npm install harmonyhubws
使用
在你安装模块成功后，你可以在你的代码中使用 require 来引入模块，如下所示：
-- -------------------- ---- -------
----- ------- - -----------------------
-- --- ------- ---
---------------------------
--------- -- -
---------------------- -- ------------ ---------------
------ ---
--
------------ -- -
--------------------- -- ------- -- --- ---- ----------
--上述代码创建了一个新的 Harmony Hub 连接，并打印了连接成功的消息。这里的 process.env.HUB_IP 表示你需要设置一个环境变量 HUB_IP 来表示你的 Harmony Hub 的 IP 地址。
接下来，我们将介绍 harmonyhubws 模块的常用 API。
discoverHubs()
discoverHubs() 方法可以帮助你自动扫描网络中所有的 Harmony Hub 并返回其 IP 地址列表。如下所示：
-- -------------------- ---- -------
----- ------- - -----------------------
-- -- ------- ---
----------------------
---------- -- -
------------------ ----- ---------
------ ----
--
------------ -- -
--------------------- -- -------- ----- ----------
--上述代码会扫描网络中的 Harmony Hub 并打印出找到的 Hub 的 IP 地址列表，如果扫描失败则会打印错误信息。
getWebSocket()
getWebSocket() 方法可以帮助你获取 Harmony Hub 的 WebSocket 连接。如下所示：
-- -------------------- ---- -------
----- ------- - -----------------------
-- --- ------- ---
---------------------------
--------- -- -
---------------------- -- ------------ ---------------
-- -- --------- --
----- --------- - ------------------
------------------------- ------- --------
----------------------- --------- -- ---------------------
------ ---
--
------------ -- -
--------------------- -- ------- -- --- ---- ----------
--上述代码创建了一个新的 Harmony Hub 连接，并获取了其 WebSocket 连接对象，通过该对象我们可以发送 WebSocket 消息并监听其接收到的消息。
getCurrentActivity()
getCurrentActivity() 方法可以帮助你获取 Harmony Hub 当前的活动（Activity）。如下所示：
-- -------------------- ---- -------
----- ------- - -----------------------
-- --- ------- ---
---------------------------
--------- -- -
---------------------- -- ------------ ---------------
-- ------
------------------------
---------------- -- -------------------- -------- -- ----------------
------------ -- --------------------- -- --- ------- --------- -----------
------ ---
--
------------ -- -
--------------------- -- ------- -- --- ---- ----------
--上述代码会连接到 Harmony Hub 并打印其当前活动的 ID。如果 Harmony Hub 当前没有活动，则会打印出错误信息。
startActivity()
startActivity() 方法可以帮助你启动一个活动。如下所示：
-- -------------------- ---- -------
----- ------- - -----------------------
-- --- ------- ---
---------------------------
--------- -- -
---------------------- -- ------------ ---------------
-- ----
-----------------------------
-------- -- --------------------- -----------
------------ -- --------------------- -- ----- --------- -----------
------ ---
--
------------ -- -
--------------------- -- ------- -- --- ---- ----------
--上述代码会连接到 Harmony Hub 并启动一个名为 watch_tv 的活动。如果活动启动失败，则会打印出错误信息。
示例代码
下面是一个完整的例子，它可以连接到 Harmony Hub 并启动 watch_tv 的活动：
-- -------------------- ---- -------
----- ------- - -----------------------
----- ------ - ------------------ -- ---------------
----- -------- ------ -
--- -
-- --- ------- ---
----- --- - ----- ---------------
-- ----
----- -----------------------------
-------------------- -----------
-- ----
---------------- -- -- -
----- -------------
------------------- ------
-- -----
- ----- ------- -
--------------------- -- ------- -- --- ---- ----------
-
-
------上述代码先通过 harmony() 方法连接到 Harmony Hub，然后启动 watch_tv 的活动，并在 5 秒后关闭电视。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/104466