EZVIZ
ezviz 传感器平台使用 ezvizlife.com API 与设备进行交互。
它还通过使用本地摄像头 IP 来暴露 RTSP 流（因此托管 Home Assistant 的设备必须能够访问摄像头的本地 IP）。
由于没有官方文档可供参考，该集成从 EZVIZ 手机应用程序中使用的 API 检索数据，可以在这里找到
每个摄像头的密码通常写在二维码附近。可能在设备底部或用户手册中找到。它通常被称为摄像头的“验证代码”。
您的摄像头需要启用本地 RTSP 服务器。步骤如下：
- 打开 EZVIZ 手机应用。
- 选择个人资料图标。
- 导航到 设置 > 局域网实时视图 > 开始扫描。
- 选择您的摄像头。
- 选择右上角的齿轮图标 > 本地服务器设置 > 启用 RTSP。
配置
要将 EZVIZ integration 添加到您的 Home Assistant 实例中，请使用此 My 按钮：
如果上述 My 按钮不起作用，您也可以手动执行以下步骤：
-
浏览到您的 Home Assistant 实例。
-
转到
设置 > 设备与服务。 -
在右下角，选择
Add Integration 按钮。 -
从列表中选择 EZVIZ。
-
按照屏幕上的说明完成设置。
您的摄像头现在将在集成选项下显示为“发现的设备”。请为每个摄像头完成设置，以便在 Home Assistant 中查看视频流。
如果您需要访问高分辨率或低分辨率的流，也可以更改摄像头选项。一般来说，它会在没有任何选项修改的情况下正常工作。
集成实体选项
请求超时（秒）：
-
此选项确定 Home Assistant 等待 EZVIZ API 数据的时长，超时以秒为单位。如果 API 响应时间超过指定超时，Home Assistant 将停止等待并假定请求失败。根据您的网络条件和 EZVIZ API 的响应能力调整此值。对于较慢的连接，可能需要更高的超时设置。
-
示例：如果您将 请求超时 设置为 30 秒（默认选项），Home Assistant 将等待至多 30 秒以获取来自 EZVIZ API 的响应，然后超时。
-
请注意，这仅适用于主要的 EZVIZ 云实体。
传递给摄像头的 ffmpeg 参数：
-
此选项允许您为捕捉 EZVIZ 摄像头的录像定义额外的参数。虽然摄像头分辨率和编码器设置通常在“Ezviz Studio”桌面应用程序中配置，但您可以使用此选项选择所需的流或子流以捕捉录像。
-
要选择合适的流或子流，请在
传递给摄像头的 ffmpeg 参数字段中指定相应的通道路径。通道路径标识摄像头的特定流或子流。 -
示例：如果您希望使用摄像头的子流，可以将通道路径指定为
/Streaming/Channels/102。或者，如果您更喜欢主流，请使用/Streaming/Channels/101。您还可以根据摄像头的能力和资源需求配置多个流/子流选项。 -
如果此无效或未指定，摄像头通常默认为主流。
-
请注意，这仅适用于摄像头实体。
动作 ezviz.alarm_sound
如果您的 EZVIZ 摄像头支持警告音，您可以使用此动作设置音量。
| 数据属性 | 描述 |
|---|---|
entity_id |
指向摄像头的 entity_id 的字符串或字符串列表。使用 entity_id: all 来针对所有。 |
level |
将音量设置为 0 表示柔和，1 表示强烈，2 表示禁用 |
动作 ezviz.ptz
如果您的 EZVIZ 摄像头支持 PTZ，您将能够对摄像头进行水平或垂直移动。
| 数据属性 | 描述 |
|---|---|
entity_id |
指向摄像头的 entity_id 的字符串或字符串列表。使用 entity_id: all 来针对所有。 |
direction |
移动方向。允许的值：up，down，left，right
|
speed |
（可选）移动摄像头的速度。允许的值：从 1 到 9 的整数。默认值：5 |
动作 ezviz.set_alarm_detection_sensibility
如果您的 EZVIZ 摄像头支持运动检测，您将能够使用此动作设置灵敏度级别。
| 数据属性 | 描述 |
|---|---|
entity_id |
指向摄像头的 entity_id 的字符串或字符串列表。使用 entity_id: all 来针对所有。 |
level |
灵敏度级别 (1-6) 对于类型 0（普通摄像头）或 (1-100) 对于类型 3（PIR 传感器摄像头）。 |
type_value |
检测类型。选项：0 - 摄像头或 3 - PIR 传感器摄像头。 |
动作 ezviz.sound_alarm
如果您的 EZVIZ 摄像头具有内置警报器，您可以使用此动作发出声音。
| 数据属性 | 描述 |
|---|---|
entity_id |
指向摄像头的 entity_id 的字符串或字符串列表。使用 entity_id: all 来针对所有。 |
enable |
通过将此设置为 1 来发出警报，或通过将其设置为 0 来停止警报。 |
动作 ezviz.wake_device
如果您在摄像头上启用了“睡眠”模式，您可以使用此动作将其唤醒。尤其适用于电池摄像头。
| 数据属性 | 描述 |
|---|---|
entity_id |
指向摄像头的 entity_id 的字符串或字符串列表。使用 entity_id: all 来针对所有。 |
要启用/禁用运动检测，请使用 Home Assistant 内置的动作。
动作 camera.enable_motion_detection
| 数据属性 | 描述 |
|---|---|
entity_id |
指向摄像头的 entity_id 的字符串或字符串列表。使用 entity_id: all 来针对所有。 |
动作 camera.disable_motion_detection
| 数据属性 | 描述 |
|---|---|
entity_id |
指向摄像头的 entity_id 的字符串或字符串列表。使用 entity_id: all 来针对所有。 |
警报控制面板实体
EZVIZ 平台中的警报控制面板实体允许用户管理和控制所有 EZVIZ 设备的警报状态。使用此实体，用户可以在三种选项中选择：外出警报、睡眠警报和 解除警报。
OTA 更新
触发设备 OTA 固件更新过程以获取最新稳定版本。
运动检测灵敏度
运动检测灵敏度可以使用“检测灵敏度”数字实体进行调整。重要的是要注意，此实体从设备获取信息，如果您的电池供电摄像头处于睡眠模式，它将不会更新，因为该措施旨在保护电池寿命并防止过度耗电。
警报器
警报器实体允许您在设备上激活警报功能。在大多数摄像头中，警报功能包含一个闪光灯和/或一个音响警报，旨在阻止潜在入侵者。 触发后，警报器将在 60 秒后自动停用（这是 EZVIZ 执行的，而不是通过集成完成的）。或者，您可以使用实体来手动停用警报器。
PTZ
PTZ 上/下/左/右按钮可用于受支持的 PTZ 摄像头的平移和倾斜控制。
警告音
如果您的摄像头支持运动检测警告音，您可以使用此实体选择音量级别。
灯光实体
将为摄像头和灯光组合添加一个灯光实体。您可以打开/关闭它并设置亮度。
图像实体
图像实体表示来自摄像头的最后一次检测事件，并在 Home Assistant 中可视化此事件。
疑难解答
-
身份验证失败：身份验证要求具有禁用双重验证的 EZVIZ 账户。谷歌、Facebook、TikTok 或其他基于 Oauth 的账户将无法使用。