Home Assistant Agent DVR 连续录像实战agent_dvr.start_recording 动作完整指南【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.ioAgent DVR 是一款可运行在 Windows、macOS 与 Linux 上的免费软件 DVR 方案支持对接大量第三方摄像头并内置高级运动检测含 DeepStack 物体识别。本文基于 Home Assistant 官方文档中agent_dvr.start_recording动作的完整说明系统讲解如何在自动化与脚本中控制 Agent DVR 摄像头开始连续录像覆盖 UI 可视化配置、YAML 直写、目标选择Targets与配套动作帮助你搭建检测到异常即开始录像等典型安防场景。前置条件先接入 Agent DVR 集成agent_dvr.start_recording属于 Agent DVR 集成ha_domain: agent_dvr集成类型为 hub包含alarm_control_panel与camera两种平台提供的动作。要使用它你首先需要将 Agent DVR 服务器添加到 Home Assistant在集成配置界面输入 Agent DVR 服务器的 IP 与端口格式如http://192.168.1.3:8090/若在 Agent DVR 服务器上开启了 Protect API 功能可将用户名密码一并写入 URL例如http://username:password192.168.1.3:8090官方文档特别强调请确保使用 Agent DVR v2.6.1.0 及以上版本。从实现层面看该集成通过配置流config flow完成接入见 source/_integrations/agent_dvr.markdown 中的ha_config_flow: true接入后每个摄像头会以camera.*实体形式暴露给 Home Assistantagent_dvr.start_recording动作正是作用在这些摄像头实体上。动作概览start_recording 做什么根据 agent_dvr.start_recording 动作文档 的定义使用该动作在 Agent DVR 摄像头上开始连续录像continuous recording。录像会持续进行直到你用agent_dvr.stop_recording动作将其停止。两个关键事实需要明确连续录像是持续行为该动作一旦执行录像不会自动结束必须由配套的agent_dvr.stop_recording动作显式停止存储发生在 Agent DVR 侧录像文件由 Agent DVR 服务端负责捕获与存储Home Assistant 只负责下发控制指令因此录像的码流、存储策略与告警行为均遵循 Agent DVR 自身的配置。动作元数据中声明了相关动作related_actionsagent_dvr.stop_recording与agent_dvr.snapshot分别对应停止录像与抓拍快照构成一组完整的事件取证能力。从 UI 中使用该动作自动化与脚本如果你倾向可视化配置Home Assistant 会在编辑器中逐步引导你完成设置——选择目标、调整选项、保存即可无需掌握 YAML。官方文档给出的操作步骤如下进入Settings Automations scenes自动化与场景打开已有的自动化或脚本或选择Create automationCreate new automation新建若在新建自动化需先在When触发条件部分添加触发器脚本则不需要触发器脚本在被其他东西调用时才会运行在Then do执行动作部分选择Add action添加动作选择你要控制的对象在By target按目标详见下文Targets下选择你的 Agent DVR 摄像头从该目标可用的动作列表中选择Start recording开始录像点击Save保存。UI 选项说明该动作在 UI 中没有额外的选项字段This action has no additional options in the UI你只需要指定目标即可。这与同域其他动作stop_recording、snapshot、enable_alerts、disable_alerts保持一致。在 YAML 中使用该动作如果你直接编写 YAML或希望精确了解 Home Assistant 底层的行为本节提供技术参考列出 YAML 中的字段名、类型与必填项。在 YAML 中动作名称为agent_dvr.start_recording官方给出如下最小可运行示例action: agent_dvr.start_recording target: entity_id: camera.living_room该动作只有一个必填要素——target目标且无额外参数。你可以将此动作直接嵌入自动化或脚本中例如结合运动检测传感器alias: 门口检测到人时开始录像 triggers: - trigger: state entity_id: binary_sensor.front_door_motion to: on actions: - action: agent_dvr.start_recording target: entity_id: camera.front_door请务必同时规划停止录像的动作见下文停止录像与配套动作否则录像将持续占用存储空间。Targets动作的作用对象根据 actions/targets.md 模板agent_dvr.start_recording需要指定一个 target它是动作的作用对象。你可以将动作指向单个实体、设备、区域、楼层或标签Home Assistant 会对该目标背后的每一个匹配camera实体执行动作。可选的目标类型Entity实体某一个具体的camera实体例如camera.living_roomDevice设备属于某台设备的所有camera实体Area区域某个房间或区域内的所有camera实体Floor楼层某一楼层上的所有camera实体Label标签共享某个标签的所有camera实体。你还可以在同一个动作中混合选择不同类型的目标例如同时指定一个具体实体和一个区域让动作对二者同时生效。这一机制让你可以一条动作同时启动多路摄像头录像例如全屋布防时对所有室外摄像头开始录像。停止录像与配套动作agent_dvr.start_recording启动的连续录像不会自己停止配套动作是 agent_dvr.stop_recording它停止此前通过start_recording开始的连续录像。YAML 写法对称action: agent_dvr.stop_recording target: entity_id: camera.living_room同一动作族中还有两个常用能力便于组合成完整的安防取证流程agent_dvr.snapshot在 Agent DVR 摄像头上拍摄一张照片快照由 Agent DVR 捕获并存储agent_dvr.enable_alerts / agent_dvr.disable_alerts启用/禁用 Agent DVR 的告警事件例如检测到运动时产生告警事件实现按需开关事件通知。参考的实战组合运动传感器触发时先enable_alerts并start_recording运动消失后stop_recording需要时再snapshot固定现场画面。此外Agent DVR 摄像头同样支持标准 camera 动作例如开关摄像头与切换运动检测可将录像控制与开关控制分层使用。立即测试动作如果你想在不写任何 YAML 的情况下验证效果可以打开Settings Tools Actions开发者工具中的动作面板即文档中所述 Actions 工具搜索该动作填写字段后点击Perform action执行动作即可在你真实的实体上观察结果。排错建议如果动作没有按预期生效可按以下方向排查确认版本与连接Agent DVR 需为 v2.6.1.0且 Home Assistant 与 Agent DVR 服务器网络互通该集成属于 Local Polling 本地轮询类型确认目标实体target中填写的实体必须是对应 Agent DVR 摄像头的camera.*实体可通过 UI 中的目标选择器核对实际实体 ID确认录像确实在连续模式该动作启动的是连续录像而非事件录像停止动作必须显式调用agent_dvr.stop_recording查看日志与社区如果问题依旧可在 Home Assistant 官方社区渠道Discord、社区论坛或 subreddit发帖附上你调用的动作、目标实体与预期行为便于他人快速定位。小结agent_dvr.start_recording是 Home Assistant 控制 Agent DVR 摄像头连续录像的核心动作它通过 UI 与 YAML 两种方式都可使用唯一的必填参数是 target配合stop_recording、snapshot与告警开关动作即可构建从检测事件 → 开始录像 → 抓拍取证 → 停止录像的完整自动化链路。对以本地存储、无需端口转发的 Agent DVR 用户而言这是把第三方摄像头接入 Home Assistant 自动化体系最直接的一环。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考