如何安装 Tuya v2 插件（适用于 Beta 测试）

更新时间：2024-06-20 06:55:02下载pdf

本文介绍如何安装和使用 Tuya v2 插件。

前提条件

已在涂鸦开发者平台创建全屋智能云开发项目，至少已添加 1 台设备或 1 台虚拟设备，并且已经为项目订阅相关智能家庭授权 API。关于如何创建云开发项目，请参考涂鸦开发者平台配置指南（全屋智能 PaaS 开发方式）。

注意：如果创建的云开发项目日期早于 2021 年 5 月 25 日，则需要进行旧项目的迁移，详细操作请参考涂鸦开发者平台操作 - 从旧项目迁移。
已安装 Python 3.8（包含 python3-dev）或更高版本。

安装 Home Assistant Core 后，再把涂鸦 Home Assistant 插件拷贝至其配置目录。

参考 Home Assistant 官方安装文档安装 Home Assistant Core。

Tuya v2 插件可以和旧版本兼容，两个版本可以同时安装，您无需先卸载旧版本后再安装新版本。

下载 tuya-home-assistant 仓库。
解压仓库，并将 custom_components/tuya/ 文件夹拷贝至 Home Assistant 配置目录：比如 ~/.homeassistant。

参考 HACS 官方安装文档安装 HACS。
参考初始化配置文档完成初始化配置。
启动 HACS 后，在主窗口中选择 HACS > Integrations > ⋮ > Custom repositories。
在窗口左下角的地址栏中，输入 https://github.com/tuya/tuya-home-assistant。在 Category 下拉框中选择 Integration，并单击 ADD。
在弹出的对话框中，单击 INSTALL。

在弹出的窗口中填写参数，参数填写可参考下表。
如何安装 Tuya v2 插件（适用于 Beta 测试）

参数项	描述
Access ID 和 Access Secret	访问 Tuya开发者平台云开发项目，在对应项目的授权密钥区域中找到 Access ID 和 Access Secret.
移动应用	必须为在涂鸦开发者平台上用来接入设备的 App。
国家码	登录涂鸦智能或智能生活 App 时选择的国家对应的国家码。
账号	涂鸦智能或智能生活 App 账户。
密码	涂鸦智能或智能生活 App 密码。

注意: 表格中提到的 App 必须为在涂鸦开发者平台上用来接入设备的 App。

问题一：旧插件中使用涂鸦智能/智能生活 App 配网的设备，能否无缝接入新插件？

可以。配网的设备信息都存储在涂鸦云，使用旧插件配网接入的设备无需重新进行配网操作，但是 Home Assistant 涂鸦插件的自动化配置需要进行重新设置。

问题二：涂鸦 Home Assistant 插件提示 “身份认证无效”，要如何解决？

如何安装 Tuya v2 插件（适用于 Beta 测试）
需要排查以下几点：

确认涂鸦开发者平台上的云项目是否创建于今年 5 月 25 号以后。若创建时间早于该日期，请参考开发者平台操作新建一个云开发项目，或者从旧项目迁移数据至新项目。
确认是否已经授权关联涂鸦智能/智能生活 App 账号到云开发项目中。
确认 Home Assistant 插件登录时输入的涂鸦智能/智能生活 App 用户账号和密码是否正确。App 账户取决于您在涂鸦开发者平台上接入设备时用了哪个 App（涂鸦智能或智能生活）。

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

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

问题四：出现以下报错，该如何解决?

报错信息示例：

[tuya-openapi] Response: {
  "code": 2406,
  "msg": "skill id invalid",
  "success": false,
  "t": 1624477851701
}

错误码	错误信息	解决办法
1004	sign invalid	未正确填写 Access ID 和 Access Secret。填写方法参见配置参数。
1106	permission deny	App 账号和云开发项目未关联：确保涂鸦智能或智能生活 App 和云开发项目关联，关联方法参见通过 App 账号添加设备。用户名或密码错误: 使用您关联云开发项目对应涂鸦智能或智能生活 App 的用户名和密码. 国家码错误: 填写您在登录涂鸦智能或智能生活 App 时所选的国家或地区的国家码。
1100	param is empty	用户名或者 App 参数为空，请填写用户名或选择一个 App。
2017	schema does not exist	App 选择错误，请选择在涂鸦开发者平台上用来接入设备的 App（涂鸦智能或智能生活）。
2406	skill id invalid	确认涂鸦开发者平台上的云项目是否创建于今年 5 月 25 号以后。若创建时间早于该日期，请参考开发者平台操作新建一个云开发项目。
28841105	No permissions. This project is not authorized to call this API	API 授权不完整，请开通云产品并为项目授权。本教程需要开通以下 API：授权管理设备连接服务全屋智能场景联动 IoT 数据分析设备状态通知

问题五：在通过 App 扫描二维码将设备关联到云开发项目时出现以下报错，该如何解决？ 如何安装 Tuya v2 插件（适用于 Beta 测试）

出现改报错的原因为 App 账号所在区域和云开发项目数据中心不一致。需要您切换至正确的数据中心之后再重新扫码。