如何安装涂鸦 Homebridge 插件

通过涂鸦 Homebridge 插件，您可以使用 HomeKit 轻松控制连接到涂鸦涂鸦 IoT 平台的智能设备。本教程中，涂鸦将向您展示如何使用 HomeKit 安装涂鸦官方 Homebridge 插件和控制智能设备。

前提条件

• 安装 Homebridge。
  查看 Official Homebridge docs 并在您的系统上安装 Homebridge。本示例基于 macOS。其他平台安装 Homebridge 的教程如下：

  • 官方 Homebridge 树莓派镜像
  • 在 Raspbian 上安装 Homebridge
  • 在 Debian 或 Ubuntu Linux 上安装 Homebridge
  • 在 Red Hat、CentOS 或 Fedora Linux 上安装 Homebridge
  • 在 macOS 上安装 Homebridge
  • 在 Windows 10 上安装 Homebridge
  • 在 Docker (Linux) 上安装 Homebridge
  • 其他平台

• 已在 涂鸦 IoT 平台 创建全屋智能云开发项目，至少已添加 1 台设备或 1 台虚拟设备，并且已经为项目订阅相关智能家庭授权 API。关于如何创建云开发项目，请参考 涂鸦 IoT 平台配置指南（全屋智能 PaaS 开发方式）。
  请使用 2021 年 5 月 25 日及以后创建的云开发项目进行操作。如果创建的云开发项目日期早于 2021 年 5 月 25 日，请重新创建一个项目。

安装插件

1. 在 Mac 上打开 Terminal。

   

2. 安装涂鸦 Homebridge 插件。

   如果您在安装过程中遇到任何问题，您可能需要在此命令前加上 sudo 以管理员身份运行。

   1. 安装插件。

      npm install homebridge-tuya-platform

   2. 等待插件安装，检查是否安装成功。有关更多信息，请参阅下面的视频。

      

编辑配置文件

使用前需要编辑 Homebridge 插件的config.json文件。

1. 登录 homebridge-tuya-platform/config。
   cd ./node_modules/homebridge-tuya-platform/config

2. 编辑config.json 文件。
   vim config.json

3. 配置options 参数值。

   

   • username 和 password：您在 涂鸦 IoT 平台 上用于链接设备的 智能生活 账号的用户名和密码。

   • accessId 和 accessKey：分别是您的项目的 Access ID 和 Access Secret。进入 涂鸦 IoT 平台，在目标项目的 概况 > 云应用授权密钥 查看 Access ID 和 Access Secret。
     

   • lang：保留默认值 en。

   • endPoint：您的智能生活 App 账号所在地对应云开发项目可用区域的云服务器地址。账号所在地和可用区域对应关系参见 账号所在地和可用区域对应关系。

     地区	Endpoint
     美国	https://openapi.tuyaus.com
     中国	https://openapi.tuyacn.com
     欧洲	https://openapi.tuyaeu.com
     印度	https://openapi.tuyain.com
     美洲东部	https://openapi-ueaz.tuyaus.com
     西欧	https://openapi-weaz.tuyaeu.com

   • projectType：您在创建项目时选择的开发方式。开发方式详见 开发方式。

     • 1：自定义开发
     • 2：全屋智能 PaaS

   • appSchema：您在涂鸦 IoT 平台上用于连接设备的 App。

     • tuyaSmart：涂鸦智能 App
     • smartLife：智能生活 App

   • countryCode：您在登录智能生活 App 时所选的国家或地区的 国家代码。

4.保存并退出。

运行插件

1. 回到 homebridge-tuya-platform 目录。

   cd ..

2. 运行插件。

   homebridge -D -U ./config/ -P ./

   

连接 HomeKit

1. 在您的 Apple 设备上打开 家庭。

2. 通过扫描运行插件步骤中打印的二维码或输入 8 位 PIN 码与 Homebridge 配对。您还可以在 config.json 文件中找到 PIN 码。

   

在 HomeKit 上控制设备

现在，您可以在 HomeKit 仪表板上查看和控制连接到智能生活 App 的所有智能设备。

常见错误码和解决方法

常见问题

Q：涂鸦云开发项目的 API 产品有免费 1 年试用期，到期后是否要收费呢？

A：1 年到期后可以更新免费订阅功能，继续使用免费 API 产品。开发者在开通云开发体验版账号后可以试用所有免费 API 产品，但会有用量限制，详细用量限制请参考 产品定价。