BeHome Home Assistant 集成
BeHome（原巴法云）智能家居设备的 Home Assistant 集成。
此集成通过 Home Assistant 提供基于云端的 BeHome/巴法云物联网设备控制功能。
English | 简体中文
功能特性
- 多种登录方式：支持微信扫码登录、OAuth2 和手动输入用户私钥
- 多平台设备支持：控制各种设备类型，包括：
- 开关和插座
- 支持调光的灯具
- 可变速风扇
- 气候设备（空调）
- 窗帘/百叶窗
- 热水器
- 媒体播放器（电视）
- 空气净化器
- 传感器
- 设备同步模式：默认自动导入账号下所有支持的设备，也可改为手动选择同步设备
- 实时状态更新：每 5 秒轮询设备状态
- 区域集成：自动映射到 Home Assistant 区域
安装方法
HACS 安装（推荐）
- 在 Home Assistant 中打开 HACS
- 进入"集成"页面
- 点击"浏览和下载存储库"
- 搜索 “BeHome”
- 下载并重启 Home Assistant
手动安装
- 使用您选择的工具打开 Home Assistant 配置目录（包含
configuration.yaml 的目录）
- 如果没有
custom_components 目录，请创建一个
- 在
custom_components 目录中创建名为 behome 的新文件夹
- 从此存储库的
custom_components/behome/ 目录中下载所有文件
- 将下载的文件放置在您创建的新目录中
- 重启 Home Assistant
配置说明
BeHome 支持三种登录方式：
- 微信扫码登录：推荐大多数用户使用，无需配置应用程序凭据。
- OAuth2 登录：需要在 Home Assistant 中配置应用程序凭据。
- 手动输入用户私钥：适合已经知道 BeHome 用户私钥的用户。
可选：设置 OAuth2 应用程序凭据
只有 OAuth2 登录需要此步骤。微信扫码登录和用户私钥登录不需要配置应用程序凭据。
- 进入 设置 -> 设备与服务 -> 助手 选项卡
- 点击 “创建助手” -> “应用程序凭据”
- 填写以下信息：
- 名称：
BeHome（或您自定义的名称）
- 域：
behome
- 客户端 ID：
88ac425b4558463aa813aed1690db730
- 客户端密钥：输入您的自定义密钥（可以使用任何安全字符串）
- 点击 “创建”
添加集成
- 进入 设置 -> 设备与服务 -> 集成
- 点击 “+ 添加集成” 并搜索 “BeHome”
- 选择 BeHome 集成
- 选择 微信扫码登录、OAuth2 或 手动输入用户私钥
- 按照所选登录方式完成授权
- 您的 BeHome 设备将按同步设置被发现并添加
设备同步
身份验证完成后，集成默认会自动导入账号下所有支持的 BeHome 设备。
如需阻止未选择的设备同步到 Home Assistant，可进入 设置 -> 设备与服务 -> BeHome -> 配置，将同步模式改为 手动选择同步设备，然后只勾选需要同步的设备。手动模式下，未勾选且此前由本集成创建的设备和实体会从 Home Assistant 注册表删除；不勾选任何设备时，会删除本集成创建的所有设备和实体。此清理只匹配当前 BeHome 配置项创建的设备，不会删除用户原有的 Home Assistant 设备。
自动模式下，后续如果用户在 BeHome 账号中新增了支持的设备，集成会在轮询时自动发现并创建对应实体。手动模式下，新设备只有被勾选后才会同步。
集成将：
- 根据设备类型为每个设备创建实体
- 将设备映射到相应的 Home Assistant 区域（如果区域名称匹配）
- 设置每 5 秒自动状态轮询
设备类型
集成会自动将 BeHome 设备类型映射到相应的 Home Assistant 平台：
| BeHome 类型 |
Home Assistant 平台 |
描述 |
| outlet |
switch |
智能插座和开关 |
| light |
light |
支持调光的智能灯具 |
| fan |
fan |
可变速风扇 |
| aircondition |
climate |
空调设备 |
| curtain |
cover |
窗帘和百叶窗 |
| waterheater |
water_heater |
热水器 |
| television |
media_player |
电视和媒体设备 |
| airpurifier |
air_purifier |
空气净化器 |
| sensor |
sensor |
各种传感器 |
支持与反馈
贡献
欢迎贡献！请阅读我们的贡献指南并提交拉取请求以帮助改进此集成。
许可证
本项目使用 MIT 许可证 - 查看 LICENSE 文件了解详情。
常见问题
Q: 设备不显示或无法控制怎么办？
A: 请检查：
- BeHome 云端账户是否正常
- 设备在 BeHome 应用中是否在线
- OAuth2 凭据配置是否正确
- Home Assistant 日志中是否有错误信息
Q: 支持哪些 BeHome 设备？
A: 集成支持所有通过 BeHome 云端 API 提供的设备类型，包括开关、灯具、风扇、空调、窗帘、热水器、电视、空气净化器和传感器等。
Q: 设备状态更新频率是多少？
A: 集成每 5 秒轮询一次设备状态，确保状态信息的及时性。
评论