如何将涂鸦旧版本 Home Assistant 插件迁移至 Tuya v2

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

开发者可以选择删除涂鸦旧版本 Home Assistant 插件并迁移至 Tuya v2,也可以选择保留旧版本的同时直接安装新版本。本文介绍了如何从涂鸦旧版本 Home Assistant 插件迁移到 Tuya v2 的操作。

背景信息

我们致力于为开发者提供最佳的开发体验,并保持涂鸦 Home Assistant 插件的更新。涂鸦旧版 Home Assistant 插件支持的品类和控制指令存在一定的局限,因此,我们期望可以帮助开发者拥有更丰富的涂鸦设备品类接入能力以及更多的设备控制能力。

本次推出的新版插件使用涂鸦标准的 API 开发,突破了原先的品类和指令限制,提供了虚拟设备可供调试、官方授权验证方式以及技术支持,帮助开发者更高效、更全面、更有深度地融入涂鸦生态。
新插件带来的优化提升以及其他新旧版本的差异,请参考以下表格:

差异项 旧版插件 Tuya v2
支持品类 使用的旧接口仅针对语音业务场景,只支持6种类型的涂鸦设备,控制指令有限。 使用涂鸦标准 OpenAPI 开发,支持所有类型的设备和绝大多数的控制指令。
说明:只要能通过云云对接控制的设备,新插件都可以支持。详情请参考 标准指令集
驱动开发 只能使用真实设备。 可以使用涂鸦虚拟设备进行调试,帮助开发者更高效地调试不同涂鸦硬件品类的驱动,提高了开发效率。
验证方式 无官方授权验证方式。 使用了更为安全的涂鸦官方授权验证方式,规避了账号密码被爆破泄露的风险。
技术支持 无官方技术支持。 由涂鸦官方提供技术支持,以及迭代维护插件功能。如果遇到问题,开发者可以 提交工单
开发者平台操作 不需要。 需要去开发者平台注册“全屋智能”云开发项目。
安装 Home Assistant 官方方式安装。 拷贝文件至本地安装或通过 HACS 方式安装。
插件初始化 需要 4 个注册信息:涂鸦开发者平台账号、密码、国家码和移动应用。 需要 6 个注册信息:地区、Access ID、Access Secret、移动应用、国家码,App 账户、App 密码。
注意: 移动应用必须选择在涂鸦开发者平台上接入设备时所用的 App。
App 支持涂鸦智能、智能生活、Jinvoo Smart。 当前支持涂鸦智能和智能生活 App。如果需要支持其他 OEM App,请 提交工单
响应速度 秒级。 毫秒级。

注意事项

  • 对于没有在涂鸦开发者平台上创建过全屋智能云开发项目的开发者来说,直接新建云开发项目即可,详细操作请参考下文中 涂鸦开发者平台操作 - 新建云开发项目
  • 对于在 2021 年 5 月 25 日之前创建过全屋智能云开发项目的开发者来说,需要先在旧项目中解绑关联 App 账号下的设备,并重新绑定到新的云开发项目中,然后再去新插件中进行配置。详细操作请参考下文 涂鸦开发者平台操作 - 从旧项目迁移

操作过程

注意: 在迁移过程中,旧版本插件的自动化配置会在新版本中失效,需要您重新进行配置。

涂鸦开发者平台操作

新建云开发项目(适用全新云开发项目)
安装新版插件之前,需要在 Tuya开发者平台 上创建一个全屋智能云开发项目。如何创建云开发项目,请参考 涂鸦开发者平台配置指南(全屋智能 PaaS 开发方式)


从旧项目迁移(适用于 2021 年 5 月 25 日之前创建过全屋智能项目)

  1. 登录 涂鸦开发者平台

  2. 在左侧导航栏中选择 云开发 > 云开发,选中全屋智能旧项目。
    如何将涂鸦旧版本 Home Assistant 插件迁移至 Tuya v2

  3. 项目管理 页面中选择 关联设备 > 关联 App 账号下的设备,解除关联。
    如何将涂鸦旧版本 Home Assistant 插件迁移至 Tuya v2

  4. 新建全屋智能云开项目,操作过程请参考 涂鸦开发者平台配置指南(全屋智能 PaaS 开发方式)

  5. 项目管理 页面中选择 关联设备 > 关联 App 账号下的设备 后,单击 添加 App 账号,并使用涂鸦智能或智能生活 App 扫码授权。
    如何将涂鸦旧版本 Home Assistant 插件迁移至 Tuya v2
    如何将涂鸦旧版本 Home Assistant 插件迁移至 Tuya v2

删除旧版本(可选)

  1. 登录 Home Assistant。
  2. 选择 配置 > 集成
  3. 集成 页签中,选择 > 删除
    如何将涂鸦旧版本 Home Assistant 插件迁移至 Tuya v2

安装 Tuya v2

如何安装新版本拆件,请参考 如何使用新版涂鸦 Home Assistant 插件