Home Assistant Verisure 动作实践用 verisure.disable_autolock 关闭智能门锁自动上锁【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本文围绕 Home Assistant 文档站仓库中的动作参考页 source/_actions/verisure.disable_autolock.markdown 展开完整介绍verisure.disable_autolock动作的作用、UI 配置步骤与 YAML 写法并结合 Verisure 集成文档source/_integrations/verisure.markdown、目标Targets机制以及相关的lock域动作帮助你把临时关闭门锁自动上锁这一能力真正落地到自动化和脚本中。1. 动作概述它到底做了什么verisure.disable_autolock是 Verisure 集成domainverisure提供的一个设备动作action其官方描述为Disables autolock on a Verisure Lockguard Smartlock.在 Verisure Lockguard 智能门锁上禁用自动上锁。原文档给出的行为语义非常关键当自动上锁autolock被关闭后门锁将保持解锁状态直到有人手动上锁或由另一个动作将其上锁When autolock is off, the lock stays unlocked until it is locked manually or by another action.。从文档 front matter 可以看到该动作的元信息字段值标题Disable autolock动作名verisure.disable_autolock所属域domainverisure描述在 Verisure Lockguard 智能门锁上禁用自动上锁关联动作verisure.enable_autolock、verisure.capture_smartcam它的直接对偶动作是 verisure.enable_autolock启用自动上锁开启后门锁会自动锁上即 the lock locks itself automatically。两者构成一对开关语义常见用法是在离家场景里 enable在允许开门/搬运物品场景里 disable事后再恢复。需要强调的是这个动作控制的是门锁的自动上锁规则本身而不是执行一次上锁/解锁。真正执行上锁/解锁用的是标准 lock 域动作例如 lock.lock 与 lock.unlock。理解这一点能避免把两者用混。2. 在用户界面UI中使用如果你偏好可视化地搭建自动化或脚本Home Assistant 会引导你一步步完成这个动作的选择全程无需编写 YAML。原文档给出的标准流程如下前往Settings Automations scenes设置 自动化与场景。打开一个已有的自动化或脚本或者选择Create automation Create new automation创建自动化 创建新自动化。如果是新建自动化在When当…时部分添加触发器脚本不需要触发器它们在被其他对象调用时运行。在Then do然后执行部分点击Add action添加动作。在搜索框中搜索并选择Verisure: Disable autolock。选择要控制的对象在By target下参见下文动作目标一节选中要更新的门锁。点击Save保存。UI 中的额外选项原文档明确说明该动作在 UI 中没有额外选项This action has no additional options in the UI.。也就是说除了指定目标哪一把锁之外没有其他可配置参数——这与它开关语义的本质一致。3. 在 YAML 中使用如果直接在 YAML 中编写自动化/脚本该动作的标识符是verisure.disable_autolock。原文档给出的基础示例如下action: | action: verisure.disable_autolock target: entity_id: lock.front_door这段配置的含义是对实体lock.front_door执行禁用自动上锁操作。动作只要求一个目标target不接收任何 data 参数。动作目标Targets of the action该动作必须指定目标。目标机制由站点公共模板 source/_includes/actions/targets.md 定义对lock域动作的具体规则是实体Entity某一个具体的 lock 实体如lock.living_room设备Device属于某个设备的全部 lock 实体区域Area某个房间/区域内的全部 lock 实体楼层Floor某一层楼上的全部 lock 实体标签Label共享同一个标签的全部 lock 实体。Home Assistant 会对目标背后的每一个匹配的 lock 实体执行该动作。此外同一个动作中可以混用多种目标类型——例如同时指定一个具体实体和一个区域动作会同时对两者生效。原文档示例中使用的是entity_id方式这是最精确、最推荐的写法当你家里有多把 Verisure 锁且希望一次性全部关闭自动上锁时用 area/label 目标更省事。4. 结合 Verisure 集成背景理解该动作单看动作页信息密度有限结合 source/_integrations/verisure.markdown 可以补全使用前提与上下文集成属性Verisure 是一个 hub 类型集成ha_integration_type: hub数据来自云轮询ha_iot_class: Cloud Polling支持配置流config flow与 DHCP 发现。支持的实体平台包括 alarm_control_panel、binary_sensor、camera、lock、sensor、switch、diagnostics。使用前提必须先完成 Verisure 集成的配置配置流门锁实体出现后verisure.disable_autolock才能被搜索到并执行。锁状态属性state attributeVerisure 的 lock 平台会记录锁是被什么方式锁上/打开的这对写什么时候该关闭自动上锁的自动化条件很有用method state attribute含义thumb通过内侧旋钮手动锁上/打开star通过外侧星形按钮锁上code通过外侧密码打开auto由 Verisure 规则自动锁上/打开remote由 Verisure App 自动锁上/打开从这张表可以推断auto属性对应的正是自动上锁规则生效的痕迹。当你想确认某次上锁是不是 autolock 干的、或者想在自动上锁刚触发后立刻把它关掉这个属性可以作为判断依据。已知限制集成文档指出部分用户报告该集成在法国、爱尔兰、意大利、西班牙无法正常工作的情况如果你的地区不在此列动作不可用时优先检查地区与云账号登录状态。故障排查如果调用与密码相关的操作时报The code for lock.XXX doesnt match pattern …之类的错误需要核对锁的密码位数与集成配置选项中定义的位数一致。虽然verisure.disable_autolock本身不接收密码参数但同一把锁的其他动作如带 code 的 lock.lock会受此影响排查时一并确认。5. 实战典型的自动化编排思路下面给出一个可复制的编排示例组合了本文档动作与标准 lock 域动作实现允许进入 → 完成操作 → 重新自动上锁的闭环实体 ID 请替换为你自己的automation: - alias: 搬运模式暂停门前锁的自动上锁 triggers: - trigger: event event_type: button_pressed event_data: entity_id: button.hallway_mode # 按下一枚按钮即进入搬运模式 actions: - action: verisure.disable_autolock target: entity_id: lock.front_door # 保持解锁/可控状态一段时间…… - delay: hours: 2 # 结束后恢复自动上锁对偶动作 - action: verisure.enable_autolock target: entity_id: lock.front_door这个示例中每一行都有仓库文档依据verisure.disable_autolock/verisure.enable_autolock及target.entity_id写法来自本文档与 source/_actions/verisure.enable_autolock.markdown先 disable、延时后 enable 的对称结构来自两个动作文档中相反的行为描述disable 后锁保持解锁直到手动或其他动作将其锁上enable 后锁会自动锁上如果需要关闭自动上锁的同时立即执行一次上锁/解锁请额外追加lock.lock或lock.unlock动作参见 source/_actions/lock.lock.markdown该动作还支持通过data.code传递门锁密码因为 disable 动作本身不负责改变锁的当前开合状态。另一个常见配合场景来自文档声明的关联动作 verisure.capture_smartcam在检测到门口动作后抓取 SmartCam 图像其 target 指向camera域实体例如camera.hallway再按结果决定是否verisure.disable_autolock。动作之间如何串联完全由你的自动化逻辑决定。6. 验证与调试原文档提供了两种不动手写完整自动化即可验证该动作的途径动作工具面板打开Settings Tools Actions开发者工具中的动作页搜索verisure.disable_autolock填入字段后点击Perform action。你可以在不写一行 YAML 的情况下在真实实体上观察效果。自动化调试在自动化编辑器中触发测试并在自动化的运行日志中确认动作执行成功若目标锁实体不存在或集成未登录动作会报错此时回到集成配置检查 Verisure 账号状态。相关动作速查动作作用文档位置verisure.disable_autolock关闭 Lockguard 门锁自动上锁本篇主题source/_actions/verisure.disable_autolock.markdownverisure.enable_autolock开启 Lockguard 门锁自动上锁source/_actions/verisure.enable_autolock.markdownverisure.capture_smartcam从 Verisure SmartCam 抓取新图像source/_actions/verisure.capture_smartcam.markdownlock.lock/lock.unlock标准 lock 域上锁/解锁可与本动作组合source/_actions/lock.lock.markdownVerisure 集成总览安装、平台、锁状态属性、限制与排错source/_integrations/verisure.markdown7. 要点回顾verisure.disable_autolock是一个无参数、必须指定 lock 目标的动作它改变的是门锁的自动上锁规则而不是锁当前的开合状态UI 中搜索 Verisure: Disable autolock 即可添加YAML 中写action: verisure.disable_autolock加target即可关闭 autolock 后锁会停留在解锁状态直到手动或另外的动作将其锁上——生产环境里务必设计好何时恢复 enable的收尾步骤配合 lock 实体的 method 状态属性auto/remote/thumb等与关联动作verisure.enable_autolock、verisure.capture_smartcam、lock.lock可以覆盖绝大多数临时接管门锁自动上锁的自动化需求。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考