Appearance
BeHome Home Assistant 集成
BeHome(巴法云)智能家居设备的 Home Assistant 集成。
此集成通过 Home Assistant 提供基于云端的 BeHome/巴法云物联网设备控制功能。
功能特性
- OAuth2 身份验证:与 BeHome 云端的安全身份验证
- 多平台设备支持:自动同步巴法云设备到Home Assistant,支持控制各种设备类型,包括:
- 开关和插座
- 支持调光的灯具
- 可变速风扇
- 气候设备(空调)
- 窗帘/百叶窗
- 热水器
- 媒体播放器(电视)
- 空气净化器
- 传感器
- 实时状态更新:每分钟轮询设备状态
- 区域集成:自动映射到 Home Assistant 区域
安装方法
HACS 安装(推荐)
- 在 Home Assistant 中打开 HACS
- 进入"集成"页面
- 点击"浏览和下载存储库"
- 搜索 "BeHome"
- 下载并重启 Home Assistant
手动安装
- 使用您选择的工具打开 Home Assistant 配置目录(包含
configuration.yaml
的目录) - 如果没有
custom_components
目录,请创建一个 - 在
custom_components
目录中创建名为behome
的新文件夹 - 从此存储库的
custom_components/behome/
目录中下载所有文件 - 将下载的文件放置在您创建的新目录中
- 重启 Home Assistant
配置说明
仅采用OAuth2登录方式的用户需要配置,使用用户私钥登录的用户无需配置。
步骤 1:设置 OAuth2 应用程序凭据
在添加集成之前,您需要在 Home Assistant 中配置 OAuth2 凭据:
- 进入 设置 → 设备与服务 → 助手 选项卡
- 点击 "创建助手" → "应用程序凭据"
- 填写以下信息:
- 名称:
BeHome
(或您自定义的名称) - 域:
behome
- 客户端 ID:
88ac425b4558463aa813aed1690db730
- 客户端密钥:输入您的自定义密钥(可以使用任何安全字符串)
- 名称:
- 点击 "创建"
步骤 2:添加集成
- 进入 设置 → 设备与服务 → 集成
- 点击 "+ 添加集成" 并搜索 "BeHome"
- 选择 BeHome 集成
- 选择您在步骤 1 中创建的应用程序凭据
- 按照 OAuth2 身份验证流程授权 Home Assistant
- 您的 BeHome 设备将被自动发现并添加
步骤 3:设备配置
身份验证完成后,您的所有 BeHome 设备将自动导入并配置。集成将:
- 根据设备类型为每个设备创建实体
- 将设备映射到相应的 Home Assistant 区域(如果区域名称匹配)
- 设置每分钟自动状态轮询
设备类型
集成会自动将 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 | 各种传感器 |
支持与反馈
贡献
欢迎贡献!请阅读我们的贡献指南并提交拉取请求以帮助改进此集成。
常见问题
Q: 设备不显示或无法控制怎么办?
A: 请检查:
- 巴法云 云端账户是否正常
- 设备在 巴法云 应用中是否在线
- OAuth2 凭据配置是否正确
- Home Assistant 日志中是否有错误信息
Q: 支持哪些 巴法云 设备?
A: 集成支持所有通过 巴法云 云端 API 提供的设备类型,包括开关、灯具、风扇、空调、窗帘、热水器、电视、空气净化器和传感器等。
Q: 设备状态更新频率是多少?
A: 集成每分钟轮询一次设备状态,确保状态信息的及时性。