02Home Connect 集成快速使用方法

admin

目前（截至 2024 年），博世/西门子（BSH 集团）的 Home Connect 设备并没有真正可用的“纯本地（Local）”接入方式。

由于厂商的安全策略，家电的本地 API 端口是被加密或关闭的。因此，哪怕你看到有些集成名字里带有 "Local" 或者你是通过 HACS 安装的，它们本质上仍然需要通过 Home Connect 的云端 API 进行通信。

你提到的更有可能是 HACS 商店中非常流行的 "Home Connect Alt" 集成（它是官方集成的增强替代版），或者你想要实现本地化但找不到方法。

鉴于 Home Connect Alt 是目前公认体验最好、功能最全的第三方集成，以下是使用该集成的详细教程。它比官方集成反应更快，传感器更多，且支持更多高级功能。

---

Home Connect Alt (HACS 版) 详细配置教程

这个教程将指导你安装 Home Connect Alt。虽然它依赖云端，但它是目前Home Assistant中体验最接近“本地”响应速度的方案。

第一步：准备工作

• 确保已安装 HACS：如果你还没有安装 HACS（Home Assistant Community Store），请先安装它。

• 拥有 Home Connect 账号：你需要有一个已经绑定了家电的普通 Home Connect App 账号（手机上能控制家电）。

• 注册开发者账号：这是最关键的一步，你需要申请 API 密钥（Client ID）。

  
  

---

第二步：申请开发者 API (关键步骤)

Home Connect 需要你创建一个“模拟应用”来获取控制权限。

• 访问 Home Connect Developer Portal。

• 点击右上角 Sign up 注册一个开发者账号（可以用与你手机 App 不同的邮箱，建议分开）。

• 登录后，点击顶部的 Applications，然后点击 Register Application。

• 填写申请表（大部分可以随便填，但以下几项必须准确）：

  
  

  • Application ID: 随便起个名字，比如 ha-integration。

  • OAuth Flow: 选择 Authorization Code Grant Flow。

  • Redirect URI (重定向地址): 这是最容易出错的地方！

    
    

    • 如果你使用 Home Assistant 的 My Home Assistant 服务（推荐），填入：
      https://my.home-assistant.io/redirect/oauth

    • 如果你不确定，或者上面那个不行，通常默认也是填这个。

      
      
    
    

• 点击 Save 保存。

• 保存后，你会看到 Client ID 和 Client Secret。复制并保存这两个字符串，稍后要用。

  
  

注意：你的开发者账号默认只能访问“模拟家电”。为了控制你家里的真实设备，你需要将你的个人 Home Connect 账号（手机App那个）添加到测试用户中，或者直接在 Home Assistant 授权时登录你的个人账号。通常开发者账号就是你的管理账号。

---

第三步：在 HACS 中安装集成

• 打开 Home Assistant，点击左侧菜单的 HACS。

• 点击 Integrations (集成)。

• 点击右下角的 Explore & Download Repositories (浏览并下载)。

• 搜索 "Home Connect Alt"。

  
  

  • 注意：不要选官方的 "Home Connect"，要选带 "Alt" 的，或者是作者为

    
    

• 点击进入，选择 Download。

• 下载完成后，重启 Home Assistant。

  
  

---

第四步：配置集成

• 重启后，进入 HA 的 配置 (Settings) -> 设备与服务 (Devices & Services)。

• 点击右下角 添加集成 (Add Integration)。

• 搜索 Home Connect Alt。

• 系统会弹窗让你输入凭据：

  
  

  • Client ID: 填入第二步获取的 ID。

  • Client Secret: 填入第二步获取的 Secret。

    
    

• 点击提交后，会跳转到 Home Connect 的网页登录页面。

• 重要：在这里登录时，使用你手机 App 上绑定的那个普通用户账号（如果你开发者账号和普通账号是同一个，就登那个）。

• 登录成功后，页面会提示授权，点击 Approve (同意)。

• 如果一切顺利，页面会提示“Link Successful”并询问是否打开 Home Assistant。

• 回到 Home Assistant，你应该能看到你的洗碗机、洗衣机、烤箱等设备出现了。

  
  

---

第五步：常见问题与使用技巧

1. 为什么显示“不可用” (Unavailable)？
Home Connect 的设备为了省电，通常在关机状态下会断开 Wi-Fi（除了部分新款洗碗机支持远程唤醒）。

• 洗衣机/烘干机：通常只有在开机且开启“远程控制”按钮后，HA 才能控制。

• 洗碗机：如果开启了“网络待机”功能，通常一直在线。

  
  

2. 这里的 "Local" 到底指什么？
如果你在某些旧教程看到 "Local"，那通常是几年前的事了。现在使用 Home Connect Alt 的好处是它使用 SSE (Server Sent Events) 技术。

• 官方集成：轮询机制，状态更新慢（比如门开了，HA 可能 1 分钟后才知道）。

• Home Connect Alt：建立长连接，家电状态变化会几乎实时推送到 HA（通常 1-3 秒延迟），体验非常接近本地控制。

  
  

3. 如何把中文实体名称弄好？
安装后，实体 ID 可能是英文的（如 switch.dishwasher_power）。你可以手动在实体设置里重命名为“洗碗机电源”。

4. api 配额限制
开发者账号每天有 API 调用次数限制（通常是 1000 次）。Home Connect Alt 优化了调用逻辑，一般正常家用不会超限。如果你发现设备突然没反应，可能是当天的配额用完了，第二天会自动恢复。

总结

虽然名字里可能没有 "Local"，但 Home Connect Alt (HACS) 是目前解决博世/西门子家电接入 Home Assistant 的最佳方案。

核心流程：
注册开发者账号 -> 获取 ID/Secret -> HACS 安装 Alt 集成 -> 填入 ID/Secret -> 网页授权 -> 完成。