Home Assistant 停止 Amcrest / Dahua 摄像头 PTZ 巡游amcrest.stop_tour 动作完整指南【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.ioamcrest.stop_tour是 Home Assistant 中用于停止 Amcrest以及兼容的 DahuaIP 摄像头 PTZ云台、俯仰、变焦巡游tour功能的动作action。本文以amcrest.stop_tour 动作文档 为主体结合 Amcrest 集成文档 及配套的 start_tour、ptz_control、goto_preset 等动作说明完整讲解如何在自动化、脚本和 YAML 中停止 PTZ 巡游并给出可与该动作配合使用的完整实战方案。读完本文你将掌握在图形界面与 YAML 中调用amcrest.stop_tour的完整方法、目标target选择规则以及围绕 PTZ 巡游的启动—控制—停止自动化编排技巧。Amcrest 摄像头 PTZ 控制示例截图动作概览何时需要停止巡游在 Home Assistant 中Amcrest 或 Dahua 摄像头开启巡游后云台会在预设位preset position之间自动往返转动实现无人值守的周期性全景巡视。但在以下典型场景中你需要及时停止巡游检测到移动或人员时希望镜头立刻锁定事发区域避免巡游把画面带走人工接管云台时先用amcrest.stop_tour停住自动转动再用 amcrest.ptz_control 手动调整方向或用 amcrest.goto_preset 跳转到指定预设位夜间或离家模式下按日程定时结束巡视任务。amcrest.stop_tour动作正是为此设计的它直接停止当前摄像头正在执行的 PTZ 巡游与amcrest.start_tour一一对应且不携带任何额外参数——你只需要指明要操作哪台摄像头目标。从用户界面UI停止巡游如果你偏好可视化配置Home Assistant 会引导你逐步完成该动作的设置无需编写 YAML。按照动作文档中的步骤操作即可进入设置Settings 自动化与场景Automations scenes。打开一个现有的自动化或脚本或选择创建Create新建一个。如果是新建自动化在When触发条件区域添加触发器脚本script则不需要触发器。在Then do动作区域选择添加动作Add action。在按目标By target下目标规则见下文动作的目标一节选择要控制的摄像头你也可以选择区域area、设备device或标签label。在针对该目标显示的动作列表中选择Amcrest停止巡游Stop tour。点击保存Save。需要特别说明的是该动作在 UI 中没有额外的选项字段。相比amcrest.ptz_control有 Movement、Travel time 两个选项和amcrest.goto_preset有 Preset 选项amcrest.stop_tour只做一件事——停因此界面非常简洁。在 YAML 中调用 amcrest.stop_tour如果你直接编写 YAML或想确切了解 Home Assistant 在底层做了什么可以参考本节的技术参考。YAML 中该动作的名称是amcrest.stop_tour基础示例如下action: | action: amcrest.stop_tour target: entity_id: camera.driveway上述示例会停止camera.driveway这台摄像头的巡游功能。同样地该动作在 YAML 中也没有额外的选项data 字段。可用的字段只有通用的target必填。这与配套动作形成鲜明对比便于记忆动作参数data说明amcrest.stop_tour无停止巡游仅需 targetamcrest.start_tour无启动巡游仅需 targetamcrest.goto_presetpreset必填integer从 1 开始移动到指定预设位amcrest.ptz_controlmovement必填stringtravel_time可选float默认 0.2范围 0–1按方向手动转动/变焦其中amcrest.ptz_control的movement可取值为zoom_in、zoom_out、up、down、left、right、right_up、right_down、left_up、left_downtravel_time以秒为单位支持小数控制单次移动的持续时长。这些参数细节均来自 ptz_control 动作文档 的参数表。动作的目标Target规则amcrest.stop_tour需要且仅需要一个目标target。目标就是动作的作用对象你可以把动作指向单个实体entity、设备device、区域area、楼层floor或标签labelHome Assistant 会对该目标背后所有匹配的camera实体执行动作实体Entity某一个具体的camera实体例如camera.living_room。设备Device属于某台设备的所有camera实体。区域Area某个房间或区域内的所有camera实体。楼层Floor某一楼层上的所有camera实体。标签Label共享某个标签的所有camera实体。你还可以在同一个动作中组合多种目标类型。例如把一台具体实体和一个区域同时作为目标Home Assistant 会一次性地对两者全部执行停止巡游。以上规则来自仓库中的 targets 模板。利用这一特性一条动作即可批量停止多台摄像头的巡游action: | action: amcrest.stop_tour target: entity_id: camera.driveway area_id: backyard完整实战巡游启动与停止的自动化编排单独的停止动作价值有限把它与启动、手动控制动作组合才能发挥巡游的威力。以下是一个白天定时巡游、检测到移动立即停止并追踪的完整自动化示例# 白天 9:00 开始巡游 alias: Start PTZ tour during the day triggers: - trigger: time at: 09:00:00 conditions: - condition: time weekday: - mon - tue - wed - thu - fri actions: - action: amcrest.start_tour target: entity_id: camera.driveway# 检测到移动时停止巡游并转到最近关注的预设位 alias: Stop tour and focus on motion triggers: - trigger: state entity_id: binary_sensor.driveway_motion to: on actions: - action: amcrest.stop_tour target: entity_id: camera.driveway - action: amcrest.goto_preset target: entity_id: camera.driveway data: preset: 1脚本script中同样可以直接使用该动作例如下班回家时停止巡游# scripts.yaml 片段 stop_tour_evening: alias: Stop tour in the evening sequence: - action: amcrest.stop_tour target: entity_id: camera.driveway如需在 Lovelace 仪表盘上提供手动控制可以参考 Amcrest 集成文档 中的picture-elements卡片示例——它为摄像头画面叠加了 8 个方向与缩放控制按钮通过perform_action: amcrest.ptz_control与service_data传递movement参数你也可以在同样的卡片中增加一个停止巡游按钮直接调用amcrest.stop_tour实现一键接管云台。前置条件Amcrest 集成配置要使用amcrest.stop_tour首先需要在configuration.yaml中配置 Amcrest 集成。基础配置如下# Example configuration.yaml entry amcrest: - host: IP_ADDRESS_CAMERA username: YOUR_USERNAME password: YOUR_PASSWORD关键配置项一览完整参数表见 amcrest.markdown参数必填默认值说明host是—摄像头 IP 地址或主机名username是—摄像头登录用户名多数 Amcrest 设备即使在其 App 中改过用户名也仍使用adminpassword是—摄像头登录密码name否Amcrest Camera覆盖摄像头名称多摄像头场景强烈建议设置port否80摄像头端口resolution否highhigh1080/720p或low640x480pstream_source否snapshotmjpeg、snapshot或rtspffmpeg_arguments否-pred 1传给 FFmpeg 的额外参数authentication否basicstream_source为mjpeg时的认证方式scan_interval否10传感器更新间隔秒sensors否无可启用sdcard、ptz_preset返回已配置的 PTZ 预设位数量等传感器switches否无可启用privacy_mode等开关多摄像头场景下可参考如下进阶配置来自集成文档amcrest: - host: IP_ADDRESS_CAMERA_1 username: YOUR_USERNAME password: YOUR_PASSWORD binary_sensors: - motion_detected - crossline_detected - online sensors: - sdcard # Add second camera - host: IP_ADDRESS_CAMERA_2 username: YOUR_USERNAME password: YOUR_PASSWORD name: Amcrest Camera 2 resolution: low stream_source: snapshot sensors: - ptz_preset配置完成后摄像头会以camera实体形式出现在 Home Assistant 中amcrest.stop_tour等 PTZ 相关动作即可对该实体生效。你可以结合sensors中的ptz_preset传感器返回摄像头已配置的 PTZ 预设位数量来确认摄像头预设位已就绪确保巡游能够在预设位之间正常往返。动手试一试开发者工具中的实时验证如果你急于验证动作效果无需编写任何 YAML打开设置 工具Tools 动作Actions搜索amcrest.stop_tour在字段中填入目标例如camera.driveway点击执行动作Perform action即可在真实实体上立即看到效果。这是排查问题、确认目标实体 ID 的最快途径该入口说明来自 try_it 模板。使用注意事项结合 Amcrest 集成文档 中的说明使用 PTZ 相关动作时有两点需要留意PTZ 的变焦zoom能力不控制可变焦距VariFocal镜头的焦距调整二者是两套机制视频画面快照或实时流反映云台移动结果可能存在数秒延迟因此在停止巡游、转向或变焦后画面不会立即定格到位设计自动化触发条件时应预留缓冲时间。另外巡游动作依赖摄像头固件对 PTZ 协议的支持。若动作无响应可先通过摄像头的管理界面确认 PTZ 预设位与巡游配置是否已就绪再检查amcrest集成日志。相关动作amcrest.stop_tour通常与以下动作配合使用相关动作列表定义在 stop_tour 文档 的 frontmatter 中由 related 模板 渲染Start tour启动 PTZ 巡游让摄像头在配置好的预设位之间自动移动PTZ control手动平移、俯仰或缩放摄像头可指定方向与移动时长Go to preset将摄像头移动到某个已配置的 PTZ 预设位编号从 1 开始。四者共同构成了完整的 PTZ 控制闭环start_tour开启自动巡视 → 发现关注目标时stop_tour立即停住 →ptz_control手动微调或goto_preset跳转预设位 → 需要时再次start_tour恢复巡视。把这一闭环写进自动化与脚本即可让 Amcrest / Dahua 摄像头真正实现自动巡视、按需聚焦的智能监控体验。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考