Home Assistant Yeelight 色温场景动作 yeelight.set_color_temp_scene 完全指南【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.ioyeelight.set_color_temp_scene是 Home Assistant Yeelight 集成提供的场景类动作一条指令即可把 Yeelight 灯具设置为指定的色温Kelvin与亮度Brightness组合并在灯具处于关闭状态时自动将其点亮。本文将以 source/_actions/yeelight.set_color_temp_scene.markdown 为核心结合 Yeelight 集成文档 与同系列场景动作完整讲解该动作在自动化/脚本中的图形界面操作、YAML 配置、目标Target选择方式以及背后的色温数值边界与固件实现细节帮助你一键复现晚间暖光专注工作冷光等常用白光场景。动作概览一条指令复现你偏好的白光场景Scene与普通调节指令的区别在于场景一次性地把灯具带到一组完整、可复现的光效状态而不需要多条指令组合。yeelight.set_color_temp_scene正是这样的动作——它同时设定色温与亮度两个维度若灯具当前处于关闭状态执行该动作会自动将其打开并直接落到目标白光状态若灯具已开启则立即切换到目标色温与亮度。典型的使用场景就是记忆一种偏好的白光色调晚间放松偏暖的低色温白光如 2700 K营造温馨氛围白天专注工作偏冷的高色温白光如 5000 K 以上提供更清醒的照明感受。从命名上可以看出它是 Yeelight 集成场景Scene动作家族的一员。该家族还包括设置 RGB 颜色的 yeelight.set_color_scene、按 HSV 设置的 yeelight.set_hsv_scene、定时关灯的 yeelight.set_auto_delay_off_scene 以及动态流光 yeelight.set_color_flow_scene它们共享同一套目标 数据的调用模型学习这一个即可触类旁通。前置条件先完成 Yeelight 集成配置在使用本动作前需要确保你的 Yeelight 灯具已经接入 Home Assistant。根据 Yeelight 集成文档集成具备以下特性配置流Config Flow支持通过 UI 向导添加设备也可以使用 Zeroconf、DHCP 自动发现IoT 类型为 Local Push灯具状态变化由本地推送无需云服务支持Light与Binary sensor两类平台其中二进制传感器目前仅用于吸顶灯的夜灯模式检测。需要注意的初始化要求是必须先用 Yeelight 官方 App 在灯具属性中开启LAN Control旧称 Developer mode即局域网控制并确认灯具固件为最新版本该开关决定了 Home Assistant 是否能够通过局域网 API 控制灯具。若你的灯具型号较旧且不支持 mDNS 自动发现例如部分 Mijia 桌面灯则需要在configuration.yaml中按 IP 手动声明设备。通过图形界面UI使用该动作如果你习惯可视化地构建自动化与脚本Home Assistant 会引导你逐步完成配置无需手写 YAML。操作步骤如下进入设置 自动化与场景Settings Automations scenes打开一个已有的自动化或脚本或选择创建自动化 创建新自动化如果是从零创建新自动化先在When何时部分添加触发器脚本Script不需要触发器它们由其他自动化或指令显式调用在Then do然后执行部分选择添加动作在目标By target下选择要控制的 Yeelight 灯具目标概念见下文 目标Targets 小节在该目标可用的动作列表中选择Set color temperature scene设置色温场景填写Kelvin色温与Brightness亮度两个参数点击保存。UI 中的可选项选项说明是否必填Kelvin要设置的色温单位为开尔文K取值范围1700 6500是Brightness要设置的亮度取值范围1 100百分比是其中色温下限 1700 K 对应暖黄光上限 6500 K 对应偏蓝的冷白光这正是 Yeelight 灯具所支持的白光色温区间。在 YAML 中使用该动作如果你直接在 YAML 中编写自动化或者想精确了解 Home Assistant 在底层做了什么可以使用如下字段级参考。在 YAML 中该动作的标识符为yeelight.set_color_temp_scene。基础示例如下action: yeelight.set_color_temp_scene target: entity_id: light.living_room data: kelvin: 2700 brightness: 80将这个动作放进一个完整的自动化示例中alias: Living room warm evening light triggers: - trigger: sun event: sunset actions: - action: yeelight.set_color_temp_scene target: entity_id: light.living_room data: kelvin: 2700 brightness: 80 mode: singleYAML 中的可选项字段名类型必填说明kelvininteger是要设置的色温单位为开尔文取值范围1700 6500brightnessinteger是要设置的亮度取值范围1 100百分比注意data中两个字段均必填缺一不可动作执行时会一次性下发色温与亮度灯具会呈现为该色温下的该亮度这一确定状态。若需要平滑过渡而非瞬间切换可以在灯具的设备配置中设置transition选项见下文源码与配置细节。目标Targets该动作必须指定一个目标。目标是动作的作用对象你可以把动作指向单个实体、设备、区域、楼层或标签Home Assistant 会对其背后所有匹配的light实体执行该动作。可选的目标类型包括实体Entity某个具体的 light 实体例如light.living_room设备Device属于某台设备的所有 light 实体区域Area某个房间/区域内的所有 light 实体楼层Floor某个楼层上的所有 light 实体标签Label共享同一标签的所有 light 实体。同一动作中还可以混合多种目标类型例如同时添加一个具体实体和一个区域让该动作同时作用于两者——这在回家时把客厅与走廊灯统一调成暖光这类场景中非常实用。深入色温数值边界的实现依据为什么kelvin的取值范围是 1700 6500从 Yeelight 集成文档 的自定义效果Custom effects与完整配置部分可以看到一致的定义TemperatureTransition[temp, duration, brightness]其中temp为最终色温介于 1700 与 6500 之间duration为过渡时长毫秒最小 50brightness为最终亮度1-100%集成还支持RGBTransitionRGB 值 0-255、HSVTransition色相 0-359、饱和度 0-100与SleepTransition仅时长。也就是说色温场景动作的 1700–6500 K 边界与灯具底层 API 的色温能力区间完全一致Home Assistant 只是把这个硬件能力直接暴露为动作参数。此外集成配置中的model选项可能取值为mono1、color1、color2、strip1、bslamp1、ceiling1ceiling13等说明该设置用于启用型号特定的功能例如特定的色温范围。因此从源码结构看不同型号的 Yeelight 灯具实际可用的色温区间可能存在差异1700–6500 K 是动作接口允许的通用范围具体灯具的表现以其固件与型号为准。同系列场景动作何时选用哪个Yeelight 场景动作家族共享相同的目标 必填参数结构按你需要的灯光维度选择即可动作用途核心参数yeelight.set_color_temp_scene设置色温 亮度的白光场景kelvin、brightnessyeelight.set_color_scene设置RGB 颜色 亮度的彩色场景rgb_color0-255 三元组、brightnessyeelight.set_hsv_scene按HSV色相 0-359、饱和度 0-100设置彩色场景hs_color、brightnessyeelight.set_auto_delay_off_scene以指定亮度点亮并在 N 分钟后自动关闭内置睡眠定时minutes1-60、brightnessyeelight.set_color_flow_scene以场景 API 启动动态流光效果transitions、可选count/action其中set_color_flow_scene与 yeelight.start_flow 接受相同的transitions列表如TemperatureTransition: [1900, 1000, 80]这类数组但前者走的是 Yeelight 的SceneAPI 调用且会在灯具关闭时自动点亮后者走Start FlowAPI 调用文档同时提示不同固件在处理复杂流时的表现可能存在差异。快速验证在不写 YAML 的情况下试跑想立刻验证效果打开设置 工具 动作Settings Tools Actions搜索yeelight.set_color_temp_scene直接填写字段并点击执行动作Perform action即可在真实灯具上观察效果全程无需编写一行 YAML。这对于确定某个色温/亮度组合是否符合预期、再决定是否写进自动化是最快的验证路径。小结yeelight.set_color_temp_scene是 Home Assistant 中一键复现偏好白光的标准动作UI 与 YAML 两条路径完全等价核心只需把握kelvin1700–6500与brightness1–100两个必填参数配合实体/设备/区域/楼层/标签多级目标机制即可在自动化中优雅地统一控制一盏或多盏 Yeelight 灯具的白光状态。若想进一步扩展可参考 Yeelight 集成文档 中的transition平滑过渡、save_on_change状态保存以及custom_effects自定义流光配置把简单的色温场景升级为更丰富的照明体验。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Home Assistant Yeelight 色温场景动作 yeelight.set_color_temp_scene 完全指南
Home Assistant Yeelight 色温场景动作 yeelight.set_color_temp_scene 完全指南【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.ioyeelight.set_color_temp_scene是 Home Assistant Yeelight 集成提供的场景类动作一条指令即可把 Yeelight 灯具设置为指定的色温Kelvin与亮度Brightness组合并在灯具处于关闭状态时自动将其点亮。本文将以 source/_actions/yeelight.set_color_temp_scene.markdown 为核心结合 Yeelight 集成文档 与同系列场景动作完整讲解该动作在自动化/脚本中的图形界面操作、YAML 配置、目标Target选择方式以及背后的色温数值边界与固件实现细节帮助你一键复现晚间暖光专注工作冷光等常用白光场景。动作概览一条指令复现你偏好的白光场景Scene与普通调节指令的区别在于场景一次性地把灯具带到一组完整、可复现的光效状态而不需要多条指令组合。yeelight.set_color_temp_scene正是这样的动作——它同时设定色温与亮度两个维度若灯具当前处于关闭状态执行该动作会自动将其打开并直接落到目标白光状态若灯具已开启则立即切换到目标色温与亮度。典型的使用场景就是记忆一种偏好的白光色调晚间放松偏暖的低色温白光如 2700 K营造温馨氛围白天专注工作偏冷的高色温白光如 5000 K 以上提供更清醒的照明感受。从命名上可以看出它是 Yeelight 集成场景Scene动作家族的一员。该家族还包括设置 RGB 颜色的 yeelight.set_color_scene、按 HSV 设置的 yeelight.set_hsv_scene、定时关灯的 yeelight.set_auto_delay_off_scene 以及动态流光 yeelight.set_color_flow_scene它们共享同一套目标 数据的调用模型学习这一个即可触类旁通。前置条件先完成 Yeelight 集成配置在使用本动作前需要确保你的 Yeelight 灯具已经接入 Home Assistant。根据 Yeelight 集成文档集成具备以下特性配置流Config Flow支持通过 UI 向导添加设备也可以使用 Zeroconf、DHCP 自动发现IoT 类型为 Local Push灯具状态变化由本地推送无需云服务支持Light与Binary sensor两类平台其中二进制传感器目前仅用于吸顶灯的夜灯模式检测。需要注意的初始化要求是必须先用 Yeelight 官方 App 在灯具属性中开启LAN Control旧称 Developer mode即局域网控制并确认灯具固件为最新版本该开关决定了 Home Assistant 是否能够通过局域网 API 控制灯具。若你的灯具型号较旧且不支持 mDNS 自动发现例如部分 Mijia 桌面灯则需要在configuration.yaml中按 IP 手动声明设备。通过图形界面UI使用该动作如果你习惯可视化地构建自动化与脚本Home Assistant 会引导你逐步完成配置无需手写 YAML。操作步骤如下进入设置 自动化与场景Settings Automations scenes打开一个已有的自动化或脚本或选择创建自动化 创建新自动化如果是从零创建新自动化先在When何时部分添加触发器脚本Script不需要触发器它们由其他自动化或指令显式调用在Then do然后执行部分选择添加动作在目标By target下选择要控制的 Yeelight 灯具目标概念见下文 目标Targets 小节在该目标可用的动作列表中选择Set color temperature scene设置色温场景填写Kelvin色温与Brightness亮度两个参数点击保存。UI 中的可选项选项说明是否必填Kelvin要设置的色温单位为开尔文K取值范围1700 6500是Brightness要设置的亮度取值范围1 100百分比是其中色温下限 1700 K 对应暖黄光上限 6500 K 对应偏蓝的冷白光这正是 Yeelight 灯具所支持的白光色温区间。在 YAML 中使用该动作如果你直接在 YAML 中编写自动化或者想精确了解 Home Assistant 在底层做了什么可以使用如下字段级参考。在 YAML 中该动作的标识符为yeelight.set_color_temp_scene。基础示例如下action: yeelight.set_color_temp_scene target: entity_id: light.living_room data: kelvin: 2700 brightness: 80将这个动作放进一个完整的自动化示例中alias: Living room warm evening light triggers: - trigger: sun event: sunset actions: - action: yeelight.set_color_temp_scene target: entity_id: light.living_room data: kelvin: 2700 brightness: 80 mode: singleYAML 中的可选项字段名类型必填说明kelvininteger是要设置的色温单位为开尔文取值范围1700 6500brightnessinteger是要设置的亮度取值范围1 100百分比注意data中两个字段均必填缺一不可动作执行时会一次性下发色温与亮度灯具会呈现为该色温下的该亮度这一确定状态。若需要平滑过渡而非瞬间切换可以在灯具的设备配置中设置transition选项见下文源码与配置细节。目标Targets该动作必须指定一个目标。目标是动作的作用对象你可以把动作指向单个实体、设备、区域、楼层或标签Home Assistant 会对其背后所有匹配的light实体执行该动作。可选的目标类型包括实体Entity某个具体的 light 实体例如light.living_room设备Device属于某台设备的所有 light 实体区域Area某个房间/区域内的所有 light 实体楼层Floor某个楼层上的所有 light 实体标签Label共享同一标签的所有 light 实体。同一动作中还可以混合多种目标类型例如同时添加一个具体实体和一个区域让该动作同时作用于两者——这在回家时把客厅与走廊灯统一调成暖光这类场景中非常实用。深入色温数值边界的实现依据为什么kelvin的取值范围是 1700 6500从 Yeelight 集成文档 的自定义效果Custom effects与完整配置部分可以看到一致的定义TemperatureTransition[temp, duration, brightness]其中temp为最终色温介于 1700 与 6500 之间duration为过渡时长毫秒最小 50brightness为最终亮度1-100%集成还支持RGBTransitionRGB 值 0-255、HSVTransition色相 0-359、饱和度 0-100与SleepTransition仅时长。也就是说色温场景动作的 1700–6500 K 边界与灯具底层 API 的色温能力区间完全一致Home Assistant 只是把这个硬件能力直接暴露为动作参数。此外集成配置中的model选项可能取值为mono1、color1、color2、strip1、bslamp1、ceiling1ceiling13等说明该设置用于启用型号特定的功能例如特定的色温范围。因此从源码结构看不同型号的 Yeelight 灯具实际可用的色温区间可能存在差异1700–6500 K 是动作接口允许的通用范围具体灯具的表现以其固件与型号为准。同系列场景动作何时选用哪个Yeelight 场景动作家族共享相同的目标 必填参数结构按你需要的灯光维度选择即可动作用途核心参数yeelight.set_color_temp_scene设置色温 亮度的白光场景kelvin、brightnessyeelight.set_color_scene设置RGB 颜色 亮度的彩色场景rgb_color0-255 三元组、brightnessyeelight.set_hsv_scene按HSV色相 0-359、饱和度 0-100设置彩色场景hs_color、brightnessyeelight.set_auto_delay_off_scene以指定亮度点亮并在 N 分钟后自动关闭内置睡眠定时minutes1-60、brightnessyeelight.set_color_flow_scene以场景 API 启动动态流光效果transitions、可选count/action其中set_color_flow_scene与 yeelight.start_flow 接受相同的transitions列表如TemperatureTransition: [1900, 1000, 80]这类数组但前者走的是 Yeelight 的SceneAPI 调用且会在灯具关闭时自动点亮后者走Start FlowAPI 调用文档同时提示不同固件在处理复杂流时的表现可能存在差异。快速验证在不写 YAML 的情况下试跑想立刻验证效果打开设置 工具 动作Settings Tools Actions搜索yeelight.set_color_temp_scene直接填写字段并点击执行动作Perform action即可在真实灯具上观察效果全程无需编写一行 YAML。这对于确定某个色温/亮度组合是否符合预期、再决定是否写进自动化是最快的验证路径。小结yeelight.set_color_temp_scene是 Home Assistant 中一键复现偏好白光的标准动作UI 与 YAML 两条路径完全等价核心只需把握kelvin1700–6500与brightness1–100两个必填参数配合实体/设备/区域/楼层/标签多级目标机制即可在自动化中优雅地统一控制一盏或多盏 Yeelight 灯具的白光状态。若想进一步扩展可参考 Yeelight 集成文档 中的transition平滑过渡、save_on_change状态保存以及custom_effects自定义流光配置把简单的色温场景升级为更丰富的照明体验。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考