Home Assistant 报警控制面板自定义旁路布防alarm_control_panel.alarm_arm_custom_bypass实战指南【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io导读本文聚焦 Home Assistant 中Arm alarm with custom bypass带自定义旁路布防这一报警控制面板操作action讲解如何在自动化automation、脚本script与仪表盘dashboard中使用它实现只跳过指定防区、其余区域照常布防的灵活安防方案。读完本文你将掌握该 action 的 UI 可视化配置与 YAML 完整写法、code参数的适用场景、Targets 目标选择机制并得到可直接套用的真实自动化示例。该文档对应的完整源码位于 source/_actions/alarm_control_panel.alarm_arm_custom_bypass.markdown底层实体行为可在 alarm_control_panel 集成文档 中交叉印证。这个 action 解决什么问题Arm alarm with custom bypass会在布防报警系统的同时允许你跳过bypass特定的防区zone。直观地说你离家时希望整栋房子处于布防状态但狗门所在防区保持开放以便宠物进出或者某个窗户你想开着通风那就把这个窗户对应的传感器防区跳过其余门窗照常受监控。该 action 适用于 Home Assistant 中所有支持自定义旁路功能的报警控制面板实体。有一个幂等行为值得注意如果报警当前已经处于带自定义旁路布防状态再次调用此 action 不会产生任何效果。对应地报警控制面板实体存在Armed custom bypass这一状态——armed with one or more zones deliberately skipped即一个或多个防区被有意跳过的布防状态参见 alarm_control_panel 集成文档。该状态与Disarmed撤防、Armed home在家布防、Armed away离家布防、Armed night夜间布防、Armed vacation度假布防、Arming布防倒计时、Pending进入延迟倒计时、Triggered已触发报警等共同构成了报警面板实体的完整状态机而Armed custom bypass是其中部分防护的独特形态。从用户界面使用该 action如果你偏好可视化构建自动化与脚本Home Assistant 会逐步引导你完成该 action 的配置——选择目标、调整选项、保存即可无需编写任何 YAML。在自动化或脚本中布防带自定义旁路的报警操作步骤如下进入Settings设置 Automations scenes自动化与场景。打开一个已有的自动化或脚本或选择Create创建新建一个。如果新建的是自动化需要在When当区域添加一个触发条件trigger。脚本则不需要触发器——它们由其他组件调用时才运行。在Then do然后执行区域选择Add action添加操作。选择你要控制的对象。在By target按目标下详见下方 Targets 说明选择报警面板所在的区域如门厅或玄关也可以选择一个楼层、一个设备、一个具体实体或一个标签。在该目标展示的操作列表中选择Arm alarm with custom bypass带自定义旁路布防。可选如果你的报警面板需要密码在Code密码中输入。选择Save保存。UI 中的选项选项说明是否必填Code用于布防报警的密码。并非所有报警面板在布防时都要求密码。否在 YAML 中使用该 action如果你直接在 YAML 中工作或者想确切了解 Home Assistant 底层做了什么本部分提供技术参考列出 YAML 中使用的字段名、类型以及哪些字段为必填项。在 YAML 中该 action 的引用名为alarm_control_panel.alarm_arm_custom_bypass。最基本的一个示例action: alarm_control_panel.alarm_arm_custom_bypass target: entity_id: alarm_control_panel.home_alarm这段配置会在不带密码的情况下以自定义旁路方式布防alarm_control_panel.home_alarm这个实体。如果你的报警面板要求密码则需要在data段中带上密码action: alarm_control_panel.alarm_arm_custom_bypass target: entity_id: alarm_control_panel.home_alarm data: code: 1234YAML 选项说明字段说明是否必填类型code用于布防报警的密码。并非所有报警面板在布防时都要求密码。否string关于密码PIN code的底层细节从 alarm_control_panel 集成文档 可以确认部分报警面板要求 PIN 码才能布防、撤防或两者兼要另一些则完全不需要。如果面板要求 PIN 而你漏填或填错action 会静默失败报警保持原有状态——这一点在自动化排错时尤其重要因为它不会产生明显的报错信息。建议按以下流程操作查阅你的报警集成文档确认布防、撤防或两者是否需要 PIN。在自动化或脚本中添加该报警 action。若需要 PIN在Data下添加code字段并填入 PIN。需要指出的是Home Assistant 本身并不定义哪些防区被跳过——具体跳过哪些防区取决于报警面板自身的配置旁路规则通常在报警面板设备端设定而非在 Home Assistant 中配置。因此本文示例中的code: 1234仅为演示占位请替换为你自己系统的真实密码。action 的目标Targets机制该 action 必须指定目标target。目标是操作的对象你可以将 action 指向单个实体、设备、区域、楼层或标签Home Assistant 会对该目标背后所有匹配的alarm_control_panel实体执行该操作实体Entity某个具体的报警控制面板实体如alarm_control_panel.living_room。设备Device某个设备下所属的全部报警控制面板实体。区域Area某个房间或区域内的全部报警控制面板实体。楼层Floor某个楼层上的全部报警控制面板实体。标签Label共享某个标签的全部报警控制面板实体。你还可以在同一个 action 中混用不同类型的目标例如同时指定一个具体实体和一个区域这样该 action 会同时作用于两者机制说明见 source/_includes/actions/targets.md。注意事项Good to knowArm alarm with custom bypass适用于 Home Assistant 中所有支持自定义旁路的报警控制面板实体。哪些防区被旁路由报警面板决定旁路规则通常在报警面板自身配置而非 Home Assistant。是否需要密码取决于报警面板及其配置布防并不总是需要密码。若需要不跳过任何防区的完整防护请改用 Arm alarm away离家布防 或 Arm alarm home在家布防需要撤防时使用 Disarm alarm撤防。实战示例一从仪表盘一键带旁路布防在仪表盘上放置一个快捷操作quick action来布防报警同时保持某些防区开放——当你知道某扇窗开着、或狗门正在使用时非常方便Action操作Alarm control panel: Arm alarm with custom bypassTarget目标Home alarmCode密码1234对应的 YAML 示例action: alarm_control_panel.alarm_arm_custom_bypass target: entity_id: alarm_control_panel.home_alarm data: code: 1234实战示例二有人离家但窗户未关时自动带旁路布防如果你出门时发现某扇窗户还开着与其完全放弃布防不如带旁路布防——让整栋房子其余部分继续受保护。自动化思路如下Trigger触发Person: Paulus changes to not_homePaulus 的状态变为离家Condition条件Window sensor is open窗户传感器为开启状态Action操作Alarm control panel: Arm alarm with custom bypassTarget目标Home alarm完整 YAML 自动化示例automation: alias: Arm with bypass when window open triggers: - trigger: state entity_id: person.paulus to: not_home conditions: - condition: state entity_id: binary_sensor.living_room_window state: on actions: - action: alarm_control_panel.alarm_arm_custom_bypass target: entity_id: alarm_control_panel.home_alarm data: code: 1234该示例完整展示了状态触发person 实体变为not_home 状态条件窗户传感器为on 带数据参数的操作这一 Home Assistant 自动化三段式结构可作为同类型条件性布防自动化的模板。亲自验证Try it yourself想快速验证该 action 的效果打开Settings设置 Tools工具 Actions操作搜索该 action填写字段后选择Perform action执行操作。这样你可以在不写一行 YAML 的情况下直接观察该操作对真实实体的影响入口说明见 source/_includes/actions/try_it.md。相关操作Related actions这些操作常与本文所述 action 搭配使用Disarm alarm撤防撤防报警控制面板。回家时使用。Arm alarm away离家布防无人在家时的全区域布防不跳过任何防区。排障建议如果带旁路布防没有按预期生效按以下顺序排查确认面板支持该 action 只对支持自定义旁路的报警面板生效确认实体当前可用的布防模式Home Assistant 只展示硬件支持的模式参见 alarm_control_panel 集成文档 的状态说明。确认 PIN 是否必要查阅报警集成文档确认布防是否需要 PIN需要却未提供时action 会静默失败且报警状态不变。确认旁路规则来源跳过哪些防区由报警面板自身配置决定请到面板端检查旁路设置是否符合预期。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考