npm 包 homebridge-smarthome-plus 使用教程

阅读时长 10 分钟读完

前言

homebridge-smarthome-plus 是一个基于 Homebridge 扩展的 npm 包,用于连接智能家居设备,以在 iOS 上使用 HomeKit 控制。本文将为大家介绍如何使用 homebridge-smarthome-plus 连接智能家居设备。

准备工作

安装 Homebridge

在开始使用 homebridge-smarthome-plus之前,我们需要先安装 Homebridge。Homebridge 是一个在非苹果设备上运行的开源软件,它能够将普通的智能家居设备变成兼容 HomeKit 的设备,让你的非苹果设备也能通过 iOS 控制 HomeKit。

Homebridge 的安装请参考:Homebridge 安装指南

安装 homebridge-smarthome-plus

在安装完 Homebridge 后,我们需要安装 homebridge-smarthome-plus:

设备兼容性

HomeKit 并非支持所有智能家居设备。在使用 homebridge-smarthome-plus 之前,请先确认你的设备是否兼容 HomeKit。你可以在苹果官网上查找支持 HomeKit 的设备列表:https://www.apple.com/cn/ios/home/accessories/

查找智能家居设备信息

在使用 homebridge-smarthome-plus 联接智能家居设备之前,我们需要了解设备的信息,包括设备名称、设备 ID、控制方式等。你可以从设备厂商提供的文档中找到这些信息。

使用 homebridge-smarthome-plus

1. 创建配置文件

在 Homebridge 安装目录下创建一个新的配置文件 config.json,然后输入以下内容:

-- -------------------- ---- -------
-
    --------- -
        ------- -------------
        ----------- --------------------
        ------- ------
        ------ ------------
    --
 
    -------------- ----- -- -- ------- ------------- --- ----- ---- ------
 
    ------------ -
        -
            ----------- ----------------
            ------- ------ ---- ------
 
            ---------- -
                -
                    ------- ------- ---
                    ---------------- ------
                    ----------- ---------
                    --------------- ------------- ---
                    -------- ------- ----- ---
                    --------- ------- ------ ---
                    -------------- -------------------------------------------------------------------
                    --------------- ------------------------------------------------------------------
                --
                -
                    ------- ------- ---
                    ---------------- ------------
                    ----------- ---------
                    --------------- ------------- ---
                    -------- ------- ----- ---
                    --------- ------- ------ ---
                    -------------- -------------------------------------------------------------------
                    --------------- ------------------------------------------------------------------
                -
            -
        -
    -
 
-

配置文件详解

  • bridge: 描述 Homebridge 服务器的信息
  • description: 描述该配置文件的信息
  • platforms: 定义 homebridge-smarthome-plus 的配件信息
  • devices: 描述每个配件的信息,包括名称、型号、ID、访问令牌等

接下来,我们逐一解析一下配置信息。

bridge

  • name: Homebridge 服务器的名称
  • username: 该服务器的 MAC 地址
  • pin: HomeKit 配对码。该代码用于将设备连接到 HomeKit。请注意,你可以自定义该配对码,但需要注意配对码的规范。

platforms

  • platform: 连接到 homebridge-smarthome-plus 的设备平台
  • name: 该平台的名称
  • devices: 或多个配件节点的信息,每个智能家居设备都可以被视为一个配件,需要将其信息填入此节点中。

devices

  • accessoryType: 物联网设备类型。当前支持 Air Conditioner、DoorLock、Fan、HumidifierDehumidifier、Lightbulb、Outlet 等类型。
  • name: 配件名称
  • deviceId: 物联网设备 ID
  • manufacturer: 物联网设备厂商
  • model: 物联网设备型号
  • serial: 物联网设备序列号
  • accessTokenrefreshToken: 智能家居设备的访问授权码,使用其中的访问令牌和更新标记。

2. 联接智能家居设备

在创建好配置文件后,通过以下命令启动 homebridge-smarthome-plus:

在 Terminal 中输入该命令并按 Enter,然后你将会在终端窗口中看到类似以下的信息:

-- -------------------- ---- -------
----------- ------- --- ------ ------- -------------------------
----------- ------- --- ----------- --------- ------- --
----------- ------- --- ----------- --------- ------- --
----------- ------- --- -----------------
    ---------- ---- -------- ---
    ---------- --- -------- -----
    ---------- --------- --------- -------- -----
    ---------- ------ -------- -----
----------- ------- --- ----------- ------------ --------- --------
----------- ------- --- --------------- ------------ ------------- -----------
----------- ------- --- --------------- -------- ------------ ------------- ---------

这表示 homebridge-smarthome-plus 已经成功连接到你配置的智能家居设备。

3. 在 HomeKit 中添加智能家居设备

在联接好智能家居设备后,就可以在 iOS 上的 HomeKit 中添加该设备了。在 Homekit 中,点击「添加设备」,然后按照提示完成连接,你就可以在 iOS 上控制你的智能家居设备了。

示例代码

以下是一个简单的 homebridge-smarthome-plus 示例代码,用于连接一个 Sonoff 智能开关:

-- -------------------- ---- -------
-
    --------- -
        ------- -------------
        ----------- --------------------
        ------- ------
        ------ ------------
    --
 
    -------------- ----- -- -- ------- ------------- --- ----- ---- ------
 
    ------------ -
        -
            ----------- ----------------
            ------- ------ ---- ------
 
            ---------- -
                -
                    ------- --------
                    ---------------- ------------
                    ----------- ---------
                    --------------- ---------
                    -------- ------- -------
                    --------- ----------
                    -------------- -------------------------------------------------------------------
                    --------------- ------------------------------------------------------------------
                --
            -
        -
    -
 
-

在上面的示例代码中,我们以 Sonoff 智能开关为例,将其作为一个智能家居设备进行了连接。在配置文件中,我们需要为 SONOFF 开关提供设备信息,来指明其连接到 HomeKit 。在这里,「deviceId」是 SONOFF 开关的 Wi-Fi ID,而「accessToken」和「refreshToken」代表设备的访问令牌和更新标记。

结语

通过使用 homebridge-smarthome-plus,你可以将非 HomeKit 兼容的智能家居设备接入到 HomeKit,并使用 HomeKit 控制这些设备。上面的教程是基于 Homebridge 平台,希望本文对您有所帮助。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/60057c4181e8991b448ebc6b

纠错
反馈