2025.3.4
首页 ▸ Integrations ▸

通用摄像头

generic 摄像头平台允许您将任何IP摄像头或其他URL集成到Home Assistant中。可以使用模板动态生成URLs。

Home Assistant将通过其服务器提供图像，允许您在网络外部查看您的IP摄像头。端点是/api/camera_proxy/camera.[name]。

配置

要将 通用摄像头 设备 添加到您的 Home Assistant 实例中，请使用此 My 按钮：

手动配置步骤

如果上述 My 按钮不起作用，您也可以手动执行以下步骤：

您必须在静态图像URL或流源URL中的至少一个字段输入URL，其他字段为可选。

在URL字段中允许使用模板，这些模板可以根据传感器状态选择不同的图像或对URL进行参数化。在配置步骤中会检查模板的有效性和网络访问权限。

静态图像URL

摄像头提供图像的URL，例如 http://192.168.1.21:2112/。可以是模板。URL中允许包含用户名和密码，但如果未提供，则在身份验证时将使用Username和Password设置。必须提供静态图像URL或流源中的至少一个。

流源

摄像头提供实时流的URL，例如 rtsp://192.168.1.21:554/。可以是模板。URL中允许包含用户名和密码，但如果未提供，则在身份验证时将使用Username和Password设置。必须提供静态图像URL或流源中的至少一个。注意，如果未配置流集成，则无静态图像URL的流源只能使用。

用户名

访问摄像头的用户名。注意这适用于静态图像URL和流源。

密码

访问摄像头的密码。注意这适用于静态图像URL和流源。

身份验证

请求身份验证的类型 basic 或 digest。

限制重新获取至URL更改

限制远程图像的重新获取到URL更改时。仅在使用模板获取远程图像时相关。

帧率

流的每秒帧数 (FPS)。可能会造成网络上的高流量和/或摄像头的高负载。

验证SSL证书

启用或禁用SSL证书验证。设置为false以使用仅http的摄像头，或您有自签名SSL证书且未安装CA证书以启用验证。

RTSP传输协议

将RTSP传输协议设置为 tcp、udp、udp_multicast 或 http。

使用时钟作为时间戳

(高级模式专用) 重写摄像头时间戳。这可能有助于播放或某些品牌（例如EZVIZ）Wi-Fi摄像头的崩溃问题。

显示Home Assistant前端中Google Maps集成的屏幕截图。 显示指向动态Google地图图像的通用摄像头平台的示例。

示例

在本节中，您将找到一些如何使用此摄像头平台的实际示例。

美国国家气象局的天气图

您可以显示来自网络的GIF作为静态图像。

  • 静态图像URL: https://radar.weather.gov/ridge/standard/CONUS_0.gif

本地图像

您可以使用此平台显示静态图像。只需将图像放在这里：/config/www/your_image.png

  • 静态图像URL: https://127.0.0.1:8123/local/your_image.png

从一个Home Assistant实例共享摄像头馈送到另一个

如果您正在运行多个Home Assistant实例（我们称之为“主机”和“接收”实例），您可能希望在接收实例上显示来自主机实例的摄像头馈送。您可以使用REST API访问主机上的摄像头馈送（IP地址127.0.0.5），并通过配置接收实例进行显示，如下所示：

  • 静态图像URL: https://127.0.0.5:8123/api/camera_proxy/camera.live_view

来自仅HTTP摄像头的图像

要访问仅通过HTTP提供的摄像头，您必须关闭SSL验证。

  • 静态图像URL: http://example.org/your_image.png

实时流

要访问同时具有快照和实时流URL的摄像头，可以利用流集成。

  • 静态图像URL: http://194.218.96.92/jpg/image.jpg
  • 流源: rtsp://user:pass@194.218.96.92:554

如果摄像头只有实时流URL而没有快照URL，流集成也可以从实时流URL生成静态图像。

  • 流源: rtsp://user:pass@194.218.96.92:554

安全访问摄像头

要访问需要进行安全访问的摄像头（在我的例子中是HIK），以获取静态图像或实时流。

  • 静态图像URL: http://192.168.1.100/ISAPI/Streaming/Channels/101/picture
  • 流源: rtsp://USERNAME:PASSWORD@192.168.1.100:554/Streaming/Channels/102
  • 验证SSL: false
  • 用户名: user
  • 密码: pass
  • 身份验证: digest