Home Assistant 实战input_button.reload 动作详解——不重启即可重载 YAML 中的按钮辅助组件【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本篇技术指南聚焦 Home Assistant 文档站 source/_actions/input_button.reload.markdown 所定义的input_button.reload动作。它用于在修改configuration.yaml中配置的 input button 辅助组件Helper后无需重启 Home Assistant 即可让改动即时生效。读完本文你将掌握该动作的适用场景、UI 与 YAML 两种调用方式、其不支持目标、无附加选项、仅限管理员等关键约束并理解它与input_button.press动作及button.pressed触发器的协同关系。一、input_button.reload 是什么input_button.reload是一个由input_button域提供的动作action其官方描述为Reloads the input button helpers from the YAML configuration.即从 YAML 配置中重新加载 input button 辅助组件。它解决的核心痛点是当你在configuration.yaml中修改或新增了input_button:条目后不必重启整个 Home Assistant只需调用一次input_button.reload新的配置即可被重新读取并生效。值得注意的是该动作只作用于通过 YAML 配置的辅助组件。通过 UISettings Devices services Helpers创建的辅助组件不受该动作影响——UI 创建的辅助组件本就无需重载。前置知识input_button 辅助组件本身要理解 reload 的意义需要先了解被加载的对象。依据 input_button 集成文档Input button是一种按钮型辅助组件一个可以按下的实体但不存储开/关这样的状态。它不绑定任何物理设备因此非常适合从用户界面触发某个动作——例如按铃铛、重新启动某个例程、给自己发一条通知等。在configuration.yaml中它的配置结构如下完整示例来自 input_button 集成文档# Example configuration.yaml entry input_button: ring_bell: name: Ring bell icon: mdi:bell配置项说明配置键类型必填说明input_buttonmap是输入项的别名允许配置多个条目namestring否输入的友好名称iconicon否前端界面中显示在输入元素前的图标当你修改了上述name、icon或新增/删除了某个条目后input_button.reload就是让这些变更不重启就生效的入口。二、何时需要执行 reload一个完整的工作流input_button.reload的典型使用闭环如下在configuration.yaml中编辑input_button:配置新增、删除或修改按钮条目调用input_button.reload动作让新配置被重新读取新按钮实体即可在仪表盘、自动化中被引用。需要特别指出每次修改 YAML 中的input_button:配置后都应执行一次 reload官方文档明确建议——在修改 YAML 配置中的 input button 辅助组件后运行此动作使更改无需重启即可生效。一个值得注意的边界如果按钮辅助组件的入口即input_button:集成本身缺失则需要依赖default_config:或手动添加input_button:到configuration.yaml并重启后辅助组件功能才会可用——这是集成加载层面的问题不属于 reload 动作的管辖范围。三、从 UI 调用自动化与脚本中的配置步骤input_button.reload与所有动作一样既可以从 UI 可视化配置也可以直接书写 YAML。先看 UI 方式官方给出的步骤为进入Settings Automations scenes打开一个现有的自动化或脚本或者选择Create automationCreate new automation如果正在创建新的自动化需要在When部分添加一个触发器脚本则不需要触发器脚本在被其他内容调用时才运行在Then do部分选择Add action在搜索框中搜索并选择Input button: Reload input buttons选择Save。整个过程无需任何 YAML 知识Home Assistant 会一步步引导你完成目标选择与选项设置。UI 中的选项官方文档明确说明该动作在 UI 中没有额外的选项This action has no additional options in the UI.。四、YAML 调用方式与参数参考对于习惯直接编写 YAML、或希望精确了解底层字段名的用户官方提供了技术参考。YAML 中该动作的名称为input_button.reload基本示例源自 source/_actions/input_button.reload.markdownaction: input_button.reload在完整自动化中的典型用法automation: - alias: Reload input buttons on config change triggers: - trigger: homeassistant event: start actions: - action: input_button.reload这个示例会从你的 YAML 配置中重新加载 input button 辅助组件。YAML 中的选项与 UI 一致该动作在 YAML 中同样没有任何附加选项This action has no additional options in YAML.。它不接受任何参数是一个无参数、无目标的全局动作。五、关于 Targets目标的重要说明与input_button.press这类需要指定目标实体的动作不同input_button.reload不支持目标targets。这一点在官方文档中被明确强调This action does not support targets. In the UI, you are not prompted to choose an area, device, entity, or label.也就是说在 UI 中调用它时你不会被提示选择区域、设备、实体或标签。原因很直观reload 是一个针对YAML 配置的整体操作而非针对某个具体实体实例的操作——它重新加载的是configuration.yaml中input_button:下定义的全部条目。作为对比同域下的 input_button.press 动作 则支持完整的目标机制实体、设备、区域、楼层、标签因为它要对具体按钮实体执行按下操作。二者一个面向配置、一个面向实例职责完全不同。六、Good to know必须记住的两个约束官方文档在Good to know部分给出了两条关键提示修改 YAML 配置后应运行此动作在更改configuration.yaml中的 input button 辅助组件后运行input_button.reload改动即可生效无需重启。仅限管理员只有管理员administrators可以运行此动作。第二条约束符合 Home Assistant 的权限模型——重载配置属于系统级操作普通用户不应具备执行能力以避免非授权修改影响全局配置。七、配套联动press 动作与 button.pressed 触发器input_button.reload的文档中声明了关联动作input_button.press。理解这个联动关系才能完整发挥按钮辅助组件的价值input_button.reload把 YAML 中新配置的按钮实体加载进系统本篇文章主题input_button.press按下某个按钮辅助组件。按下动作会更新该按钮的时间戳并触发状态变化自动化可以据此响应。其 YAML 写法为action: input_button.press target: entity_id: input_button.my_buttonbutton.pressed触发器根据 button.pressed 触发器文档它同时支持设备提供的 button 实体和自建的 input_button 辅助组件。典型自动化示例如下源自 input_button 集成文档triggers: - trigger: button.pressed target: entity_id: input_button.my_button actions: - action: notify.frenck data: message: My button has been pressed!三者组合起来就能实现YAML 定义按钮 → reload 加载 → 仪表盘按下 → 自动化触发响应的完整链路。注意button.pressed触发器的两个细节unavailable或unknown的状态变化不视为按钮按下若只是需要在自动化中按一下按钮而不关心其响应则应使用input_button.press动作而非该触发器。八、小结与实操建议input_button.reload是一个极简但实用的系统级动作无参数、无目标、无附加选项唯一的职责就是把configuration.yaml中input_button:配置的辅助组件重新加载让 YAML 改动免重启生效。其文档对应仓库路径为 source/_actions/input_button.reload.markdown被加载对象的配置方式详见 input_button 集成文档。实操建议归纳如下每次修改configuration.yaml中的input_button:条目后执行一次input_button.reload该动作仅影响 YAML 配置的辅助组件UI 创建的辅助组件无需也不会被它重载调用该动作需管理员权限若要在调试时快速验证可在Settings Tools Actions中搜索input_button.reload并直接Perform action如需从自动化中按按钮或监听按钮被按下请分别配合input_button.press动作与button.pressed触发器使用。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考