|
HomeAssistant 添加涂鸦(Tuya)设备主要有两种方式:官方 Tuya 集成(云端,最简单)和 Tuya Local(本地化,响应快但配置稍繁琐)。 对于“小白”用户,强烈推荐使用官方 Tuya 集成。现在的版本(2025.12.x)已经极极大简化了步骤,不再需要像以前那样去注册开发者账号、申请 Access ID、担心开发者试用期过期了。现在只需要一个“用户代码”和手机 App 扫码即可。 以下是基于 HomeAssistant 2025.12.2 版本的详细小白教程。 🟢 方式一:官方 Tuya 集成(推荐新手)这种方式最简单,配置好后,你在手机“涂鸦智能”或“智能生活”App 里能看到的设备,都会自动同步到 HomeAssistant。 1. 准备工作手机 App:确保你手机上安装了 “涂鸦智能” (Tuya Smart) 或 “智能生活” (Smart Life) App。 账号:已注册登录,并且 App 里已经添加了你的智能设备(如插座、灯泡等)。 网络:手机和 HomeAssistant 最好在同一个局域网,但这对于云端集成不是强制的。
2. 获取“用户代码” (User Code)这是新版集成最关键的一步,替代了以前复杂的开发者账号。 打开手机上的 涂鸦智能 或 智能生活 App。 点击右下角的 “我” (Me)。 点击右上角的 六边形设置图标 (⚙️)。 点击第一项 “账号与安全” (Account and Security)。 在页面中间,你会看到 “用户代码” (User Code)。 点击在这个代码旁边的“复制”按钮(或手动记下来)。
注意:如果找不到“用户代码”,请确保你的 App 已经更新到最新版本。 3. 在 HomeAssistant 中添加集成电脑浏览器打开 HomeAssistant 后台(通常是 http://homeassistant.local:8123)。 点击左侧侧边栏的 “设置” (Settings)。 选择 “设备与服务” (Devices & Services)。 点击右下角的蓝色按钮 “+ 添加集成” (+ ADD INTEGRATION)。 在搜索框输入 Tuya,点击出现的 Tuya 图标。
4. 进行配对5. 完成HomeAssistant 页面会自动刷新,提示“成功!”。 你可以将设备分配到具体的房间(建议选好区域,方便管理),然后点击“完成”。 现在去 “概览” (Overview) 面板,你应该能看到你的涂鸦设备已经出现了,并且可以控制开关!
🔵 方式二:Tuya Local(进阶,本地控制)如果你发现官方集成响应慢,或者断网就不能用了,可以尝试这个方案。它通过 HACS 安装,能实现 简述流程(供参考): 需要先安装 HACS(Home Assistant Community Store)。 在 HACS 中搜索并下载 Tuya Local(注意不是 LocalTuya,Tuya Local 配置更友好)。 重启 HomeAssistant。 在“设备与服务”里添加集成,搜索 Tuya Local。 新版优势:现在的 Tuya Local 也支持上述的“扫码”模式来自动获取 Key,不再需要去开发者平台抓包了,非常方便。
常见问题 (Q&A)Q: 以前教程说要注册 iot.tuya.com 开发者账号,还需要 Access ID 和 Secret,还要每6个月延期一次,现在不用了吗?
A: 不用了! 那是旧版(2024年初之前)的流程。现在的官方集成使用的是“智能家庭 PaaS”模式,普通用户只需要 App 扫码即可,完全避开了繁琐的开发者试用期问题。 Q: 设备在 HomeAssistant 里显示“不可用”怎么办?
A: Q: 我在 App 里改了设备名字,HA 会同步吗?
A: 不会实时同步。你需要去 HA 的 Tuya 集成页面点击“重新加载”,它才会更新最新的设备名称。
|