Home Assistant 停止 Amcrest / Dahua 摄像头 PTZ 巡游：amcrest.stop_tour 动作完整指南-酒店常州论坛

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.io

amcrest.stop_tour是 Home Assistant 中用于停止 Amcrest（以及兼容的 Dahua）IP 摄像头 PTZ（云台、俯仰、变焦）巡游（tour）功能的动作（action）。本文以amcrest.stop_tour 动作文档为主体，结合 Amcrest 集成文档及配套的 start_tour、ptz_control、goto_preset 等动作说明，完整讲解如何在自动化、脚本和 YAML 中停止 PTZ 巡游，并给出可与该动作配合使用的完整实战方案。读完本文，你将掌握：在图形界面与 YAML 中调用amcrest.stop_tour的完整方法、目标（target）选择规则，以及围绕 PTZ 巡游的"启动—控制—停止"自动化编排技巧。

Amcrest 摄像头 PTZ 控制示例截图

action: | action: amcrest.stop_tour target: entity_id: camera.driveway

上述示例会停止camera.driveway这台摄像头的巡游功能。

同样地，该动作在 YAML 中也没有额外的选项（data 字段）。可用的字段只有通用的target（必填）。这与配套动作形成鲜明对比，便于记忆：

动作	参数（data）	说明
`amcrest.stop_tour`	无	停止巡游，仅需 target
`amcrest.start_tour`	无	启动巡游，仅需 target
`amcrest.goto_preset`	`preset`（必填，integer，从 1 开始）	移动到指定预设位
`amcrest.ptz_control`	`movement`（必填，string）；`travel_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_down，travel_time以秒为单位（支持小数），控制单次移动的持续时长。这些参数细节均来自 ptz_control 动作文档的参数表。

动作的目标（Target）规则

amcrest.stop_tour需要且仅需要一个目标（target）。目标就是动作的作用对象，你可以把动作指向单个实体（entity）、设备（device）、区域（area）、楼层（floor）或标签（label），Home 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 中改过用户名，也仍使用`admin`）
`password`	是	—	摄像头登录密码
`name`	否	`Amcrest Camera`	覆盖摄像头名称；多摄像头场景强烈建议设置
`port`	否	`80`	摄像头端口
`resolution`	否	`high`	`high`（1080/720p）或`low`（640x480p）
`stream_source`	否	`snapshot`	`mjpeg`、`snapshot`或`rtsp`
`ffmpeg_arguments`	否	`-pred 1`	传给 FFmpeg 的额外参数
`authentication`	否	`basic`	`stream_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 预设位数量）来确认摄像头预设位已就绪，确保巡游能够在预设位之间正常往返。