ha-wyzeapi：实践指南

实际评估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 存储库中提出问题（确保填写每个提供的字段）