Home Assistant 中 Reolink PTZ move 动作实战：为摄像头云台控制设置自定义速度

Home Assistant 中 Reolink PTZ move 动作实战为摄像头云台控制设置自定义速度【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.ioreolink.ptz_move是 Home Assistant 官方 Reolink 集成提供的动作用于以自定义速度移动支持变速的 Reolink PTZpan-tilt-zoom平移-倾斜-变焦摄像头。本文以 reolink.ptz_move 动作文档为主体结合 Reolink 集成文档中的按钮实体机制完整讲解该动作在 UI 与 YAML 两种模式下的配置方法、Speed 参数取值以及它与 PTZ 方向按钮实体协同工作的原理。读完本文你将能在自动化或脚本中精确控制摄像头云台的转动速度并理解为什么某些摄像头不会显示该动作的目标实体。动作概览一个动作控制云台转动速度reolink.ptz_move的作用是以你选择的速度移动一台 Reolink 摄像头。它不是直接发送一次性的方向指令而是与摄像头上的PTZ left、right、up、down、zoom in、zoom out等按钮实体button 实体配合使用按钮实体决定转动方向speed参数决定转动快慢。从 Reolink 集成文档的按钮实体一节可以看到集成会按摄像头型号支持情况创建以下 PTZ 相关按钮实体PTZ stopPTZ left / PTZ right / PTZ up / PTZ downPTZ left up* / PTZ left down* / PTZ right up* / PTZ right down*带*表示默认禁用PTZ calibratePTZ zoom in* / PTZ zoom out*PTZ continuous rotation*Guard go to / Guard set current position其中PTZ left、right、up、down、left up、left down、right up、right down、zoom in、zoom out会持续朝对应方向移动摄像头直到调用PTZ stop或触达硬件限位为止。只有支持不同移动速度的摄像头型号才会在与这些方向按钮配合时启用reolink.ptz_move动作。前置条件确认你的摄像头支持自定义 PTZ 速度在配置动作之前需要先确认摄像头是否支持变速云台在自动化/脚本中为动作选择目标时如果能看到PTZ left、PTZ right、PTZ up、PTZ down、PTZ zoom in、PTZ zoom out等按钮实体说明该摄像头支持自定义 PTZ 速度reolink.ptz_move可以正常使用。如果选择目标时没有出现这些 PTZ 按钮实体则该摄像头不支持自定义 PTZ 速度此时无法使用本动作见原文档Good to know一节。此外需要先完成 Reolink 集成本身的配置主机地址、设备用户名与密码具体流程见 Reolink 集成配置文档。在 UI 中调用自动化/脚本逐步配置原文档给出了在 Home Assistant 可视化编辑器中调用该动作的完整步骤进入SettingsAutomations scenes自动化与场景。打开一个已有的自动化或脚本或者选择Create automationCreate new automation新建自动化。如果是新建自动化先在When何时区域添加一个触发器脚本scripts不需要触发器它们在被其他对象调用时运行。在Then do然后执行区域选择Add action添加动作。在By target按目标下选择要控制的 Reolink PTZ 按钮实体例如PTZ left目标的选择方式详见下文动作目标小节。从该目标可用的动作列表中选择PTZ move。输入你想要移动的Speed速度。选择Save保存。在 UI 中动作只有一个选项选项说明Speed移动速度取值范围为 1 到 64。可视化编辑器的好处是不需要掌握 YAML 语法Home Assistant 会逐步引导你完成目标选择、参数填写和保存。在 YAML 中使用动作与参数参考如果你直接编写 YAML或者想了解 Home Assistant 在底层发送了什么可以使用下面的技术参考。在 YAML 中该动作以reolink.ptz_move引用。原文档给出的基础示例action: reolink.ptz_move target: entity_id: button.trackmix_ptz_left data: speed: 10这个示例的含义是使用button.trackmix_ptz_left实体以速度10向左移动摄像头示例中的 TrackMix 型号摄像头支持变速 PTZ。YAML 选项参考选项描述是否必填类型speed移动速度取值范围为 1 到 64。是integer整数动作目标Targets该动作必须指定目标。目标就是动作的作用对象可以指向单个实体、设备、区域、楼层或标签Home Assistant 会对目标背后所有匹配的button域实体执行该动作Entity实体某一个具体的 button 实体例如button.trackmix_ptz_left。Device设备属于某台设备的所有 button 实体。Area区域某个房间/区域内的所有 button 实体。Floor楼层某个楼层上的所有 button 实体。Label标签共享某个标签的所有 button 实体。同一动作中可以混合选择多种目标类型例如同时添加一个具体实体和一个区域动作会对两者同时执行。关于目标的详细通用说明可参见 actions/targets.md 模板。与关联动作搭配使用reolink.ptz_move在文档头部声明了关联动作 reolink.play_chime。该动作用于在 Reolink Chime 设备上播放铃声例如在检测到移动时播放两者可结合用于安防联动场景PTZ move 负责转动摄像头对准目标play chime 负责声音提醒。关联动作的自动生成逻辑可见 related.md 模板。快速验证与故障排查立即尝试Try it yourself想不写一行 YAML 就验证效果打开SettingsToolsActions工具 动作搜索reolink.ptz_move填入字段后选择Perform action执行动作即可在真实实体上看到效果。UI 头部说明见 ui_header.md 模板YAML 头部说明见 yaml_header.md 模板。常见问题选择目标时看不到 PTZ 按钮实体如前文所述这说明该摄像头型号不支持自定义 PTZ 速度reolink.ptz_move无法用于该设备。PTZ 方向按钮是持续移动行为调用reolink.ptz_move并指定方向按钮后摄像头会持续转动直到调用PTZ stopreolink.ptz_move之外可配合 PTZ stop 按钮实体或到达硬件限位。默认禁用的实体需要先启用带*的按钮实体如 PTZ left up、zoom in 等默认禁用若需要作为目标请先在实体设置中启用参考 Reolink 集成文档。如果问题仍未解决可以在 Home Assistant 社区Discord、社区论坛、r/homeassistant中描述你调用的动作与预期结果获取实时帮助。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考