Folders and files
| Name | Name | Last commit date | ||
|---|---|---|---|---|
BeHome（原巴法云）智能家居设备的 Home Assistant 集成。
此集成通过 Home Assistant 提供基于云端的 BeHome/巴法云物联网设备控制功能。
English | 简体中文
- 多种登录方式：支持微信扫码登录、OAuth2 和手动输入用户私钥
- 多平台设备支持：控制各种设备类型，包括：
- 开关和插座
- 支持调光的灯具
- 可变速风扇
- 气候设备（空调）
- 窗帘/百叶窗
- 热水器
- 媒体播放器（电视）
- 空气净化器
- 传感器
- 设备同步模式：默认自动导入账号下所有支持的设备，也可改为手动选择同步设备
- 实时状态更新：每 5 秒轮询设备状态
- 区域集成：自动映射到 Home Assistant 区域
- 在 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 登录需要此步骤。微信扫码登录和用户私钥登录不需要配置应用程序凭据。
- 进入 设置 -> 设备与服务 -> 助手 选项卡
- 点击 "创建助手" -> "应用程序凭据"
- 填写以下信息：
- 名称：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 文件了解详情。
A: 请检查：
- BeHome 云端账户是否正常
- 设备在 BeHome 应用中是否在线
- OAuth2 凭据配置是否正确
- Home Assistant 日志中是否有错误信息
A: 集成支持所有通过 BeHome 云端 API 提供的设备类型，包括开关、灯具、风扇、空调、窗帘、热水器、电视、空气净化器和传感器等。
A: 集成每 5 秒轮询一次设备状态，确保状态信息的及时性。