2025.3.4
首页 ▸ Integrations ▸

摄像头代理

proxy 摄像头 integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 允许您通过后处理程序将另一摄像头的输出传递，并生成带有后处理输出的新摄像头。

当前的后处理支持调整图像/MJPEG 的大小和/或裁剪，以及限制最大刷新率。

当前的代理功能旨在减少较慢互联网连接的摄像头带宽。

配置

要在您的安装中启用此摄像头，您必须首先在 Home Assistant 中配置一个现有的工作摄像头。接下来，向您的 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件中添加以下内容。 在更改了configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件后，重启 Home Assistant 以应用更改。 该集成现在显示在集成页面的 设置 > 设备与服务 下。其实体在集成卡片上以及实体标签上列出。

# 示例 configuration.yaml 条目
camera:
  - platform: proxy
    entity_id: camera.<existingcamera>
    max_stream_width: 360
    max_image_width: 720

Configuration Variables

Looking for your configuration file?
entity_id string Required

另一个 Home Assistant 摄像头的 ID，以进行后处理。

name string (Optional)

此参数允许您覆盖摄像头的名称。

mode string (Optional, default: resize)

操作模式，选择 resize 或 crop。

max_image_width integer (Optional)

从摄像头捕获的单张图像的最大宽度（在调整大小处理时将保持纵横比）。

max_image_height integer (Optional)

从摄像头捕获的单张图像的最大高度，仅用于裁剪操作。如果未提供，默认假定为原始高度。

max_stream_width integer (Optional)

从摄像头的 MJPEG 流的最大宽度（在调整大小处理时将保持纵横比）。

max_stream_height integer (Optional)

从摄像头的 MJPEG 流的最大高度，仅用于裁剪操作。如果未提供，默认假定为原始高度。

image_top integer (Optional, default: 0)

用作裁剪操作起始点的上（y）坐标。

image_left integer (Optional, default: 0)

用作裁剪操作起始点的左（x）坐标。

image_quality integer (Optional, default: 75)

用于快照生成 JPEG 的质量级别。

stream_quality integer (Optional, default: 75)

用于生成 MJPEG 流的质量级别。

image_refresh_rate float (Optional)

生成连续图像快照之间的最小时间（秒）。

force_resize boolean (Optional, default: false)

即使生成的图像会占用更大带宽，也要调整图像大小。

cache_images boolean (Optional, default: false)

保留最后一张图像并在摄像头未响应的情况下重新发送。

示例

使用两个摄像头代理和一个 Foscam 摄像头的示例：

camera:
  - platform: foscam
    ip: 192.168.1.10
    username: foscam_camera
    password: camera_password
    name: mycamera
  - platform: proxy
    entity_id: camera.mycamera
    max_stream_width: 360
    max_image_width: 480
    image_refresh_rate: 5.0
  - platform: proxy
    entity_id: camera.mycamera
    name: My cropped camera
    mode: crop
    max_image_width: 480
    max_image_height: 320
    max_stream_width: 480
    max_stream_height: 320
    image_left: 100

相关主题