2025.3.4
首页 ▸ Integrations ▸

VIVOTEK

VIVOTEK 摄像头 integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 允许你将VIVOTEK IP摄像头集成到Home Assistant中。

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

配置

要在您的安装中启用此摄像头，请将以下内容添加到您的 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: vivotek
    ip_address: IP_ADDRESS
    username: 用户名
    password: 密码

Configuration Variables

Looking for your configuration file?
ip_address string Required

摄像头的IP地址，例如，192.168.1.2。

name string (Optional, default: VIVOTEK 摄像头)

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

username string Required

访问摄像头的用户名。

password string Required

访问摄像头的密码。

authentication string (Optional, default: basic)

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

security_level string (Optional, default: admin)

访问摄像头的用户的安全级别。可以是 admin 或 viewer。

ssl boolean (Optional, default: false)

启用或禁用SSL。设置为false以使用仅限HTTP的摄像头。

verify_ssl boolean (Optional, default: true)

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

framerate integer (Optional, default: 2)

流的每秒帧数（FPS）。可能会在网络上造成大量流量和/或对摄像头造成较大负担。

stream_path string (Optional, default: live.sdp)

此参数允许您覆盖流路径。

高级配置 

# 示例 configuration.yaml 条目
camera:
  - platform: vivotek
    name: 前门摄像头
    ip_address: 192.168.1.2
    ssl: true
    username: !secret fd_camera_username
    password: !secret fd_camera_pwd
    authentication: digest
    security_level: admin
    verify_ssl: false
    framerate: 5
    stream_path: live2.sdp

操作

加载后，camera 平台将暴露可以调用以执行各种操作的动作。

可用的操作：enable_motion_detection、disable_motion_detection、snapshot 和 play_stream。

操作 play_stream

从摄像头播放直播流到选定的媒体播放器。需要设置stream integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more]。

数据属性 可选 描述
entity_id 否 获取流的 entity实体表示 Home Assistant 中的传感器、执行器或功能。实体用于监控物理属性或控制其他实体。实体通常是设备或服务的一部分。 [Learn more] 的名称，例如，camera.front_door_camera。
media_player 否 播放流的媒体播放器名称，例如，media_player.living_room_tv。
format 是 stream integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 支持的流格式和选定的 media_player。默认：hls

例如，以下自动化中的操作将向您的Chromecast发送一个hls直播流。

actions:
  - action: camera.play_stream
    target:
      entity_id: camera.yourcamera
    data:
      media_player: media_player.chromecast

操作 enable_motion_detection

在摄像头中启用运动检测。目前，这将启用摄像头上配置的第一个事件。

数据属性 可选 描述
entity_id 是 要启用运动检测的实体名称，例如，camera.front_door_camera。

操作 disable_motion_detection

禁用摄像头中的运动检测。目前，这将禁用摄像头上配置的第一个事件。

数据属性 可选 描述
entity_id 是 要禁用运动检测的实体名称，例如，camera.front_door_camera。

操作 snapshot

从摄像头拍摄快照。

数据属性 可选 描述
entity_id 否 要创建快照的实体名称，例如，camera.front_door_camera。
filename 否 文件名的模板。变量为 entity_id，例如，/tmp/snapshot_{{ entity_id }}。

filename 的路径部分必须是您在configuration.yaml文件的 homeassistant: 部分中的 allowlist_external_dirs 中的一个条目。

例如，以下操作是一个自动化，将从“front_door_camera”拍摄快照并保存到/tmp，文件名带有时间戳。

actions:
  - action: camera.snapshot
    target:
      entity_id: camera.front_door_camera
    data:
      filename: '/tmp/yourcamera_{{ now().strftime("%Y%m%d-%H%M%S") }}.jpg'

相关主题