本帖最后由 zlinoliver 于 2021-6-20 16:20 编辑
我们致力于为开发者提供最佳的开发体验，并保持涂鸦 Home Assistant 插件的更新。涂鸦旧版 Home Assistant 插件支持的品类和控制指令存在一定的局限，因此，我们期望可以帮助开发者拥有更丰富的涂鸦设备品类接入能力以及更多的设备控制能力。
本次推出的新版v2 插件使用涂鸦标准的 API 开发，突破了原先的品类和指令限制，提供了虚拟设备可供调试、官方授权验证方式以及技术支持，帮助开发者更高效、更全面、更有深度地融入涂鸦生态。
重要通知：涂鸦旧版 Home Assistant 插件 将于2021年12月31日下线，我们预留了6个月时间，帮助开发者迁移到新的涂鸦HASS插件方案。
涂鸦智能官方HASS V2 插件 Github地址: https://github.com/tuya/tuya-home-assistant
新版涂鸦v2插件支持的PBT 涂鸦硬件单品： 灯具，灯带，开关，插座，排插，窗帘，风扇，香薰机，门磁传感器，燃气传感器，烟雾传感器，水浸传感器，SOS传感器，人体存在传感器，室内空气监测仪等。更多硬件品类支持将会陆续推出，也欢迎开发者参与一起共建开发单品硬件驱动！
涂鸦v2插件 单品硬件驱动开发教程：https://developer.tuya.com/cn/demo/devhomeassistantplugin
新插件带来的优化提升以及其他新旧版本的差异，请参考以下表格：
| 差异项 | 旧版插件 | 新版插件 | | 支持品类 | 使用的旧接口仅针对语音业务场景，只支持6种类型的涂鸦设备，控制指令有限。 | 使用涂鸦标准 OpenAPI 开发，支持所有类型的设备和绝大多数的控制指令。
只要能通过云云对接控制的设备，新插件都可以支持。详情请参考 标准指令集。 | | 驱动开发 | 只能使用真实设备。 | 可以使用涂鸦虚拟设备进行调试，帮助开发者更高效地调试不同涂鸦硬件品类的驱动，提高了开发效率。 | | 验证方式 | 无官方授权验证方式。 | 使用了更为安全的涂鸦官方授权验证方式，规避了账号密码被爆破泄露的风险。 | | 技术支持 | 无官方技术支持。 | 由涂鸦官方提供技术支持，以及迭代维护插件功能。如果遇到问题，开发者可以 提交工单。 | | IoT平台操作 | 不需要。 | 需要去 IoT 平台注册“全屋智能”云开发项目。 | | 安装 | Home Assistant 官方方式安装。 | 拷贝文件至本地安装或通过 HACS 方式安装。 | | 插件初始化 | 需要 4 个注册信息：涂鸦 IoT 平台账号、密码、国家码和移动应用。 | 需要 6 个注册信息：地区、Access ID、Access Secret、移动应用、国家码，App 账户、App 密码。
注意: 移动应用必须选择在涂鸦 IoT 平台上接入设备时所用的 App。 | | App | 支持涂鸦智能、智能生活、Jinvoo Smart。 | 当前支持涂鸦智能和智能生活 App。如果需要支持其他 OEM App，请 提交工单。 | 响应速度
| 秒级。 | 毫秒级。 |
旧插件迁移新插件相关教程：
如何将涂鸦旧版本 Home Assistant 插件迁移至新版本
新插件使用方法：
前提条件：
注意：如果创建的云开发项目日期早于 2021 年 5 月 25 日，则需要进行旧项目的迁移，详细操作请参考涂鸦 IoT 平台操作 - 从旧项目迁移。
- 已安装 Python 3.8（包含 python3-dev）或更高版本。
操作过程：
1. 请先参考涂鸦IoT平台配置指南（全屋智能PaaS开发方式）完成项目创建，授权密钥获取，以及关联涂鸦智能App账号下的设备。
2. 安装Home Assistant Core：
参考 Home Assistant 官方安装文档 安装Home Assistant Core.
安装 Home Assistant Core 后，再把涂鸦 Home Assistant 插件拷贝至其配置目录。
3. 安装Tuya Home Assistant v2 插件：
说明：涂鸦新版本 Home Assistant 插件可以和旧版本兼容，两个版本可以同时安装，您无需先卸载旧版本后再安装新版本。
方法 1：拷贝方式安装
1. 下载 tuya-home-assistant Github仓库。
2. 解压仓库，并将 custom_components/tuya/ 文件夹拷贝至Home Assistant 配置目录：比如 ~/.homeassistant .
方法2：HACS 方式安装
1. 参考 HACS官方安装文档 安装 HACS.
2. 参考 初始化配置文档 完成初始化配置。
3. 启动 HACS 后，在主窗口中选择 HACS > Integrations > ⋮ > Custom repositories。
4. 在窗口左下角的地址栏中，输入 https://github.com/tuya/tuya-home-assistant。在 Category 下拉框中选择 Integration，并单击 ADD。
5. 在弹出的对话框中，单击 INSTALL。
4. 配置Home Assistant
1. 在浏览器中输入 localhost:8123 ，并按回车键。
2. 创建账号并登录。
3. 选择 配置 > 集成。
4. 在 集成 页签中，单击 添加集成。
5. 搜索并安装 Tuya v2.
6. 在 Tuya插件 窗口中，选择 Smart Home PaaS 并单击 提交。
7. 在弹出的窗口中填写参数，参数填写可参考下表。
| 参数项 | 描述 | | 地区 | 打开涂鸦智能或智能生活 App，查看 我的 > 设置 > 账号与安全 > 账号所在地，填入其中显示的地区即可。 | | Access ID 和 Access Secret | 访问 Tuya IoT 平台云开发项目，在对应项目的 授权密钥 区域中找到 Access ID 和 Access Secret. | | 移动应用 | 必须为在涂鸦 IoT 平台上用来接入设备的 App。 | | 国家码 | 登录涂鸦智能或智能生活 App 时选择的国家对应的国家码。 | | 账号 | 涂鸦智能或智能生活 App 账户。 | | 密码 | 涂鸦智能或智能生活 App 密码。 |
注意：表格中提到的 App 必须为在涂鸦 IoT 平台上用来接入设备的 App。
8. 点击提交。
在 概览 页面中，您可以找到并控制在 涂鸦 IoT 平台 上创建的云开发项目中的设备。
常见问题解答
问题一：旧插件中使用涂鸦智能/智能生活 App 配网的设备，能否无缝接入新插件？
可以。配网的设备信息都存储在涂鸦云，使用旧插件配网接入的设备无需重新进行配网操作，但是home assistant 涂鸦插件的自动化配置需要进行重新设置。
问题二：涂鸦 Home Assistant 插件提示 “身份认证无效”，要如何解决？
需要排查以下几点：
- 确认 涂鸦 IoT 平台 上的云项目是否创建于今年 5 月 25 号以后。
- 确认是否已经授权关联涂鸦智能/智能生活 App 账号到云项目中。
- 确认 Home Assistant 插件登录时输入的涂鸦智能/智能生活 App 用户账号和密码是否正确。App 账户取决于您在涂鸦 IoT 平台 上接入设备时用了哪个 App（涂鸦智能或智能生活）。
问题三：涂鸦云开发项目的API产品有免费1年试用期，到期后是否要收费呢？
1 年到期后可以更新免费订阅功能，继续使用免费 API 产品。开发者在开通云开发体验版账号后可以试用所有免费 API 产品，但会有用量限制，详细用量限制请参考 产品定价。
| 
[复制链接]
发表于 2021-6-19 21:07:24
楼主
