十年匠心定制 · 商业建站与技术教学双线并行 咨询热线:400-886-1026 service@lmnt.cn
ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

Home Assistant 中 LIFX Ceiling 灯 Sky 效果(lifx.effect_sky)动作完整指南

Home Assistant 中 LIFX Ceiling 灯 Sky 效果(lifx.effect_sky)动作完整指南 Home Assistant 中 LIFX Ceiling 灯 Sky 效果lifx.effect_sky动作完整指南【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本篇技术指南围绕 Home Assistant 的lifx.effect_sky动作展开讲解如何在 LIFX Ceiling天花板灯上运行基于固件的 Sky 效果模拟日出Sunrise、日落Sunset与云朵Clouds三种天空场景并给出 UI 与 YAML 两种完整配置方式、全部参数的取值范围与默认值、以及六色自定义调色板的确切含义。读完本文你将掌握在自动化与脚本中精确调度 LIFX 硬件级动态光效的完整方法。Sky 效果是什么lifx.effect_sky是 Home Assistant 中 LIFX 平台提供的一个专用动作用于运行基于固件的 Sky 效果让设备在整个灯面上动画呈现天空场景。它有三个关键特性依据 lifx.effect_sky 动作文档硬件级效果效果在设备固件内部运行不依赖 Home Assistant 持续下发指令仅限 LIFX Ceiling 灯这是唯一支持 Sky 效果的 LIFX 设备型号内置三种天空类型Sunrise日出、Sunset日落、Clouds云朵每种类型的默认值与调色板都与 LIFX 官方智能手机 App 保持一致。从 LIFX 集成文档 的「Hardware effects」一节可以确认Flamelifx.effect_flame、Morphlifx.effect_morph、Skylifx.effect_sky与 Movelifx.effect_move均为硬件效果其中 Flame 和 Morph 可用于 LIFX Tile、Candle、Path、Spot 与 Ceiling而Sky 效果只存在于 Ceiling上Move 效果则要求 LIFX Z、Lightstrip、Beam、Neon 或 String。如果你的实体不是 Ceiling 灯动作将无法生效。电源行为的两个要点默认情况下效果启动时灯会被打开将power_on选项关闭false可以让原本处于关闭状态的灯保持关闭、不被点亮。另外硬件效果可以在设备任何电源状态下被启动或停止但各硬件效果动作的默认行为都是「启动时先打开设备」这一点在 LIFX 集成文档 中有明确说明。在 UI 中配置并运行 Sky 效果要在自动化或脚本中运行 Sky 效果按以下步骤在 Home Assistant 界面中操作源自 lifx.effect_sky 动作文档进入设置自动化与场景Automations scenes打开一个已有的自动化或脚本或选择创建自动化创建新自动化如果是新建自动化在When何时区域添加一个触发器脚本不需要触发器它们由其他对象调用时执行在Then do然后执行区域选择添加动作Add action在By target按目标见下文 动作的目标下选择你想要动画的 LIFX Ceiling 灯在该目标显示的动作列表中选择Sky effect填写你想要使用的选项选择保存Save。UI 中的选项选项说明Speed速度对于 Sunrise 和 Sunset 天空类型指效果完成所需的时间秒对于 Clouds 类型指云朵在设备上移动的速度取值范围 1 到 86400Sky type天空类型要动画的天空风格可选Clouds、Sunrise或SunsetCloud saturation minimum云朵饱和度下限Clouds 天空类型的云朵最小饱和度0 到 255Cloud saturation maximum云朵饱和度上限Clouds 天空类型的云朵最大饱和度0 到 255Palette调色板最多 6 种颜色的列表每种颜色由色相0–360、饱和度0–100、亮度0–100与色温 Kelvin1500–9000定义Power on启动时打开关闭此项可避免效果启动前将已关闭的灯打开在 YAML 中使用 lifx.effect_sky在 YAML自动化actions或脚本sequence中该动作以lifx.effect_sky引用。基础示例如下源自 lifx.effect_sky 动作文档action: lifx.effect_sky target: entity_id: light.lifx_ceiling data: sky_type: Sunrise speed: 600上面这段配置会在 LIFX Ceiling 灯上运行一次持续 5 分钟600 秒的日出动画。YAML 选项完整参数表参数类型必填默认值说明speedinteger否50对于 Sunrise 与 Sunset 类型指效果完成所需时间秒对于 Clouds 类型指云朵移动速度1 到 86400sky_typestring否Clouds天空动画风格Clouds、Sunrise或Sunset之一cloud_saturation_mininteger否50Clouds 类型的云朵最小饱和度0 到 255cloud_saturation_maxinteger否180Clouds 类型的云朵最大饱和度0 到 255palettelist否—最多 6 种颜色每种颜色由 hue0–360、saturation0–100、brightness0–100、kelvin1500–9000定义power_onboolean否true设为false可保持已关闭的灯在效果启动前不被打开一个完整的自动化示例将 Sky 效果与触发器结合可以实现「清晨自动日出」。下面的示例基于 LIFX 集成文档 中「软件效果可用light.turn_on的effect属性启动但完全控制效果必须使用专用动作」的说明编写automation: - alias: Morning sunrise on ceiling light triggers: - trigger: time at: 06:30:00 actions: - action: lifx.effect_sky target: entity_id: light.lifx_ceiling data: sky_type: Sunrise speed: 1800 power_on: true该自动化每天 6:30 在 Ceiling 灯上启动一次持续 30 分钟的日出动画。调色板六种颜色的顺序与含义调色板palette在三种天空类型之间共享。如果要使用自定义调色板必须按以下顺序提供全部六种颜色源自 lifx.effect_sky 动作文档 的「Good to know」一节Sky天空Clouds 类型中作为背景的天空颜色Night sky夜空Sunrise 与 Sunset 类型中太阳不可见时的起始或结束天空颜色Dawn sky晨曦天空太阳刚刚出现时天空的颜色Dawn sun晨曦太阳太阳刚刚出现时的颜色Full sun满日太阳覆盖整个灯面时的颜色Final sun终末太阳效果结束时满日的颜色。每种颜色都需要按hue0–360、saturation0–100、brightness0–100、kelvin1500–9000四个分量给出且列表最多 6 项。data: sky_type: Clouds palette: - [200, 100, 50, 6500] # Sky - [240, 60, 10, 9000] # Night sky - [30, 80, 60, 4000] # Dawn sky - [20, 100, 100, 3500] # Dawn sun - [45, 100, 100, 3000] # Full sun - [25, 100, 80, 2800] # Final sun提示如果只想使用某一种天空类型的默认外观不传palette即可——默认调色板与 LIFX App 中对应效果完全一致。动作的目标Targetslifx.effect_sky必须指定目标target目标是动作的作用对象。你可以将动作指向单个实体、设备、区域、楼层或标签Home Assistant 会对该目标背后的每一个匹配 light 实体执行动作依据 targets 说明实体Entity一个特定的 light 实体例如light.lifx_ceiling设备Device属于某设备的全部 light 实体区域Area某个房间/区域内的全部 light 实体楼层Floor某个楼层上的全部 light 实体标签Label共享某个标签的全部 light 实体。同一个动作中可以混合选择多种目标类型例如同时指定一个实体和一个区域。快速调试Try it yourself想在不写任何 YAML 的情况下先验证效果可打开设置工具Actions搜索lifx.effect_sky填写字段后点击执行动作Perform action即可在真实实体上立即看到效果依据 try_it 说明。这非常适合在编写自动化前先确定合适的speed与sky_type组合。相关动作与联动场景lifx.effect_sky的关联动作包括见 related 说明lifx.effect_morph运行基于固件的 Morph 效果同样适用于 Ceiling 灯lifx.effect_stop停止目标 LIFX 灯上正在运行的任何软件或硬件效果。在实际场景中Sky 效果常与lifx.effect_stop配合使用——例如在日出动画结束后切换到日常照明或在需要安静环境时中止正在运行的云朵动画。另外如果你更习惯通过light.turn_on的effect属性如lifx_effect_pulse启动效果需要注意那只能以默认选项启动效果要对 Sky 效果的天空类型、速度与调色板做完整控制必须使用本动作依据 LIFX 集成文档。版本与文档说明本文档属于 Home Assistant 动作参考体系source/_actions/目录下每个动作对应一个文件lifx.effect_sky的权威说明位于 source/_actions/lifx.effect_sky.markdown该动作描述的细节在 Home Assistant 2025.4 版本周期中曾获改进见 core-2025.4 变更日志 中「Improve descriptions oflifx.effect_skyaction」条目建议保持 Home Assistant 与 LIFX 固件更新到较新版本以获得最准确的行为效果能否生效取决于设备型号Sky 效果仅适用于 LIFX Ceiling 灯使用前请先确认你的硬件型号依据 LIFX 集成文档。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表