使用 lifx.paint_theme 为 LIFX 灯具绘制预设主题与自定义调色板【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本篇技术指南围绕 Home Assistant 的lifx.paint_theme动作展开讲解如何在自动化、脚本或 YAML 中将 LIFX 官方应用同款的 42 种预设主题Theme或一套 216 色的自定义调色板Palette一次性绘制到一台或多台 LIFX 灯具上。读完本文你将掌握该动作的全部配置参数、优先级规则、UI 与 YAML 两种调用方式以及它与其他 LIFX 动作如lifx.set_state、lifx.effect_move的组合用法。动作概览lifx.paint_theme是 LIFX 集成在 2025.2 版本中新增的动作见 core-2025.2 变更日志。它的作用是把一个预定义的 LIFX 主题或你自己定义的一套颜色调色板绘制到一台或多台 LIFX 灯具上。从 LIFX 集成文档 可以确认这些预设主题面向 LIFX 的矩阵灯matrix与多区灯multizone设备设计每一个都模仿 LIFX 智能手机应用中同名主题的效果。因此lifx.paint_theme特别适合在以下场景使用在节假日或特定事件万圣节、圣诞节、独立日等自动为灯具换上应景的主题通过自定义调色板把多台灯具统一绘制成一组协调的颜色形成渐变或分区效果在启动lifx.effect_move硬件动效前先为主题铺设好初始配色lifx.effect_move同样支持theme参数见 lifx.effect_move 文档。优先级规则使用该动作时颜色来源的优先级非常明确调色板优先如果你同时提供了palette和theme调色板会覆盖主题实际采用调色板绘制主题兜底如果只提供theme则使用该主题默认主题如果两者都没提供则使用exciting主题。从用户界面使用该动作如果你习惯用可视化方式构建自动化和脚本可以通过 UI 一步步完成配置进入设置自动化与场景Automations scenes打开一个已有的自动化或脚本或者选择创建自动化创建新自动化如果是新建自动化需要在When何时区域添加触发器。脚本不需要触发器它们由其他对象调用时才运行在Then do然后执行区域选择添加动作Add action在按目标By target下目标规则详见下文 动作的目标选择你要绘制的 LIFX 灯具从该目标显示的动作列表中选择绘制主题Paint theme填写你想要使用的选项选择保存Save。UI 中的选项UI 中可配置的选项如下选项说明Palette调色板要绘制到目标灯具上的 216 种颜色列表每种颜色由色相Hue0360、饱和度Saturation0100、亮度Brightness0100和色温Kelvin15009000定义。该选项会覆盖主题。Theme主题要绘制的预定义颜色主题。会被调色板覆盖。Transition过渡主题绘制到目标灯具上所用的持续时间单位为秒。Power on开机关闭该选项可以避免在绘制主题前把原本关闭的灯具强制打开。在 YAML 中使用该动作在 YAML 中该动作的名称是lifx.paint_theme。一个基础示例如下action: lifx.paint_theme target: entity_id: light.living_room data: theme: halloween transition: 2上述示例会把halloween主题在两秒内绘制到客厅灯上。YAML 参数参考参数类型必填默认值说明palettelist否—要绘制到目标灯具上的 216 种颜色列表每种颜色由色相0360、饱和度0100、亮度0100和色温15009000定义。该参数覆盖theme。themestring否exciting要绘制的预定义颜色主题会被palette覆盖。transitionfloat否—主题绘制到目标灯具上所用的时间单位为秒。power_onboolean否true设为false可以避免在绘制主题前把处于关闭状态的灯具强制打开。自定义调色板示例palette接受一个颜色列表列表中的每个元素都要完整给出 hue、saturation、brightness、kelvin 四个分量。下面的例子把一盏多区灯绘制成三组暖色渐变并在 5 秒内完成过渡action: lifx.paint_theme target: entity_id: light.lifx_z data: palette: - hue: 25 saturation: 80 brightness: 90 kelvin: 3500 - hue: 30 saturation: 70 brightness: 70 kelvin: 3200 - hue: 35 saturation: 60 brightness: 50 kelvin: 3000 transition: 5注意颜色分量与 LIFX 集成 的取值约定保持一致色相使用 0360 的角度制饱和度与亮度使用 0100 的百分比色温使用 15009000 开尔文。类似的色温参数约定也出现在其他灯具动作中例如 yeelight.set_color_temp_scene 使用 17006500K 范围但 LIFX 设备支持更宽的 15009000K。可用主题列表lifx.paint_theme支持的全部预定义主题如下与 LIFX 应用中同名主题一致autumnbias_lightingblissfulcalaverascheerfulchristmasdreamenergizingepiceveningexcitingfantasyfocusinggentlehalloweenhanukkahhollyhyggeindependenceintensekwanzaalovemellowpartypeacefulpowerfulproudpumpkinrelaxingromancesantasereneshamrocksoothingspaceysportsspringstardustthanksgivingtranquilwarmingzombie其中既有按节日划分的主题christmas、halloween、hanukkah、kwanzaa、thanksgiving、independence、shamrock、santa、pumpkin、zombie、calaveras也有按氛围划分的主题exciting、peaceful、relaxing、energizing、focusing、serene、tranquil、warming等可按需选用。动作的目标lifx.paint_theme必须指定目标target目标就是该动作的作用对象。你可以把动作指向单个实体、设备、区域、楼层或标签Home Assistant 会对目标下所有匹配的 LIFX light 实体执行该动作实体Entity一个具体的 light 实体例如light.living_room设备Device该设备拥有的所有 light 实体区域Area某个房间/区域内的所有 light 实体楼层Floor某个楼层上的所有 light 实体标签Label共享某个标签的所有 light 实体。同一动作中可以混合不同类型的多个目标例如同时指定一个具体实体和一个区域动作会同时作用于两者。实战组合主题 动效主题绘制不只是静态场景的专利还能与 LIFX 的硬件动效协同使用。以lifx.effect_move为例该动效会在多区灯LIFX Z、Lightstrip、Beam、Neon、String上移动当前颜色且其theme参数默认值同样是exciting。由于两者共享同一套主题体系你可以先绘制主题再启动动效让颜色“流动”起来action: lifx.effect_move target: entity_id: light.lifx_beam data: speed: 3 direction: left theme: christmas power_on: true如果需要绘制静态主题lifx.paint_theme是更直接的选择如果需要先在灯具上铺好配色再启动动效则可以在lifx.effect_move中直接指定theme详见 lifx.effect_move 文档。另外lifx.paint_theme的相关动作还包含 lifx.set_state后者可以在不改变电源状态的前提下调整单台灯的颜色与亮度两者结合可以实现“先备好颜色、再由传感器点亮”的场景。小结lifx.paint_theme用于把 42 种预设主题或 216 色的自定义调色板绘制到一台或多台 LIFX 灯具上颜色来源优先级为palettetheme 默认excitingtransition控制绘制过渡时长秒power_on: false可避免强制点亮关闭中的灯具目标支持实体、设备、区域、楼层、标签五种粒度且可混合使用该动作与lifx.set_state、lifx.effect_move同属 LIFX 集成动作体系可用于构建“主题铺设 动效/状态微调”的完整灯光自动化。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考