企业官网建设流程全解析

Home Assistant Xiaomi Home：使用xiaomi_miio.light_reminder_on开启飞利浦 EyeCare 智能台灯 2 的眼疲劳提醒

【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io

本文介绍 Home Assistant 的 Xiaomi Home（xiaomi_miio）集成中提供的Light reminder on动作（action），说明如何通过 UI 与 YAML 两种方式开启飞利浦 EyeCare 智能台灯 2（Philips Eyecare Smart Lamp 2）的用眼疲劳提醒（eye fatigue reminder）功能。读完本文，你将能够在自动化、脚本及开发者工具中熟练调用xiaomi_miio.light_reminder_on，并能与配套的xiaomi_miio.light_reminder_off动作组合，实现按时间或使用场景自动切换提醒状态的完整方案。

动作概述

Light reminder on动作的作用是开启飞利浦 EyeCare 智能台灯 2 上的眼疲劳提醒通知（eye fatigue reminder notification）。该功能属于 xiaomi_miio 集成文档中"Xiaomi Philips Light"平台为 EyeCare 智能台灯 2 提供的专项能力。

需要特别注意的是：该动作仅适用于飞利浦 EyeCare 智能台灯 2（其模型标识为philips.light.sread1，参见 xiaomi_miio 集成文档）。其他型号的飞利浦灯，例如 LED Ball Lamp（philips.light.bulb）、吸顶灯（philips.light.ceiling）、智睿台灯（philips.light.mono1）等，并不支持此项功能，调用该动作不会有实际效果。

从集成文档的设备功能清单看，EyeCare 智能台灯 2 支持的功能非常丰富，而眼疲劳提醒只是其中一项（见 xiaomi_miio 集成文档）：

• 护眼光（Eyecare light，开/关）
• 环境光（Ambient light，开/关）
• 每种光的亮度（Brightness）
• 场景（Scene 1、2、3、4）
• 夜灯模式（Night light mode，开/关）
• 延时关灯（Delayed turn off，以秒为单位）
• 眼疲劳提醒/通知（Eye fatigue reminder/notification，开/关）—— 即本文主题
• 护眼模式（Eyecare mode，开/关）

该设备的实体属性中还包含reminder与eyecare_mode，其中reminder属性即对应当前提醒的开关状态，可用于在自动化条件中读取。

从用户界面使用该动作

如果你更习惯通过可视化界面构建自动化和脚本，Home Assistant 会逐步引导你完成该动作的配置：选择目标、微调选项、保存即可，无需任何 YAML 知识（见 actions/ui_header.md 模板）。

按以下步骤在自动化或脚本中开启提醒：

1. 进入设置>自动化与场景（Settings > Automations & scenes）。
2. 打开一个现有的自动化或脚本，或选择创建自动化>创建新自动化。
3. 如果正在新建自动化，在触发条件（When）部分添加触发器；脚本不需要触发器，它们在被其他内容调用时运行。
4. 在然后执行（Then do）部分，选择添加动作（Add action）。
5. 在搜索框中搜索并选择Xiaomi Home: Light reminder on。
6. 选择保存（Save）。

界面中的选项

该动作不支持目标（targets）。在 UI 中请使用实体 ID（Entity ID）字段选择要对哪台 EyeCare 智能台灯 2 执行操作。选项说明如下：

由于动作不支持 targets，UI 中不会出现基于设备、区域或标签的目标选择器，只能通过实体 ID 精确指定，这一点在配置多台台灯时尤其重要。

在 YAML 中使用该动作

如果你直接编写 YAML，或者想确切了解 Home Assistant 在底层做了什么，本节提供技术参考：列出 YAML 中使用的字段名、字段类型以及哪些是必填项（见 actions/yaml_header.md 模板）。

在 YAML 中，该动作的调用名称为xiaomi_miio.light_reminder_on。一个基本的示例：

action: xiaomi_miio.light_reminder_on data: entity_id: light.eyecare_lamp

这会在实体light.eyecare_lamp上开启眼疲劳提醒。

如果放在自动化中，完整的写法如下（包含触发条件与动作）：

alias: "Enable eye care reminder at 20:00" triggers: - trigger: time at: "20:00:00" actions: - action: xiaomi_miio.light_reminder_on data: entity_id: light.eyecare_lamp

YAML 中的选项

需要留意的是，entity_id的类型同时支持字符串与字符串列表（[string, list]），因此你可以一次传入多台台灯：

action: xiaomi_miio.light_reminder_on data: entity_id: - light.eyecare_lamp_1 - light.eyecare_lamp_2

与关闭动作配对：实现提醒的定时启停

本动作的配套动作为Light reminder off（xiaomi_miio.light_reminder_off），其使用方式与开启动作完全对称：通过 UI 选择Xiaomi Home: Light reminder off，或通过 YAML 调用：

action: xiaomi_miio.light_reminder_off data: entity_id: light.eyecare_lamp

典型的使用场景是让提醒仅在特定时段生效，例如白天学习时段开启、夜间关闭。在自动化中，light_reminder_on与light_reminder_off常作为"related actions"成对出现（两个动作文档的 frontmatter 中通过related_actions互相引用，参见 xiaomi_miio.light_reminder_off 动作文档）。例如：

alias: "Eye care reminder schedule" triggers: - trigger: time at: "08:00:00" id: morning - trigger: time at: "21:00:00" id: evening actions: - choose: - conditions: - condition: trigger id: morning sequence: - action: xiaomi_miio.light_reminder_on data: entity_id: light.eyecare_lamp - conditions: - condition: trigger id: evening sequence: - action: xiaomi_miio.light_reminder_off data: entity_id: light.eyecare_lamp

在开发者工具中即时测试

如果你想在编写任何 YAML 之前先验证动作效果，可以打开设置>工具>操作（Actions）（即开发者服务页面），搜索该动作，填写字段后选择执行动作（Perform action），即可在真实实体上观察实际效果（见 actions/try_it.md 模板）。

• 在操作（Action）下拉框中选择xiaomi_miio.light_reminder_on。
• 在目标（Targets）中通过实体选择器勾选light.eyecare_lamp，或在 YAML 模式下直接填写data.entity_id。
• 点击执行动作后，回到台灯的实体状态页观察reminder属性是否变为开启。

前置条件与适用限制

结合 xiaomi_miio 集成文档中关于设备支持情况的说明，使用本动作前请确认以下几点：

1. 设备必须为飞利浦 EyeCare 智能台灯 2，模型标识为philips.light.sread1。这是唯一支持眼疲劳提醒动作的飞利浦灯型号。
2. 设备需要通过 Mi Home App（米家 App）完成初始设置，而不是厂商专属 App（例如 Roborock App 等），否则无法被本集成正常发现与控制。
3. 集成支持通过 Home Assistant UI 进行配置（config flow），并建议在配置时提供 Xiaomi Home 账号凭据，以便自动连接设备；配置时需指定设备最初绑定的服务器区域（cn、de、i2、ru、sg、us共 6 个服务器）。
4. 该动作不支持 targets，只能通过entity_id指定目标；留空则作用于所有 EyeCare 智能台灯 2 实体。
5. 动作的开启与关闭是对称的：xiaomi_miio.light_reminder_on开启提醒，xiaomi_miio.light_reminder_off关闭提醒，二者可以组合进同一套自动化流程中。

小结

xiaomi_miio.light_reminder_on是 Xiaomi Home 集成为飞利浦 EyeCare 智能台灯 2 提供的专用动作，用于开启眼疲劳提醒。通过 UI 的可视化编排、YAML 的精确调用以及开发者工具的即时测试，你可以灵活地将提醒的开启、关闭纳入自动化场景中。使用时的核心约束是：设备型号必须为philips.light.sread1，且动作只接受entity_id作为参数（可选，支持单值或列表），与xiaomi_miio.light_reminder_off成对使用即可实现完整的提醒启停控制。

【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io