Home Assistant 中 Snooz 白噪音机关闭过渡（transition_off）动作完整指南-北京尧图网络

Home Assistant 中 Snooz 白噪音机关闭过渡transition_off动作完整指南【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io导读snooz.transition_off是 Home Assistant 为 SNOOZ 白噪音机提供的专用动作action用于在指定时间内将设备音量从当前值平滑渐降fade down到最低音量然后自动关机。它特别适合早晨醒来后让白噪音缓缓消失这类需要柔和收尾的场景也是睡眠自动化中最常与snooz.transition_on开机渐入配对使用的一对动作。读完本文你将掌握该动作在 UI 可视化编辑与 YAML 两种方式下的完整用法、参数语义、目标Target机制以及一个可直接落地的早晨渐弱白噪音自动化实例。本文以 Home Assistant 官方文档仓库 home-assistant.io 中的 source/_actions/snooz.transition_off.markdown 为骨架并结合同仓库中的 SNOOZ 集成文档 source/_integrations/snooz.markdown 与动作文档所引用的公共模板source/_includes/actions展开讲解。动作概述什么是 transition offUse this action to fade a Snooz white noise machine down to its lowest volume over time and then turn it off.transition_off的核心行为是把 SNOOZ 设备的音量在一段可配置的时间内逐渐降低到最低值然后再关闭设备。这与直接执行turn_off瞬间关机形成了鲜明对比——前者让声音缓缓消散而不是戛然而止从而避免用户在睡意未消时被突然的静音惊醒。在 snooz.transition_off.markdown 的 front matter 中该动作被定义为action:snooz.transition_offdomain:snoozdescription: Gradually lowers a Snooz devices volume, then turns it off.它声明的关联动作是snooz.transition_onsource/_actions/snooz.transition_on.markdown两者共同构成睡前渐入、醒后渐出的完整睡眠白噪音体验闭环。背景SNOOZ 设备在 Home Assistant 中的集成方式理解该动作前有必要先了解 SNOOZ 在 Home Assistant 中的设备模型。根据 source/_integrations/snooz.markdownSNOOZ 集成属于Fan风扇平台设备通过Bluetooth蓝牙自动发现ha_bluetooth: trueha_iot_class: Local Push启用 Home Assistant 的 Bluetooth 集成后即可被发现无需手动添加。设备被暴露为Fan 实体并保持与设备的持久连接风扇速度百分比fan speed percentage直接映射为设备的音量等级。因此transition_off中的音量在实体层面实际作用于风扇速度百分比。集成文档特别指出小于 10 的速度百分比无效都会被映射为设备上的 1。也就是说渐降过程的最低音量在设备端对应值为 1而非 0。从 front matter 看该集成于 2022.11 版本发布ha_release: 2022.11类型为 device 集成支持配置流ha_config_flow: true代码维护者为AustinBrunkhorst。正因为设备以 Fan 实体呈现transition_off的目标target选择也会限定在fan域实体上参见 source/_includes/actions/targets.md 中include.domainfan的引用方式。方式一通过 UI 可视化配置如果你倾向于在界面中可视化地搭建自动化与脚本source/_includes/actions/ui_header.md 说明 Home Assistant 会引导你逐步完成动作配置——选择目标、调整选项、保存全程无需编写 YAML。官方文档给出的 UI 操作步骤如下进入Settings设置 Automations scenes自动化与场景。打开现有的自动化或脚本或选择Create automation创建自动化 Create new automation创建新自动化。如果是新建自动化在When何时部分添加一个触发器脚本script不需要触发器——它们在被其他东西调用时运行。在Then do然后执行部分选择Add action添加动作。选择要控制的对象。在By target按目标下详见下文动作的目标选择要控制的区域area、楼层floor、设备device、标签label或实体entity。在针对该目标显示的动作列表中选择Transition off。按需设置Transition duration过渡时长。点击Save保存。UI 中的选项选项说明Transition duration从当前音量渐降到最低音量后关机所需的时间取值范围 1300 秒默认值为20 秒。方式二在 YAML 中使用如果你直接编写 YAML或者想精确了解 Home Assistant 底层做了什么source/_includes/actions/yaml_header.md 指出该部分是技术参考列出 YAML 字段名、类型以及哪些字段必填。在 YAML 中该动作的名称就是snooz.transition_off。官方文档给出的最基础示例action: snooz.transition_off target: entity_id: fan.snooz_bedroom data: duration: 120这个例子将fan.snooz_bedroom在 120 秒两分钟内渐降到最低音量然后关闭设备。YAML 参数详解字段类型必填默认值说明durationinteger否20渐降到最低音量后关机所需的时间取值范围 1300 秒。需要特别注意的是duration的取值下限是 1因此无法用 0 实现瞬间淡出——如果需要立即关闭应改用通用的fan.turn_off或实体关闭动作可参考仓库中的 fan.turn_off。该动作必须指定 target见下文动作的目标且 target 解析后应落在fan域实体上。与snooz.transition_on不同transition_off没有volume参数——它总是渐降到最低音量后关机transition_on才有可选的volume目标音量1100%参数参见 snooz.transition_on.markdown。动作的目标Targetstransition_off要求指定目标。根据 source/_includes/actions/targets.md目标就是动作的作用对象你可以将动作指向单个实体、设备、区域、楼层或标签Home Assistant 会对该目标下每一个匹配的fan域实体执行动作实体Entity某一个具体的fan域实体如fan.living_room。设备Device属于某台设备的每一个fan域实体。区域Area某个房间/区域中的每一个fan域实体。楼层Floor某个楼层上的每一个fan域实体。标签Label共享某个标签的每一个fan域实体。你还可以在同一次动作中混合不同类型的多个目标例如同时指定一个具体实体和一个区域让动作对两者同时生效。当 SNOOZ 设备以 Fan 实体暴露参见 source/_integrations/snooz.markdown 的 Platforms 部分且目标为设备/区域/楼层/标签时实际执行的就是目标所辖范围内所有 SNOOZ Fan 实体。值得知道的细节Good to know官方文档特别提醒了一个容易被忽略的行为Once the transition completes and the device powers off, the volume level is restored to the value it had before the transition started. The next time you turn the device on, it returns to that volume.即当过渡完成、设备关机后音量会被恢复为过渡开始前的值。下一次打开设备时它会回到原来的音量。这意味着渐弱关机并不会重置你的常用音量设置——晚上睡前仍会从你习惯的音量开始配合transition_on渐入早晨渐弱后再次开机依然恢复原音量整个使用循环非常自然。实战示例早晨让白噪音缓缓淡出官方文档提供了一个完整的自动化示例用于在早晨唤醒时间之后温柔地让白噪音消散。场景描述触发器Trigger时间 07:00动作ActionTransition off目标TargetBedroom Snooz卧室的 SNOOZ 设备过渡时长Transition duration120 秒对应的完整 YAML来自 snooz.transition_off.markdownautomation: - alias: Fade the bedroom Snooz out in the morning triggers: - trigger: time at: 07:00:00 actions: - action: snooz.transition_off target: entity_id: fan.snooz_bedroom data: duration: 120关键点解读触发器使用trigger: time与at: 07:00:00即每天早上 7 点整触发。动作目标为fan.snooz_bedroom实体——实体 ID 需替换为你环境中 SNOOZ 实际生成的 Fan 实体 ID。duration: 120表示用 2 分钟完成从当前音量到最低音量、再到关机的完整过程避免到点突然静音的突兀感。若想构建完整的睡眠场景可参照 snooz.transition_on.markdown 中睡前渐入的对应自动化触发器 22:00、目标音量 33%、时长 120 秒与上述早晨渐出形成闭环snooz.transition_on在设备关闭时从最低音量起步上升到目标音量snooz.transition_off则反向渐降并关机。常见问题与排障文档中引用的 source/_includes/actions/stuck.md 指出遇到问题时可向 Home Assistant 社区求助但在此之前可以先自查以下几点确认集成已正确启用SNOOZ 依赖 Bluetooth 集成自动发现设备ha_bluetooth: true。如果目标里找不到 SNOOZ 实体先检查蓝牙集成是否启用、设备是否进入配对模式长按电源键约 5 秒直到所有按键开始脉冲闪烁详见 source/_integrations/snooz.markdown 的 Setup 部分。确认实体域transition_off的目标是fan域实体。若把目标指向了非 Fan 实体动作可能无法命中可用目标解析功能确认最终匹配到的实体列表。确认 duration 范围duration必须在 1300 秒之间超出范围将不合法未填写时默认 20 秒。理解音量恢复行为渐弱完成后音量会恢复为过渡开始前的值这是设计行为而非异常见上文值得知道的细节。关联动作该动作与以下动作配合使用效果最佳来自文档 front matter 的related_actions声明与 source/_includes/actions/related.md 的渲染逻辑snooz.transition_on逐渐改变 SNOOZ 设备音量至目标值设备关闭时从最低音量起步实现缓缓渐入适合睡前助眠场景。总结snooz.transition_off是 Home Assistant 中实现白噪音柔和收尾的关键动作通过 1300 秒默认 20 秒的可配置过渡时长将 SNOOZ Fan 实体的音量平滑降到最低后自动关机并且关机后自动恢复过渡前的音量保证下一次开机从习惯音量开始。它既可通过 UI 的可视化向导快速配置也可在 YAML 中直接以action: snooz.transition_offtargetduration的方式使用并支持实体、设备、区域、楼层、标签等多种目标类型。配合snooz.transition_on的渐入动作即可搭建一套完整的睡前渐入、醒后渐出的白噪音睡眠自动化。相关仓库文件索引动作文档主体source/_actions/snooz.transition_off.markdown配对动作文档source/_actions/snooz.transition_on.markdownSNOOZ 集成文档设备发现、配对、Fan 平台与音量映射source/_integrations/snooz.markdown目标Target机制模板source/_includes/actions/targets.mdUI / YAML 使用引导模板source/_includes/actions/ui_header.md、source/_includes/actions/yaml_header.md关联动作渲染模板source/_includes/actions/related.md【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

Home Assistant 中 Snooz 白噪音机关闭过渡（transition_off）动作完整指南

相关推荐

Spring Boot依赖管理：starter-parent与dependencies对比

PyWxDump：一封律师函下的微信数据库解密项目，3 步核实仓库现状

Lightdash 组织级 Limits 深度解析：查询行数与 CSV/Excel 导出单元格上限的组织级覆盖机制

更多资讯

基于BlueZ与GATT的BLE配网原理及RDK X5实操指南

图像超分算法实战：从插值到深度学习的全面对比与Python实现

Django二手房屋信息采集系统设计与实现

bcftools+vcftools VCF过滤：从原始变异到干净SNP位点集

L型3麦音源定位：TDOA物理原理与工程最优解

游戏引擎入门：Cocos 引擎如何让你 5 分钟跑通第一个跨平台项目

今日更新

AWS无服务器应用开发指南：从Lambda到SAM的架构与实践

SpringBoot+Vue人事系统实战：解决HR数据断点与事务一致性

MATLAB手写紧束缚模型计算石墨烯能带结构

本周精选

AI驱动的自动化专利分析平台技术解析

LeetCode-Go 题解：1252. Cells with Odd Values in a Matrix（奇数值单元格计数）双解法剖析

在线答疑系统Java毕设实战：Spring Boot前后端分离与状态流转

本月热门

基于YOLO的焊缝缺陷检测：从数据标注到工业部署全流程实践

分布式服务的决策记录

创业产品的首版范围

读完文章，想聊聊您的网站？