Home Assistant 使用 verisure.enable_autolock 动作：为 Verisure Lockguard 智能锁启用自动上锁-二趣网

Home Assistant 使用 verisure.enable_autolock 动作：为 Verisure Lockguard 智能锁启用自动上锁

【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io

导读

本文围绕 Home Assistant 中verisure.enable_autolock动作展开，讲解如何在自动化与脚本中为 Verisure Lockguard Smartlock 开启自动上锁功能——开启后锁具会在关门后自动上锁。你将掌握该动作在 UI 与 YAML 两种写法下的完整调用方式、target 目标定位机制、底层 domain 依据，以及与之配套的verisure.disable_autolock、verisure.capture_smartcam等相关动作的使用场景。

动作概述与适用场景

verisure.enable_autolock是 Home Assistant 内置的 Verisure 集成提供的一个动作（action），其唯一职责是在 Verisure Lockguard Smartlock 上启用自动上锁。当自动上锁处于开启状态时，门锁会在关门后自动锁上，无需手动操作。

action 名称：verisure.enable_autolock
domain：verisure
前置条件：已通过配置流程（Config Flow）将 Verisure 集线器接入 Home Assistant，并已添加对应锁具实体（见 Verisure 集成文档）

该动作适合在以下场景使用：

离家（例如通过地理围栏触发）时确保家中门锁自动落锁；
夜间自动上锁，避免忘锁；
结合门磁传感器，在关门事件发生后确认自动上锁功能处于开启状态。

从 Verisure 集成文档的ha_platforms可以看出，该集成支持alarm_control_panel、binary_sensor、camera、lock、sensor、switch等多个平台（见 source/_integrations/verisure.markdown），而本动作针对的是其中的lock平台实体，例如lock.front_door。

在 UI 中启用自动上锁

如果你更习惯用可视化方式编排自动化或脚本，Home Assistant 会引导你一步步完成操作，无需编写 YAML：

进入Settings>Automations & scenes。
打开一个现有的自动化或脚本；或选择Create automation>Create new automation新建。
如果新建的是自动化，需要在When部分添加一个触发器；脚本则不需要触发器，它在被其他自动化或场景调用时直接运行。
在Then do部分选择Add action。
在搜索框中搜索并选择Verisure: Enable autolock。
在By target下选择你想要控制的锁具实体（target 的选择方式见下文"Targets 目标定位"）。
选择Save保存。

UI 中的选项

该动作没有额外的 UI 选项。也就是说，你只需要指定目标锁具即可完成配置，无需填写任何附加参数。

在 YAML 中调用该动作

在 YAML 中，该动作以verisure.enable_autolock引用。一个基础示例：

action: verisure.enable_autolock target: entity_id: lock.front_door

将上述代码放入自动化或脚本的actions列表中即可。以下是一个完整的自动化示例——当大门关闭时（假设门磁传感器binary_sensor.front_door_contact从开变为关），确保自动上锁开启：

automation: - alias: "Ensure autolock is enabled when front door closes" triggers: - trigger: state entity_id: binary_sensor.front_door_contact from: "on" to: "off" actions: - action: verisure.enable_autolock target: entity_id: lock.front_door

字段参考

字段	类型	是否必填	说明
`action`	string	是	固定为`verisure.enable_autolock`
`target.entity_id`	string	是	目标锁具实体的 ID，例如`lock.front_door`

除了实体 ID 之外，该动作没有其他可配置参数，功能与 UI 中的行为完全一致。

Targets 目标定位

该动作必须指定 target，target 即动作的作用对象。你可以将动作指向单个实体、设备、区域、楼层或标签，Home Assistant 会针对 target 背后每一个匹配的lock实体执行动作：

Entity（实体）：一个具体的lock实体，例如lock.front_door。
Device（设备）：属于某一设备的所有lock实体。
Area（区域）：某个房间或区域内的所有lock实体。
Floor（楼层）：某一楼层上的所有lock实体。
Label（标签）：共享某个标签的所有lock实体。

你还可以在同一个动作中混合选择不同类型的 target，例如同时添加一个具体实体和一个区域，让动作同时作用于两者。这在多锁具的家庭中非常实用：只需一个动作即可让入户门、后门等所有配置了自动上锁能力的锁具统一开启该功能。

用开发者工具快速验证

如果你不想先写自动化，可以直接在Settings>Tools>Actions（开发者工具）中搜索该动作，填写目标后点击Perform action，即可在真实实体上立即看到效果，无需编写一行 YAML。这是验证实体 ID 是否正确、集成是否正常工作的最快方式。

与 Verisure 锁具状态属性的联动

在 Verisure 集成中，lock平台通过methodstate 属性记录锁具最近一次状态变化的来源（见 source/_integrations/verisure.markdown），理解这些值有助于你为自动上锁设计更精确的自动化：

method state 属性	说明
`thumb`	通过室内拇指开关上锁/解锁
`star`	通过室外星形按钮上锁
`code`	通过室外密码解锁
`auto`	由 Verisure 规则自动上锁/解锁
`remote`	通过 Verisure App 自动上锁/解锁

例如，你可以监听lock.front_door的状态变化并读取其method属性，当检测到门锁被code方式解锁后，再调用verisure.enable_autolock确保自动上锁一直处于开启状态。

常见问题与排查

找不到该动作：确认已经完成 Verisure 集成的配置流程（Config Flow），且至少添加了一台 Lockguard Smartlock 对应的lock实体。
target 报错：确认实体 ID 前缀是lock.（如lock.front_door），并确保该实体确实属于 Verisure 集成。
密码位数报错：Verisure 集成文档的 Troubleshooting 指出，若出现类似"The code for lock.XXX doesn't match pattern^\d{0}$."的错误，需要核对锁具密码位数与配置选项中定义的一致（见 source/_integrations/verisure.markdown）。
地区限制：Verisure 集成文档列出了一些用户报告集成不可用的国家（法国、爱尔兰、意大利、西班牙），若你位于这些地区，锁具控制可能无法正常工作。
仍然卡住：Home Assistant 社区可以快速提供帮助——可以在社区论坛发布你正在调用的动作与预期行为，或描述你的需求后请 AI 助手推荐合适的动作与 YAML 写法。

小结

verisure.enable_autolock是一个零参数、目标驱动的简单动作：选定目标锁具，即可在自动化与脚本中随时开启自动上锁。它既可以单独用于"离家即锁"等场景，也常与verisure.disable_autolock实现白天/夜间的策略切换，或与verisure.capture_smartcam组成安防联动。结合 Verisure 集成提供的method状态属性，你还可以精确感知每一次上锁/解锁的来源，构建更智能的家居安防流程。

【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析