Home Assistant Xiaomi Homexiaomi_miio.light_set_scene 动作完全指南【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本篇技术指南围绕 Home Assistant 中 Xiaomi Homexiaomi_miio集成的Light set scene设置固定场景动作展开讲解如何通过自动化、脚本与 YAML 一键激活小米飞利浦灯内置的固定灯光场景Scene 1–6。读完本文你将掌握该动作在 UI 与 YAML 两种方式下的完整用法、参数细节与适用设备模型并能直接复制配置投入实战。动作概览什么是 Light set scenexiaomi_miio.light_set_scene是 Xiaomi Home 集成提供的动作之一其作用是激活小米飞利浦灯中内置的固定场景。固定场景是灯具固件预先定义好的灯光组合例如特定的亮度与色温搭配用户无需自行逐项调节参数只需传入一个场景编号即可一键切换。该动作属于集成在 Xiaomi Home 集成文档 的 Actions 一节中说明的灯光附加能力。集成文档明确指出这类灯光动作主要用于三件事设置固定场景set a fixed scene、定时关闭delayed turn off以及在飞利浦护眼台灯 2 上切换提醒、夜灯与护眼模式。light_set_scene正是其中的设置固定场景部分。从源码结构看该动作不支持 targets目标选择器只能通过entity_id明确指定要控制的灯具实体这与light.turn_on等支持批量目标的标准灯光动作有明显区别。适用设备哪些灯支持固定场景并非所有 Xiaomi Home 的灯都支持场景功能。根据 Xiaomi Home 集成文档的 Philips Light 章节以下设备模型支持固定场景设备支持模型场景范围Philips LED 球泡灯 / Zhirui 蜡烛灯 / Zhirui 筒灯philips.light.bulb、philips.light.candle、philips.light.candle2、philips.light.downlightScene 1–4Philips LED 吸顶灯philips.light.ceiling、philips.light.zyceilingScene 1–4Philips 护眼台灯 2Eyecare Smart Lamp 2philips.light.sread1Scene 1–4Philips Zhirui 桌面台灯philips.light.mono1Scene 1–4Philips 月光床头灯Moonlight Bedside Lampphilips.light.moonlightScene 1–6动作文档中scene参数取值范围为1 到 6这一范围覆盖了上述全部模型其中月光床头灯Moonlight拥有完整的 6 个固定场景而其余多数型号仅提供 1–4 号场景。在实际使用中若灯具固件不支持某个编号可能会被设备忽略或报错建议先在 Mi Home App 中确认自己设备可用的场景编号。在 UI 中调用该动作Xiaomi Home 集成支持通过配置流Config Flow在 UI 中完成设备接入详见 集成文档。设备接入后即可通过可视化界面在自动化或脚本中使用本动作进入设置 自动化与场景Settings Automations scenes。打开一个现有的自动化或脚本或选择创建自动化 创建新的自动化Create automation Create new automation。若在创建新自动化需在When触发条件部分添加一个触发器。脚本Script不需要触发器它们由其他自动化或事件显式调用时才运行。在Then do执行操作部分选择添加动作Add action。在搜索框中搜索并选择Xiaomi Home: Light set scene。填写Scene编号1–6。选择保存。UI 中的选项选项说明Entity ID实体 ID要操作的 Xiaomi Philips 灯实体。留空则作用于所有 Xiaomi Philips 灯。Scene场景要激活的固定场景编号取值范围 1–6必填。在 YAML 中调用该动作在 YAML自动化、脚本或场景的action键中该动作的标识符为xiaomi_miio.light_set_scene。基础示例如下action: xiaomi_miio.light_set_scene data: entity_id: light.philips_light scene: 1上述配置会激活light.philips_light上的第 1 个固定场景。YAML 参数参考参数说明必填类型entity_id要操作的 Xiaomi Philips 灯实体。省略时作用于所有 Xiaomi Philips 灯。否string 或 listscene要激活的固定场景编号取值范围 1–6。是integer两点注意事项entity_id支持传入字符串或字符串列表list。虽然动作不支持 targets但显式传入列表可以一次控制多盏灯。scene为必填的整数值。如果省略动作将因缺少必要参数而无法正确执行。与灯光基础动作的搭配使用固定场景与普通灯光控制可以灵活组合。例如在自动化的同一组动作中先调用xiaomi_miio.light_set_scene切换场景再配合标准灯光动作调整亮度action: - action: xiaomi_miio.light_set_scene data: entity_id: light.philips_ceiling scene: 2 - action: light.turn_on data: entity_id: light.philips_ceiling brightness_pct: 80需要说明的是灯光实体在切换场景后其亮度、色温等状态由固件场景本身决定后续的light.turn_on等标准动作会对场景状态进行覆盖。实际效果取决于灯具固件对场景与手动调节之间优先级的处理建议在具体设备上实测确认。相关动作与延伸阅读Xiaomi Home 灯光类动作是一个完整家族本动作常与以下动作配合使用相关文件均位于 source/_actions 目录xiaomi_miio.light_set_delayed_turn_off设置定时关闭按秒计分辨率实现入睡前自动熄灯类场景。xiaomi_miio.light_eyecare_mode_on 与 xiaomi_miio.light_eyecare_mode_off仅护眼台灯 2 支持切换护眼模式。xiaomi_miio.light_night_light_mode_on 与 xiaomi_miio.light_night_light_mode_off切换夜灯模式。xiaomi_miio.light_reminder_on 与 xiaomi_miio.light_reminder_off切换用眼疲劳提醒。典型的应用示例夜晚观影时通过自动化调用light_set_scene切换到低亮度观影场景同时配合light_set_delayed_turn_off设置 30 分钟自动关闭。常见问题与排查动作在 UI 中搜不到请确认设备已通过 Xiaomi Home 集成接入设置 设备与服务 Xiaomi Home且设备属于支持场景的 Philips 灯模型。若设备是通过网关接入的子设备需确认网关与子设备均已正确识别。场景编号无效多数型号只有 1–4 号场景仅月光床头灯提供 1–6 号。传入超出固件支持范围的编号时行为取决于固件实现建议以 Mi Home App 中设备实际提供的场景为准。未指定entity_id的影响动作会作用于所有 Xiaomi Philips 灯因此在多灯环境中务必显式指定目标实体避免误触发。跨网段/VLAN 问题Xiaomi Home 设备基于本地 UDP 通信若设备与 Home Assistant 处于不同子网可能导致通信失败详见 集成文档的 Troubleshooting 章节。小结xiaomi_miio.light_set_scene提供了一种轻量、直接的方式将小米飞利浦灯具的固件级固定场景接入 Home Assistant 的自动化体系。掌握它你可以在观影、阅读、睡前等场景中一键切换灯光氛围并通过entity_id精确控制目标灯具配合定时关闭、护眼模式等兄弟动作构建完整的智能照明体验。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Home Assistant Xiaomi Homexiaomi_miio.light_set_scene 动作完全指南【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本篇技术指南围绕 Home Assistant 中 Xiaomi Homexiaomi_miio集成的Light set scene设置固定场景动作展开讲解如何通过自动化、脚本与 YAML 一键激活小米飞利浦灯内置的固定灯光场景Scene 1–6。读完本文你将掌握该动作在 UI 与 YAML 两种方式下的完整用法、参数细节与适用设备模型并能直接复制配置投入实战。动作概览什么是 Light set scenexiaomi_miio.light_set_scene是 Xiaomi Home 集成提供的动作之一其作用是激活小米飞利浦灯中内置的固定场景。固定场景是灯具固件预先定义好的灯光组合例如特定的亮度与色温搭配用户无需自行逐项调节参数只需传入一个场景编号即可一键切换。该动作属于集成在 Xiaomi Home 集成文档 的 Actions 一节中说明的灯光附加能力。集成文档明确指出这类灯光动作主要用于三件事设置固定场景set a fixed scene、定时关闭delayed turn off以及在飞利浦护眼台灯 2 上切换提醒、夜灯与护眼模式。light_set_scene正是其中的设置固定场景部分。从源码结构看该动作不支持 targets目标选择器只能通过entity_id明确指定要控制的灯具实体这与light.turn_on等支持批量目标的标准灯光动作有明显区别。适用设备哪些灯支持固定场景并非所有 Xiaomi Home 的灯都支持场景功能。根据 Xiaomi Home 集成文档的 Philips Light 章节以下设备模型支持固定场景设备支持模型场景范围Philips LED 球泡灯 / Zhirui 蜡烛灯 / Zhirui 筒灯philips.light.bulb、philips.light.candle、philips.light.candle2、philips.light.downlightScene 1–4Philips LED 吸顶灯philips.light.ceiling、philips.light.zyceilingScene 1–4Philips 护眼台灯 2Eyecare Smart Lamp 2philips.light.sread1Scene 1–4Philips Zhirui 桌面台灯philips.light.mono1Scene 1–4Philips 月光床头灯Moonlight Bedside Lampphilips.light.moonlightScene 1–6动作文档中scene参数取值范围为1 到 6这一范围覆盖了上述全部模型其中月光床头灯Moonlight拥有完整的 6 个固定场景而其余多数型号仅提供 1–4 号场景。在实际使用中若灯具固件不支持某个编号可能会被设备忽略或报错建议先在 Mi Home App 中确认自己设备可用的场景编号。在 UI 中调用该动作Xiaomi Home 集成支持通过配置流Config Flow在 UI 中完成设备接入详见 集成文档。设备接入后即可通过可视化界面在自动化或脚本中使用本动作进入设置 自动化与场景Settings Automations scenes。打开一个现有的自动化或脚本或选择创建自动化 创建新的自动化Create automation Create new automation。若在创建新自动化需在When触发条件部分添加一个触发器。脚本Script不需要触发器它们由其他自动化或事件显式调用时才运行。在Then do执行操作部分选择添加动作Add action。在搜索框中搜索并选择Xiaomi Home: Light set scene。填写Scene编号1–6。选择保存。UI 中的选项选项说明Entity ID实体 ID要操作的 Xiaomi Philips 灯实体。留空则作用于所有 Xiaomi Philips 灯。Scene场景要激活的固定场景编号取值范围 1–6必填。在 YAML 中调用该动作在 YAML自动化、脚本或场景的action键中该动作的标识符为xiaomi_miio.light_set_scene。基础示例如下action: xiaomi_miio.light_set_scene data: entity_id: light.philips_light scene: 1上述配置会激活light.philips_light上的第 1 个固定场景。YAML 参数参考参数说明必填类型entity_id要操作的 Xiaomi Philips 灯实体。省略时作用于所有 Xiaomi Philips 灯。否string 或 listscene要激活的固定场景编号取值范围 1–6。是integer两点注意事项entity_id支持传入字符串或字符串列表list。虽然动作不支持 targets但显式传入列表可以一次控制多盏灯。scene为必填的整数值。如果省略动作将因缺少必要参数而无法正确执行。与灯光基础动作的搭配使用固定场景与普通灯光控制可以灵活组合。例如在自动化的同一组动作中先调用xiaomi_miio.light_set_scene切换场景再配合标准灯光动作调整亮度action: - action: xiaomi_miio.light_set_scene data: entity_id: light.philips_ceiling scene: 2 - action: light.turn_on data: entity_id: light.philips_ceiling brightness_pct: 80需要说明的是灯光实体在切换场景后其亮度、色温等状态由固件场景本身决定后续的light.turn_on等标准动作会对场景状态进行覆盖。实际效果取决于灯具固件对场景与手动调节之间优先级的处理建议在具体设备上实测确认。相关动作与延伸阅读Xiaomi Home 灯光类动作是一个完整家族本动作常与以下动作配合使用相关文件均位于 source/_actions 目录xiaomi_miio.light_set_delayed_turn_off设置定时关闭按秒计分辨率实现入睡前自动熄灯类场景。xiaomi_miio.light_eyecare_mode_on 与 xiaomi_miio.light_eyecare_mode_off仅护眼台灯 2 支持切换护眼模式。xiaomi_miio.light_night_light_mode_on 与 xiaomi_miio.light_night_light_mode_off切换夜灯模式。xiaomi_miio.light_reminder_on 与 xiaomi_miio.light_reminder_off切换用眼疲劳提醒。典型的应用示例夜晚观影时通过自动化调用light_set_scene切换到低亮度观影场景同时配合light_set_delayed_turn_off设置 30 分钟自动关闭。常见问题与排查动作在 UI 中搜不到请确认设备已通过 Xiaomi Home 集成接入设置 设备与服务 Xiaomi Home且设备属于支持场景的 Philips 灯模型。若设备是通过网关接入的子设备需确认网关与子设备均已正确识别。场景编号无效多数型号只有 1–4 号场景仅月光床头灯提供 1–6 号。传入超出固件支持范围的编号时行为取决于固件实现建议以 Mi Home App 中设备实际提供的场景为准。未指定entity_id的影响动作会作用于所有 Xiaomi Philips 灯因此在多灯环境中务必显式指定目标实体避免误触发。跨网段/VLAN 问题Xiaomi Home 设备基于本地 UDP 通信若设备与 Home Assistant 处于不同子网可能导致通信失败详见 集成文档的 Troubleshooting 章节。小结xiaomi_miio.light_set_scene提供了一种轻量、直接的方式将小米飞利浦灯具的固件级固定场景接入 Home Assistant 的自动化体系。掌握它你可以在观影、阅读、睡前等场景中一键切换灯光氛围并通过entity_id精确控制目标灯具配合定时关闭、护眼模式等兄弟动作构建完整的智能照明体验。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
