Home Assistant Yeelight 场景动作实战使用yeelight.set_color_scene一键还原 RGB 色彩与亮度组合【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本篇技术指南围绕 Home Assistant 官方文档仓库中的yeelight.set_color_scene动作文档 展开讲解如何通过该动作将 Yeelight 灯具一键设置为指定的 RGB 颜色与亮度并在灯处于关闭状态时自动点亮。你将掌握在 UI 与 YAML 两种方式下配置该动作的完整方法、全部参数含义、目标Targets选择机制以及它与其他 Yeelight 场景动作HSV、色温、流光的适用差异可直接用于自动化、脚本与家庭场景搭建。动作概览一条指令还原整组灯光氛围yeelight.set_color_scene是 Home Assistant Yeelight 集成提供的设备级场景动作之一。根据动作文档中的定义该动作将一台 Yeelight 灯设置为指定的 RGB 颜色与亮度如果灯当前处于关闭状态动作执行后会自动将其打开它适合用来在单一步骤中召回一组偏好的颜色与亮度组合例如作为观影movie场景或放松relax场景的一部分。与分别调用开关和调光动作相比场景类动作的价值在于原子化一条动作即可完成从颜色到亮度的完整设置无需多步编排也减少了自动化与脚本中的重复配置。它是 Home Assistant 针对 Yeelight 灯提供的多组场景动作之一与之同族的还有yeelight.set_hsv_sceneHSV 颜色、yeelight.set_color_temp_scene色温、yeelight.set_color_flow_scene流光等。前置条件确认 Yeelight 集成可用在自动化中使用该动作之前需要先确保 Yeelight 灯已通过Yeelight 集成接入 Home Assistant。相关前提可参考 Yeelight 集成文档启用局域网控制LAN Control需要先在 Yeelight App 中为灯泡开启 LAN Control旧称 Developer mode。该选项通常要求灯泡固件为最新版本固件可通过 Yeelight App 更新。确认设备在线确定灯泡的 IP 地址可通过路由器、扫描工具或 ping 等方式获取。通过配置流程添加设备该集成ha_config_flow: true支持配置流程Config Flow方式添加并同时支持 DHCP 与 Zeroconf 自动发现见集成文档的 Frontmatter 元数据。模型兼容性集成文档列出了大量经过测试的型号如color1/color2彩色灯泡、strip1灯带、ceiling*吸顶灯等不同型号的能力如色温范围可能有所差异。需要注意Yeelight 集成属于**本地推送Local Push**类ha_iot_class: Local Push动作指令直接下发到局域网内的设备无需经过云端这也是它适合作为场景底层调用的原因之一。在 UI 中配置该动作自动化与脚本根据动作文档中的操作步骤在自动化或脚本的 UI 编辑器中配置该动作的完整流程如下进入Settings设置 Automations scenes自动化与场景。打开现有的自动化或脚本如果是新建设置选择Create automation创建自动化 Create new automation创建新自动化。如果是新建自动化在When当…时区域添加一个触发器。脚本不需要触发器——脚本在被其他对象调用时才运行。在Then do然后执行区域选择Add action添加动作。选择要控制的设备。在By target按目标下详见下文选择动作目标选择要控制的 Yeelight 灯。从该目标可用的动作列表中选择Set color scene设置颜色场景。填写RGB colorRGB 颜色与Brightness亮度两个字段。选择Save保存。UI 中的选项说明选项说明是否必填RGB color要设置的颜色以红、绿、蓝三个通道值表示每个通道取值范围 0255必填Brightness要设置的亮度取值范围 1100必填这里的 RGB 颜色对应文档中的 YAML 字段rgb_color亮度对应brightness。颜色以三通道列表形式表达例如[255, 100, 0]表示偏橙的暖色调。在 YAML 中使用该动作在 YAML 中直接编写自动化或脚本时该动作以yeelight.set_color_scene引用。根据动作文档中的基础示例最简配置如下action: yeelight.set_color_scene target: entity_id: light.living_room data: rgb_color: [255, 100, 0] brightness: 80在自动化文件中的完整形态通常是alias: 观影模式 - 客厅 triggers: - trigger: state entity_id: media_player.living_room_tv to: on actions: - action: yeelight.set_color_scene target: entity_id: light.living_room data: rgb_color: [120, 20, 10] # 暗红色模拟影院氛围 brightness: 30YAML 参数说明字段类型必填说明rgb_colorlist是要设置的颜色红、绿、蓝三个通道值每个通道 0255brightnessinteger是要设置的亮度1100两个参数均为必填项。若设备处于关闭状态动作执行时会自动开启设备并应用上述颜色与亮度。选择动作目标Targetsyeelight.set_color_scene是目标型动作必须指定目标。根据动作目标说明动作文档中通过targets.md引入目标可以是以下任一种Home Assistant 会对目标背后所有匹配的 light 域实体执行动作实体Entity单个具体的 light 实体例如light.living_room设备Device属于某台设备的所有 light 实体区域Area某个房间/区域内的所有 light 实体楼层Floor某个楼层上的所有 light 实体标签Label共享某个标签的所有 light 实体。同一个动作中可以混合多种目标类型例如同时添加一个具体实体和一个区域作为目标动作会在两者上同时执行。利用区域或标签作为目标可以在放松模式这类场景中一键把客厅所有 Yeelight 灯统一设置为同一颜色与亮度而不必逐个罗列实体 ID。参数细节与取值背后的协议逻辑rgb_color的 0255 通道值这是标准 RGB 色彩空间的表示方式[255, 0, 0]为纯红、[0, 255, 0]为纯绿、[0, 0, 255]为纯蓝三个通道组合可表达 1600 万种颜色。对于彩色版 Yeelightcolor1/color2/strip1等型号均适用。brightness的 1100 百分比制注意此处亮度取值范围为 1100与 Yeelight 协议层面的百分比表示一致。这一点也可从Yeelight 集成文档的自定义效果Custom effects段落得到印证其定义的RGBTransition/HSVTransition/TemperatureTransition等转场类型中最终亮度参数均注明为 1-100 (%)。场景动作与start_flow的区别在yeelight.set_color_flow_scene动作文档与yeelight.start_flow动作文档中文档明确说明两者接受相同的转场列表但set_color_flow_scene使用scene API 调用而start_flow使用另一种 Yeelight API 调用且不同固件在处理复杂流时可能存在差异。由此可以推断set_color_scene这类场景动作同样走设备端场景命令通道以单条命令完成颜色亮度的整体设置——这是其与通用light.turn_on逐属性下发方式的关键区别之一该推断基于仓库中文档对 scene API 调用的明示具体指令名以设备协议实现为准。实战示例构建电影与放松场景示例一客厅观影场景将客厅灯调整为暗暖色低亮度模拟影院氛围action: yeelight.set_color_scene target: entity_id: light.living_room data: rgb_color: [140, 60, 20] # 暖琥珀色 brightness: 25配合media_player状态变化触发即可实现电视一开灯光自动变暗。示例二睡眠前的放松场景使用低亮度的柔和冷色配合延迟关闭类动作实现睡前助眠 自动熄灯actions: - action: yeelight.set_color_scene target: entity_id: light.bedroom data: rgb_color: [90, 130, 180] # 柔和蓝 brightness: 15 - action: yeelight.set_auto_delay_off_scene target: entity_id: light.bedroom data: minutes: 30 brightness: 15其中yeelight.set_auto_delay_off_scene是另一组相关动作详见其动作文档可让灯在指定分钟后自动关闭充当设备端内置的睡眠定时器。示例三按场景类型切换白光源若你的 Yeelight 灯支持色温控制且你需要的是白光的冷暖和明暗而非彩色应改用yeelight.set_color_temp_scene例如夜间 2700K 暖光action: yeelight.set_color_temp_scene target: entity_id: light.living_room data: kelvin: 2700 brightness: 60与其他 Yeelight 场景动作的选型对比动作核心参数适用场景yeelight.set_color_scenergb_color0-255×3、brightness1-100需要精确指定具体颜色时yeelight.set_hsv_scenehs_color色相 0-359、饱和度 0-100、brightness习惯用色相/饱和度描述颜色时yeelight.set_color_temp_scenekelvin1700-6500、brightness白色光源的冷暖调节阅读、助眠yeelight.set_color_flow_scenetransitions转场列表、count、action需要持续运行的动态流光效果yeelight.start_flow同上同一转场列表但使用不同的设备 API 调用yeelight.set_auto_delay_off_sceneminutes1-60、brightness点亮后定时自动关闭yeelight.set_modemodelast/normal/rgb/hsv/color_flow/moonlight切换月光模式等设备运行模式当追求用 RGB 精确定义一个颜色并设定亮度时yeelight.set_color_scene是直接选择需要动态效果时再升级到set_color_flow_scene。若需要自定义的转场序列如火焰闪烁效果可参考Yeelight 集成文档中Custom effects一节的转场格式RGBTransition/HSVTransition/TemperatureTransition/SleepTransition在yeelight:的 YAML 配置中预定义效果后配合light.turn_on使用。快速验证与问题排查无需写 YAML 即可试跑进入Settings设置 Tools工具 Actions动作搜索yeelight.set_color_scene填写字段后点击Perform action执行动作即可在真实设备上立即验证效果对应仓库中的try_it.md提示。动作未生效时优先检查前置条件——灯泡是否已开启 LAN Control、固件是否最新、设备 IP 是否可达参见Yeelight 集成文档中的 Initial setup 与 Troubleshooting 章节。设备发现异常Yeelight 设备使用非标准参数的 SSDP 搜索因此不会出现在 SSDP/UPnP 浏览器中可改用Zeroconf 浏览器或DHCP 浏览器确认设备是否被发现。如需手动探测局域网内的 Yeelight 灯泡可参考集成文档中给出的upnp-client search命令参数--target 239.255.255.250、--target_port 1982、--search_target wifi_bulb。关于音乐模式Music mode如果为设备开启了use_music_mode需要注意音乐模式下的灯泡在断开时可能不会更新为 unavailable 状态且首次指令可能无响应此时可在前端将灯关闭再重新打开以恢复。该行为说明详见Yeelight 集成文档的 Music mode 一节。总结yeelight.set_color_scene是 Home Assistant 中调用 Yeelight 设备级场景能力的入口之一以一条动作完成RGB 颜色 亮度的原子化设置并在设备关闭时自动点亮。无论是通过 UI 的可视化配置还是直接编写 YAML只需掌握rgb_color三通道 0-255与brightness1-100两个必填参数配合实体、设备、区域、楼层或标签等多种目标类型即可在自动化与脚本中快速构建观影、放松、助眠等丰富的光影场景。本文所引用的动作定义、参数范围、操作步骤与集成配置细节均可直接回溯至本仓库的yeelight.set_color_scene动作文档 与 Yeelight 集成文档供进一步查阅与验证。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考