Home Assistant 解除报警指南alarm_control_panel.alarm_disarm 动作的 UI 配置、YAML 用法与自动化实战【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本指南围绕 Home Assistant 文档仓库home-assistant.io中 alarm_control_panel.alarm_disarm 动作文档 展开系统讲解解除报警这一核心动作的完整用法。读完本文你将掌握如何在可视化 UI 中配置解除报警动作、如何在 YAML 中编写可复制的解除报警调用、code参数的正确用法以及到家自动解除工作日早晨定时解除等真实自动化场景的落地写法。动作概览解除报警做了什么alarm_control_panel.alarm_disarm用于解除 Home Assistant 中任意报警控制面板alarm control panel实体的布防状态。典型场景是你结束一天工作推开家门时报警系统自动解除无需在键盘上急促输入密码。该动作有两个重要特性通用性适用于 Home Assistant 中的任意报警控制面板实体entity无论其底层接入的是何种报警系统幂等性如果报警已经处于解除状态再次调用此动作不会产生任何效果。从文档仓库的实现看该动作的定义位于 alarm_control_panel.alarm_disarm.markdown 的 front matter 中action: alarm_control_panel.alarm_disarm、domain: alarm_control_panel说明它归属于alarm_control_panel域在 UI 中对应的中文动作名为Alarm control panel: Disarm alarm。在 UI 中配置解除报警动作如果你偏好可视化搭建自动化无需编写任何 YAML。根据文档中的操作指引对应 actions/ui_header.md配置步骤如下进入设置 自动化与场景Settings Automations scenes打开一个现有的自动化或脚本或点击创建新建一个若是新建自动化先在When触发条件部分添加触发条件脚本则不需要触发条件它们由其他自动化或手动调用触发在Then do执行部分点击添加动作Add action在按目标By target下选择要控制的报警面板所在区域如门厅、玄关也可以按楼层、设备、具体实体或标签label来选择目标在动作列表中选择解除报警Disarm alarm可选如果报警面板要求输入密码在代码Code字段中填写点击保存。UI 中的选项UI 模式下的可选配置项对应 actions/ui_header.md 与文档内{% options_ui %}块只有一项选项说明是否必填代码Code用于解除报警的密码。并非所有报警面板都需要密码否在 YAML 中使用解除报警动作如果你直接编写 YAML或者想精确掌控 Home Assistant 的底层行为可以使用 YAML 方式。YAML 方式下动作标识符为alarm_control_panel.alarm_disarm参见 actions/yaml_header.md 中关于字段名、类型与必填项的说明。基础示例无密码解除报警action: alarm_control_panel.alarm_disarm target: entity_id: alarm_control_panel.home_alarm该示例直接解除alarm_control_panel.home_alarm且不携带密码。带密码解除报警如果报警面板配置了密码要求需要在data段中携带codeaction: alarm_control_panel.alarm_disarm target: entity_id: alarm_control_panel.home_alarm data: code: 1234YAML 参数参考YAML 模式下支持的参数对应文档内{% options_yaml %}块参数说明是否必填类型code用于解除报警的密码。并非所有报警面板都需要密码否string是否需要密码取决于报警面板本身及其配置部分面板始终要求密码另一些则从不要求。建议参考具体报警集成integration的文档确认密码策略。目标Targets动作的作用对象alarm_control_panel.alarm_disarm必须指定目标。根据 actions/targets.md 的说明目标是动作的作用对象你可以将动作指向单个实体、设备、区域、楼层或标签Home Assistant 会对目标背后所有匹配的alarm_control_panel实体执行该动作实体Entity某个具体的报警控制面板实体如alarm_control_panel.home_alarm设备Device属于某台设备的全部报警控制面板实体区域Area某个房间或区域内的全部报警控制面板实体楼层Floor某个楼层上的全部报警控制面板实体标签Label共享同一标签的全部报警控制面板实体。你还可以在同一次动作中混用多种目标类型例如同时指定一个具体实体和一个区域让动作对两者一并生效。实战示例三个真实场景以下示例均来自 alarm_control_panel.alarm_disarm.markdown 的 More examples 部分可直接复制并适配你的环境。场景一带密码解除报警适用于仪表盘快捷按钮或脚本在仪表盘上放置一个快捷操作或从脚本中调用使用 PIN 码解除家庭报警action: alarm_control_panel.alarm_disarm target: entity_id: alarm_control_panel.home_alarm data: code: 1234场景二到家自动解除报警当你开车驶入车道、手机上报位置为 home 时自动解除报警避免在警报响起前手忙脚乱地输入密码automation: alias: Disarm alarm on arrival triggers: - trigger: state entity_id: person.paulus to: home actions: - action: alarm_control_panel.alarm_disarm target: entity_id: alarm_control_panel.home_alarm data: code: 1234要点拆解触发器person.paulus的状态变为home人物实体动作对alarm_control_panel.home_alarm执行解除报警数据携带code: 1234。场景三工作日早晨定时解除报警工作日早上 7 点自动解除报警开门不再惊动警报automation: alias: Disarm alarm on weekday mornings triggers: - trigger: time at: 07:00:00 conditions: - condition: time weekday: - mon - tue - wed - thu - fri actions: - action: alarm_control_panel.alarm_disarm target: entity_id: alarm_control_panel.home_alarm data: code: 1234要点拆解触发器每日07:00:00触发时间触发器条件限定为周一至周五mon到fri周末不会解除动作携带密码解除家庭报警。相关动作解除之后再布防解除报警后如需重新布防文档明确推荐使用同域的两个动作见 alarm_control_panel.alarm_arm_away.markdown 与 alarm_control_panel.alarm_arm_home.markdownArm alarm away离家布防离家场景下全面布防Arm alarm home居家布防人在家中时的部分布防模式。在 UI 中这两个动作与 Disarm alarm 一起出现在报警控制面板的动作列表里可组合出完整的布防—解除—再布防自动化闭环。快速试用手动测试如果你不想先写 YAML可以通过 Home Assistant 内置的开发工具立即验证此动作。根据 actions/try_it.md 的指引进入设置 工具 动作Settings Tools Actions搜索alarm_control_panel.alarm_disarm填写字段后点击执行动作Perform action即可在不编写任何 YAML 的情况下在实际实体上观察动作效果。常见疑问速查该动作适用于哪些报警面板所有 Home Assistant 中的报警控制面板实体均可使用参见文档 Good to know 部分。报警已解除时调用会怎样不会产生任何效果动作具有幂等性。何时需要提供code取决于报警面板及其配置——有的始终要求有的从不要求请以实际面板为准。解除后如何重新布防使用alarm_control_panel.alarm_arm_away或alarm_control_panel.alarm_arm_home动作。如需排查问题或交流实现方案可参考 actions/stuck.md 中社区支持的说明描述你调用的动作与预期行为以获取帮助。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考