
Home Assistant Xiaomi Home 集成使用xiaomi_miio.light_night_light_mode_on开启小米飞利浦护眼台灯 2 的夜灯模式【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本文以 Home Assistant 用户文档中的动作参考文档 xiaomi_miio.light_night_light_mode_on 为骨架系统讲解如何通过 UI 与 YAML 两种方式调用该动作在 Xiaomi Homexiaomi_miio集成下开启飞利浦护眼台灯 2 的夜灯模式并结合 xiaomi_miio 集成文档 与同域相关动作文档说明其适用设备、参数语义与典型搭配用法。读完本文你将掌握该动作的完整调用方法并能把它组合进自动化与脚本流程中。动作是什么为 Philips Eyecare Smart Lamp 2 开启夜灯模式Light night light mode onxiaomi_miio.light_night_light_mode_on是 Xiaomi Homexiaomi_miio域下针对小米飞利浦台灯提供的一个专用动作作用是开启夜灯模式night light mode。根据 xiaomi_miio 集成文档 中Xiaomi Philips Light一节该动作只对 Philips Eyecare Smart Lamp 2 生效对应设备型号为philips.light.sread1。集成文档将夜灯模式列为该型号的核心能力之一Eyecare light开/关Ambient light开/关各灯亮度Scene1–4Night light mode开/关延时关灯按秒计护眼疲劳提醒 / 通知开/关Eyecare mode开/关同时该型号实体对外暴露的属性包括model、scene、delayed_turn_off、night_light_mode、reminder与eyecare_mode。也就是说夜灯模式是否开启会通过实体的night_light_mode属性反映出来你可以在仪表盘或模板template中读取该属性判断当前状态。与之对应的关闭动作是Light night light mode offxiaomi_miio.light_night_light_mode_off两个动作互为反向操作参考文档相互列为 related actions详见 xiaomi_miio.light_night_light_mode_off。使用前置条件在调用本动作之前需要确保已通过 Xiaomi Home 集成完成设备配置。xiaomi_miio集成支持 UI 配置流程ha_config_flow: true见集成文档 front matter建议在配置时提供小米账号凭据以便自动发现并连接设备同时需正确选择账号所属服务器区域cn、de、i2、ru、sg、us之一。被操作的灯具实体light.*对应的真实设备必须是 Philips Eyecare Smart Lamp 2型号philips.light.sread1。该动作对其它小米飞利浦灯具如 LED Ball Lamp、吸顶灯、床头灯、智睿台灯等不适用。设备已出现在 Home Assistant 中实体 ID 形如light.eyecare_lamp。在 UI 中通过自动化或脚本开启夜灯模式按照 动作 UI 使用说明如果你更喜欢可视化构建自动化Home Assistant 会逐步引导完成动作配置无需编写 YAML。在自动化或脚本中开启夜灯模式的步骤如下进入设置自动化与场景Settings Automations scenes。打开已有的自动化或脚本或选择创建自动化创建新自动化。如果是新建自动化在When当...时部分添加一个触发器脚本不需要触发器它们由其它流程调用时才运行。在Then do然后执行部分选择添加动作Add action。在搜索框中搜索并选择Xiaomi Home: Light night light mode on。选择保存。需要注意该动作不支持 targets目标对象。在 UI 中必须通过Entity ID字段指定要操作的护眼台灯 2如果留空动作会作用于所有此类灯具。UI 中的选项选项说明必填Entity ID要操作的 Eyecare Smart Lamp 2。留空则影响所有此类灯具否留空作用于全部在 YAML 中调用动作如果你直接编写 YAML或想确切了解 Home Assistant 底层做了什么可以参考动作 YAML 使用说明中的字段定义。YAML 中动作名称为xiaomi_miio.light_night_light_mode_on基础示例如下action: xiaomi_miio.light_night_light_mode_on data: entity_id: light.eyecare_lamp上面的配置会对实体light.eyecare_lamp一台已接入的 Eyecare Smart Lamp 2开启夜灯模式。如果是在自动化automation或脚本script中使用通常写成下面的嵌套形式automation: - alias: 开启书房台灯夜灯模式 trigger: - platform: time at: 22:30:00 action: - action: xiaomi_miio.light_night_light_mode_on data: entity_id: light.eyecare_lamp在脚本中同理只需在sequence下列出该动作sequence: - action: xiaomi_miio.light_night_light_mode_on data: entity_id: light.eyecare_lampYAML 选项字段说明必填类型entity_id要操作的 Eyecare Smart Lamp 2。省略则作用于所有此类灯具否string 或 list其中entity_id支持传入单个字符串或字符串列表type: [string, list]因此可以一次对多台台灯批量开启夜灯模式action: xiaomi_miio.light_night_light_mode_on data: entity_id: - light.eyecare_lamp - light.eyecare_lamp_bedroom典型使用场景夜灯模式适合在低亮度环境下提供柔和照明例如定时触发每天入睡时间点由time触发器自动开启夜灯模式作为睡前照明。脚本组合在脚本中先开启夜灯模式再配合其它动作如延时关灯构成完整的睡前灯光流程。状态感知通过模板读取实体的night_light_mode属性在仪表盘上展示当前是否为夜灯模式或作为其它自动化的条件。相关动作与搭配建议根据文档 front matter 中的related_actions以及 xiaomi_miio 集成文档中Actions一节的说明Xiaomi Home 集成针对飞利浦护眼台灯 2 还提供了以下相关动作可与夜灯模式搭配使用xiaomi_miio.light_night_light_mode_off关闭夜灯模式与本动作互为反向操作。xiaomi_miio.light_eyecare_mode_on / xiaomi_miio.light_eyecare_mode_off开关护眼模式。xiaomi_miio.light_reminder_on / xiaomi_miio.light_reminder_off开关用眼疲劳提醒。xiaomi_miio.light_set_scene激活灯具内置的固定场景。xiaomi_miio.light_set_delayed_turn_off设置延时关灯。例如睡前脚本可以依次开启夜灯模式 → 设置延时关灯利用台灯自身的延时能力在指定时间后自动熄灭无需额外自动化sequence: - action: xiaomi_miio.light_night_light_mode_on data: entity_id: light.eyecare_lamp - action: xiaomi_miio.light_set_delayed_turn_off data: entity_id: light.eyecare_lamp delay_time: 30注意事项与故障排查设备适配性该动作仅适用于 Philips Eyecare Smart Lamp 2philips.light.sread1。如果目标实体是其它小米飞利浦灯具该动作不会产生预期效果请改用相应灯具支持的能力例如吸顶灯本身支持夜灯模式但动作调用语义不同。作用范围动作不支持 targetsUI 中通过 Entity ID 选择目标留空会作用于所有此类灯具YAML 中省略entity_id同理请按需显式指定以缩小作用范围。连接与网络xiaomi_miio集成基于本地轮询ha_iot_class: Local Polling设备需要与 Home Assistant 网络可达。若设备无法跨子网/VLAN 通信或使用了厂商专属 App而非小米 Home App完成配网可能出现设备无法被发现或间歇性掉线的问题详见集成文档 Troubleshooting 一节。验证状态开启后可通过实体属性night_light_mode确认夜灯模式是否生效。若调用后未达到预期可携带调用的动作名称与期望结果在 Home Assistant 社区渠道官方论坛、Discord、Reddit中描述问题并附上相关实体与日志信息以便快速定位。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考