详情

首页手游攻略 ha-wyzeapi:实践指南

ha-wyzeapi:实践指南

佚名 2026-09-16 08:40:01

实际评估ha-wyzeapi时,我先确认它解决的具体问题:Wyze 设备的家庭助理集成。团队若要把它用于日常自动化,应先处理输入边界、依赖和失败处理如果不清楚就很难稳定复用,否则试用结果很容易失真。落地前可以用一项范围明确的真实任务完成最小试跑,用配置时间、输出质量、异常信息和维护痕迹判断它是否真的省事。它对愿意先做小范围验证并复查原始文档的团队更有价值,但正式采用前仍要复查许可证、近期提交和问题区回应。

家庭助理 - Wyze 集成

这是一个自定义组件,允许使用非官方的 API 控制 Home Assistant 中的各种 Wyze 设备。请 请注意,这模仿了 Wyze 应用程序,因此访问可能随时被切断。

WyzeApi 的功能亮点

  • 通过HA控制Wyze灯泡作为灯光
  • 通过 HA 控制 Wyze 插头作为开关
  • 使用 Wyze 相机作为运动传感器 NOTE: 在 Wyze 发生 API 使用事件后禁用
  • 打开和关闭 Wyze 相机
  • Wyze Lock 的锁定、解锁以及查看锁和门的状态

潜在的缺点

  • 这是 API 的非官方实现,因此可能随时被 WyzeLabs 禁用或破坏
  • ~~它需要在您的帐户上禁用两因素身份验证~~
  • 自版本 2021.9.2 起支持双因素身份验证

资金

如果您喜欢我在这里所做的事情并且想要提供帮助,我建议您首先考虑支持主页 助理。您可以通过从他们的 商店 购买一些赃物来做到这一点 或支付 Nabu Casa 订阅费用。没有他们,这一切都不会发生。

安装 (HACS) - 强烈推荐

  1. 安装了HACS,这将允许您轻松更新
  2. 添加 https://github.com/SecKatie/ha-wyzeapi 为自定义 存储库类型:集成
  3. 单击集成选项卡中“Wyze Bulb and Switch Api Integration”下的安装
  4. 重启 HA
  5. 导航至配置界面中的_Integrations_。
  6. 点击_添加INTEGRATION_
  7. 搜索 Wyze 家庭助理集成 NOTE: 如果没有出现_Wyze Home Assistant Integration_,请硬刷新浏览器(ctrl+F5)并重新搜索
  8. 出现提示时输入您的电子邮件、密码、密钥 ID 和 apikey。 NOTE: 如果您不知道如何生成 keyid 和 apikey,请参阅以下 Wyze 官方文档:创建 API 密钥
  9. 点击_提交_并获利!

用途

  • 实体将显示为 light.<friendly name>switch.<friendly name>binary_sensor.<friendly name>lock.<friendly name> 例如 (light.livingroom_lamp)。
  • 与灯光交互的说明可以在这里找到:https://www.home-assistant.io/integrations/light/
    • 开关:https://www.home-assistant.io/integrations/switch/
    • 相机运动传感器:https://www.home-assistant.io/integrations/binary_sensor/

报告问题

  1. 将记录器添加到 configuration.yaml 中,设置记录器打印该组件的调试消息:
    logger:
     default: warning
     logs:
       custom_components.wyzeapi: debug
       wyzeapy: debug
    
  2. 重启 HA
  3. 确认您仍然遇到问题
  4. 在此 Github 存储库中提出问题(确保填写每个提供的字段)
点击查看更多
推荐专题
热门阅读