npm 包 homebridge-mihome 使用教程

阅读时长 6 分钟读完

前言

HomeBridge 是一个基于 Node.js 的,开源的智能家居解决方案。它可以把不支持 HomeKit 的设备接入到 HomeKit 中,使得用户可以通过 Siri 来控制这些设备。而 homebridge-mihome 就是一个可以将小米智能设备接入到 HomeKit 的插件。

本文将详细介绍 npm 包 homebridge-mihome 的安装、使用方法,以及相关的配置说明,包含实例代码,旨在帮助读者深入学习和使用该插件。

安装

首先需要在安装 HomeBridge 的基础上,安装 homebridge-mihome 插件。在安装前,需要确认 HomeBridge 的运行环境已满足以下要求:

  • Node.js 8.9 或以上版本
  • HomeBridge 0.2.0 或以上版本

确认运行环境后,可以通过以下命令进行安装:

配置

当插件安装完毕后,还需要进行一系列的配置才能让插件正常运行。以下是插件的配置(config.json)样例:

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

配置参数说明

  • platform:插件所使用的框架,必须为 MiHome。
  • name:插件的名称,可以自定义。
  • sid:小米网关的 SID。可以在小米智能家庭 App 中找到。
  • password:小米网关的密码。可以在小米智能家庭 App 中找到。
  • useFahrenheit:是否使用华氏度。
  • rooms:每个房间的配置信息,包含房间 ID、名称和设备列表。
  • devices:每个房间中需要注册的设备列表,根据设备的 model 来定义,例如:"xiaomi.aircondition.acpartner"。

插件支持的设备列表

homebridge-mihome 目前支持的设备包括:

  • Sensor
  • Light
  • Switch
  • Outlet
  • Temperature Sensor
  • Humidity Sensor
  • Motion Sensor
  • Contact Sensor
  • Leak Sensor
  • Occupancy Sensor
  • Smoke Sensor
  • Carbon Dioxide Sensor
  • Air Purifier
  • Air Humidifier
  • Air Condition
  • Electric Fan
  • Smart Kettle
  • Robot Vacuum

使用

配置完成后,需要启动 HomeBridge 和 homebridge-mihome 插件。

启动成功后,可以在 HomeBridge 的 Web 界面中看到 homebridge-mihome 插件的设置。

在 HomeKit 中添加智能设备时,可以看到每个房间中注册的设备。可以根据设备的名称操作相应的设备,使用 Siri 进行语音控制。

示例代码

以下是一段打开小米智能台灯的示例代码:

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

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

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

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

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

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

代码中,通过定义 Service 和 Characteristic 来实现对小米智能台灯的操作。通过添加服务,获取对应的特征值,并定义对应的回调函数来操作设备。

结语

本文介绍了 homebridge-mihome 的安装、配置和使用方法,并提供了相关示例代码,希望能对读者深入了解和使用该插件有所帮助。需要注意的是,本文仅提供基本参考,读者需要根据实际需求进行细节的设置和调整。

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

纠错
反馈