Home Assistant Xiaomi Home 集成：使用 `xiaomi_miio.light_night_light_mode_on` 开启小米飞利浦护眼台灯 2 的夜灯模式-迪斯科星球

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 Home（xiaomi_miio）集成下开启飞利浦护眼台灯 2 的夜灯模式，并结合 xiaomi_miio 集成文档与同域相关动作文档，说明其适用设备、参数语义与典型搭配用法。读完本文，你将掌握该动作的完整调用方法，并能把它组合进自动化与脚本流程中。

动作是什么：为 Philips Eyecare Smart Lamp 2 开启夜灯模式

Light night light mode on（xiaomi_miio.light_night_light_mode_on）是 Xiaomi Home（xiaomi_miio）域下针对小米飞利浦台灯提供的一个专用动作，作用是开启夜灯模式（night light mode）。

根据 xiaomi_miio 集成文档中"Xiaomi Philips Light"一节，该动作只对 Philips Eyecare Smart Lamp 2 生效，对应设备型号为philips.light.sread1。集成文档将夜灯模式列为该型号的核心能力之一：

Eyecare light（开/关）
Ambient light（开/关）
各灯亮度
Scene（1–4）
Night light mode（开/关）
延时关灯（按秒计）
护眼疲劳提醒 / 通知（开/关）
Eyecare mode（开/关）

同时，该型号实体对外暴露的属性包括model、scene、delayed_turn_off、night_light_mode、reminder与eyecare_mode。也就是说，夜灯模式是否开启，会通过实体的night_light_mode属性反映出来，你可以在仪表盘或模板（template）中读取该属性判断当前状态。

与之对应的关闭动作是Light night light mode off（xiaomi_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_lamp

YAML 选项

字段	说明	必填	类型
`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属性，在仪表盘上展示当前是否为夜灯模式，或作为其它自动化的条件。

注意事项与故障排查

设备适配性：该动作仅适用于 Philips Eyecare Smart Lamp 2（philips.light.sread1）。如果目标实体是其它小米飞利浦灯具，该动作不会产生预期效果，请改用相应灯具支持的能力（例如吸顶灯本身支持夜灯模式，但动作调用语义不同）。
作用范围：动作不支持 targets；UI 中通过 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），仅供参考

企业官网建设流程全解析