Home Assistant 中 Amcrest 摄像头 PTZ 巡航Tour动作 amcrest.start_tour 完整使用指南【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.ioamcrest.start_tour是 Home Assistant 官方 Amcrest 集成提供的动作用于在支持云台Pan/Tilt/Zoom简称 PTZ的 Amcrest 或 Dahua 摄像头上启动巡航功能摄像头会在其已配置的多个预置位preset之间自动往返移动。本文将围绕该动作从动作调用方式、YAML 配置、目标Target选择机制到与之配套的amcrest.stop_tour、amcrest.goto_preset、amcrest.ptz_control系列动作结合仓库文档与集成配置给出可直接落地的自动化与前端控制方案。动作概览启动 PTZ 巡航PTZ 巡航tour是安防摄像头的一项常用功能。当巡航被启动后云台会自动依次访问设备内预设的若干预置位实现对周边环境的周期性巡视。Home Assistant 的 Amcrest 集成通过amcrest.start_tour动作把这一能力暴露给自动化automation与脚本script系统动作定义与说明位于 source/_actions/amcrest.start_tour.markdown。该动作的完整元信息如下项目值动作名称amcrest.start_tour所属域domainamcrest作用在 Amcrest 或 Dahua 摄像头上启动 PTZ 巡航UI 附加选项无YAML 附加选项无必须参数目标target如具体的camera.*实体关联动作amcrest.stop_tour、amcrest.ptz_control、amcrest.goto_preset需要强调的是该动作本身没有额外的参数——巡航过程完全由摄像头内部已配置的预置位驱动Home Assistant 只负责发送“启动”指令。预置位的数量可通过集成的ptz_preset传感器查询详见下文集成配置部分。前置条件确保 Amcrest 集成已正确配置amcrest.start_tour隶属于 source/_integrations/amcrest.markdown 所描述的 Amcrest 集成兼容 Dahua 设备。在使用任何 PTZ 动作之前必须先在configuration.yaml中完成集成配置并重启 Home Assistant# Example configuration.yaml entry amcrest: - host: IP_ADDRESS_CAMERA username: YOUR_USERNAME password: YOUR_PASSWORD其中仅host、username、password为必填项。仓库文档列出的其余可选参数与默认值如下参数说明默认值name覆盖摄像头名称多摄像头场景强烈建议配置否则重启后摄像头编号可能随机变化Amcrest Cameraport摄像头 HTTP 端口80resolution画面分辨率high对应 1080/720plow对应 VGA640x480phighstream_source视频流数据源mjpeg原生 MJPEG 流、snapshot快照 API 拼流或rtspsnapshotffmpeg_arguments传递给 FFmpeg 的额外参数-pred 1authentication仅当stream_source为mjpeg时的认证方式aiohttp 目前仅支持basicbasicscan_interval传感器轮询间隔秒10binary_sensors需要监控的二进制传感器条件如motion_detected、motion_detected_polled、crossline_detected、online等无sensors需要监控的传感器包括sdcardSD 卡用量与ptz_presetPTZ 预置位数量无switches可控制的开关如privacy_mode隐私模式无control_light是否根据音视频流启停自动控制摄像头指示灯true例如若要同时监控巡航所需的预置位数量可做如下高级配置# Example configuration.yaml entry amcrest: - host: IP_ADDRESS_CAMERA_1 username: YOUR_USERNAME password: YOUR_PASSWORD binary_sensors: - motion_detected - online sensors: - sdcard - ptz_preset # 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两个实践注意事项来源同为集成文档较新固件的 Amcrest 摄像头可能无法以 MJPEG 编码播放high分辨率视频此时应改用low分辨率或snapshot/rtsp数据源若画面质量不佳可在摄像头管理界面调低帧率Frame Rate/FPS并调高码率Bit Rate。PTZ 的缩放zoom能力不控制可变焦距镜头VariFocal的调节后者需要到摄像头自身界面操作。在 UI 中添加动作自动化 / 脚本按照 source/_actions/amcrest.start_tour.markdown 中的操作说明在图形界面中配置该动作的步骤如下进入设置Settings 自动化与场景Automations scenes。打开一个已有的自动化或脚本或点击创建Create新建。新建自动化时在何时When区域添加触发条件脚本则不需要触发器。在做什么Then do区域点击添加动作Add action。选择要控制的对象在按目标By target下详见下文“动作目标”一节选择要控制的摄像头也可以选择区域area、设备device或标签label。在列出的动作中选择Amcrest: Start tour。点击保存Save。该动作在 UI 中没有额外的配置选项选择目标并保存即可生效。在 YAML 中使用基础示例在automations.yaml、脚本或蓝图中动作统一写作amcrest.start_tour。最基础的调用形式如下action: amcrest.start_tour target: entity_id: camera.driveway上述配置会启动camera.driveway这台摄像头的巡航功能。由于该动作没有附加参数data块可以完全省略。结合触发器的完整自动化示例——例如夜间 22:00 启动庭院摄像头巡航次日 06:00 停止alias: Start driveway camera tour at night triggers: - trigger: time at: 22:00:00 actions: - action: amcrest.start_tour target: entity_id: camera.driveway配套的停止动作amcrest.stop_tour文档见 source/_actions/amcrest.stop_tour.markdown与start_tour结构完全对称同样没有额外选项alias: Stop driveway camera tour in the morning triggers: - trigger: time at: 06:00:00 actions: - action: amcrest.stop_tour target: entity_id: camera.driveway动作目标Targets机制amcrest.start_tour必须指定目标目标即动作的作用对象。根据 source/_includes/actions/targets.md 的说明你可以把动作指向单个实体、设备、区域、楼层或标签Home Assistant 会对目标背后所有匹配的camera实体执行该动作实体Entity某个具体的camera实体如camera.driveway。设备Device某设备下的全部camera实体。区域Area某个房间或区域内的全部camera实体。楼层Floor某个楼层上的全部camera实体。标签Label共享某个标签的全部camera实体。同一动作中还可以混合多种目标类型例如同时指定一个具体实体和一个区域动作会对两者同时生效。这意味着你可以用一条amcrest.start_tour动作一次性启动整个区域所有摄像头的巡航。组合使用配套 PTZ 动作与前端控制amcrest.start_tour的关联动作共同构成了完整的 PTZ 控制体系官方文档将其列为相关动作见 source/_actions/amcrest.start_tour.markdown 的related_actions字段amcrest.goto_preset移动至预置位将摄像头移动到设备内配置的某个预置位编号从 1 开始详见 source/_actions/amcrest.goto_preset.markdownaction: amcrest.goto_preset target: entity_id: camera.driveway data: preset: 1参数说明参数是否必填类型说明preset是integer要移动到的预置位编号从 1 开始amcrest.ptz_control手动平移 / 倾斜 / 缩放对摄像头进行方向控制详见 source/_actions/amcrest.ptz_control.markdownaction: amcrest.ptz_control target: entity_id: camera.driveway data: movement: up参数说明参数是否必填类型默认值说明movement是string—移动方向取值zoom_in、zoom_out、up、down、left、right、right_up、right_down、left_up、left_downtravel_time否float0.2移动持续时长秒允许小数取值范围 0 到 1travel_time用于控制单次移动的持续时间取值越大单次移动幅度越大默认0.2秒适合做精细的方向微调。前端 picture-elements 卡片示例集成文档 source/_integrations/amcrest.markdown 提供了一整套基于picture-elements卡片的实时画面 PTZ 方向控制方案下方左侧截图即该示例的运行效果出自 IP2M-841 摄像头。卡片通过tap_action调用amcrest.ptz_control实现上下左右及斜向移动放大镜图标支持tap_action放大与hold_action长按缩小双向操作type: picture-elements entity: camera.lakehouse camera_image: camera.lakehouse camera_view: live # or auto for snapshot view elements: - type: icon icon: mdi:arrow-up style: background: rgba(255, 255, 255, 0.25) right: 25px bottom: 50px tap_action: action: perform-action perform_action: amcrest.ptz_control service_data: entity_id: camera.lakehouse movement: up - type: icon icon: mdi:magnify style: background: rgba(255, 255, 255, 0.25) bottom: 25px right: 25px tap_action: action: perform-action perform_action: amcrest.ptz_control service_data: entity_id: camera.lakehouse movement: zoom_in hold_action: action: perform-action perform_action: amcrest.ptz_control data: entity_id: camera.lakehouse movement: zoom_out在此基础上你可以把同一张卡片中的某个按钮的tap_action改为调用amcrest.start_tour例如点击“开始”图标启动巡航、长按停止- type: icon icon: mdi:play style: background: rgba(255, 255, 255, 0.25) bottom: 25px left: 25px tap_action: action: perform-action perform_action: amcrest.start_tour service_data: entity_id: camera.lakehouse hold_action: action: perform-action perform_action: amcrest.stop_tour service_data: entity_id: camera.lakehouse实践注意事项画面滞后快照或直播画面在摄像头移动后存在数秒延迟巡航启动后请耐心等待画面刷新不要误判为动作未生效。设备支持只有支持 PTZ 且已配置预置位的摄像头才能正常巡航预置位数量可通过集成的ptz_preset传感器确认0表示设备未配置预置位。联动停止巡航不会自行结束具体行为取决于摄像头固件建议在自动化中通过定时器或amcrest.stop_tour显式停止巡航避免云台长时间空转。排障渠道如动作执行异常可在社区论坛发帖附上动作调用方式与期望结果或借助 AI 助手用自然语言描述需求来确认动作名称与参数写法。参考文档索引动作定义source/_actions/amcrest.start_tour.markdown、source/_actions/amcrest.stop_tour.markdown、source/_actions/amcrest.goto_preset.markdown、source/_actions/amcrest.ptz_control.markdown集成配置source/_integrations/amcrest.markdown动作目标说明source/_includes/actions/targets.md至此你已经掌握了amcrest.start_tour从配置、调用到与 PTZ 控制体系联动的完整路径先通过configuration.yaml接入摄像头再在自动化或脚本中以实体/设备/区域/标签为目标启动巡航并配合amcrest.stop_tour、amcrest.goto_preset、amcrest.ptz_control实现定时巡航 手动微调 预置位直达的全套云台管理方案。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
