Home Assistant Netatmo 离家标记动作 netatmo.set_person_away 完整使用指南【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io导读netatmo.set_person_away是 Home Assistant Netatmo 集成提供的官方动作action用于将指定人员标记为离家状态适用于 Netatmo IndoorWelcome室内摄像头。阅读本文后你将掌握该动作在 UI 与 YAML 两种方式下的完整配置方法、person参数的边界行为、目标target选择规则以及它与netatmo.set_persons_home、netatmo.set_camera_light等相关动作的配合方式从而在自动化与脚本中实现基于人员在场状态的家庭安防联动。动作定位面向 Netatmo Indoor 摄像头的人员在场管理在 Home Assistant 中Netatmo 集成通过官方文档source/_integrations/netatmo.markdown接入 Netatmo 云服务支持天气站、室内外摄像头、可视门铃、恒温器等设备其ha_domain为netatmoha_integration_type为hub。netatmo.set_person_away动作正是围绕Netatmo Smart IndoorWelcome摄像头的人脸识别与在场状态能力设计的摄像头识别人脸后会维护一个谁在家、谁不在家的人员名单该动作允许你通过 Home Assistant 主动把某个人标记为离家。该动作在仓库中的定义位于 source/_actions/netatmo.set_person_away.markdown其 front matter 声明了两个关联动作netatmo.set_person_away将某人标记为离家本文主题netatmo.set_persons_home将一人或多人标记为在家见 source/_actions/netatmo.set_persons_home.markdownnetatmo.set_camera_light设置室外摄像头探照灯模式见 source/_actions/netatmo.set_camera_light.markdown。三者共同构成了 Netatmo 摄像头人员在场 灯光联动的自动化基础能力。使用场景自动离家联动检测到全家离家如门锁状态变化时将室内摄像头的人员全部标记为离家配合摄像头事件触发更精准的安防判断人员名单同步家庭成员离开后手动或通过自动化同步更新 Netatmo 摄像头的人员在场状态避免误报有人在家回家迎接配合netatmo.set_persons_home在成员回家时将其标记为在家并触发欢迎灯光、空调等场景。通过 UI 添加动作Automations scenes在自动化或脚本编辑器中添加该动作的完整步骤如下与文档中actions/ui_header.md模板一致进入SettingsAutomations scenes打开现有自动化或脚本或选择Create automationCreate new automation若是新建自动化在When区域添加触发条件trigger脚本无需触发器脚本在被其他对象调用时运行在Then do区域选择Add action选择要控制的对象在By target目标选择见下文目标Targets选择下选择要控制的 Netatmo Indoor 摄像头从该目标可用的动作中选择Set person away可选填写要标记为离家的Person名称。留空则会将整个家标记为空即全员离家选择Save保存。UI 中的参数UI 中的唯一可选参数如下参数说明是否必填Person要标记为离家的人员姓名必须与摄像头已识别/已知的人员完全匹配留空则将整个家标记为空否可选通过 YAML 调用动作在 YAML 中动作名为netatmo.set_person_away。基础示例如下来自 source/_actions/netatmo.set_person_away.markdown 的example块action: netatmo.set_person_away target: entity_id: camera.living_room data: person: Bob该示例将Bob标记为camera.living_room的离家状态。在自动化中完整写法如下automation: - alias: Mark Bob as away when the front door locks triggers: - trigger: state entity_id: lock.front_door to: locked actions: - action: netatmo.set_person_away target: entity_id: camera.living_room data: person: Bob说明若你的 Home Assistant 版本中data下的参数名采用下划线风格也可写作person: Bob本文档定义的参数即为person以本仓库 source/_actions/netatmo.set_person_away.markdown 为准。YAML 参数详解根据文档中的options_yaml定义参数类型是否必填说明personstring否要标记为离家的人员姓名必须与摄像头已知人员匹配省略该参数则将整个家标记为空不提供 person 时的行为整屋标记为空文档Good to know部分明确强调了一个关键边界行为如果person留空则整个家会被标记为空全员离家而不是只将单个人员标记为离家。这意味着单人参离家必须传入与摄像头人脸库完全匹配的姓名全员离家直接省略person字段即可适合最后一人离开后触发全家离家场景。目标Targets选择该动作必须指定目标。目标即动作作用的对象可以指向实体、设备、区域、楼层或标签Home Assistant 会对目标背后的所有 Netatmo 实体执行该动作参见仓库模板 source/_includes/actions/targets.md实体Entity单个具体实体如camera.living_room设备Device某设备下的全部 Netatmo 实体区域Area某房间/区域内的全部 Netatmo 实体楼层Floor某楼层上的全部 Netatmo 实体标签Label共享某标签的全部 Netatmo 实体。同一动作中可以混用不同类型的多个目标例如同时添加一个具体实体和一个区域动作会对两者都执行。立即测试开发者工具无需编写任何 YAML 即可验证动作效果进入SettingsToolsActions开发者工具搜索netatmo.set_person_away填写字段后选择Perform action即可在真实实体上观察结果参见 source/_includes/actions/try_it.md。常见问题排查姓名不匹配person名称必须与摄像头已知人员完全一致。人员需要在 Netatmo App 中添加并命名参见netatmo.set_persons_home文档中的说明。动作不可见/无目标可选请确认当前 Home Assistant 实例已通过SettingsDevices services完成 Netatmo 集成配置ha_config_flow: true并已添加 Indoor 摄像头实体。事件联动若希望基于摄像头人员识别事件自动更新在场状态可结合netatmo_eventWebhook 事件或设备触发器Detected a person、Detected a person has left 等再调用本动作或netatmo.set_persons_home形成闭环。与相关动作的组合实战将set_person_away与set_persons_home搭配即可实现离家/回家双向状态同步# 回家将 Alice、Bob 标记为在家 action: netatmo.set_persons_home target: entity_id: camera.living_room data: persons: - Alice - Bob# 离家不传 person将整个家标记为空 action: netatmo.set_person_away target: entity_id: camera.living_room两者的target结构完全一致唯一差异是参数set_persons_home使用必填的persons列表类型list而set_person_away使用可选的person字符串。若配合netatmo.set_camera_light在夜间运动检测时开启室外探照灯见 source/_actions/netatmo.set_camera_light.markdown即可构建一套完整的人在家状态 室外灯光安防联动体系。总结netatmo.set_person_away是 Netatmo 室内摄像头人员在场管理的核心动作单个person参数即可精确标记某人离家省略参数则整屋标记为空。掌握 UI 与 YAML 两种配置方式、目标选择规则以及与之配对的set_persons_home你就能把 Netatmo 的人脸识别能力深度整合进自己的安防与智能场景自动化中。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考