Home Assistant 小米飞利浦智睿台灯2 护眼模式关闭动作xiaomi_miio.light_eyecare_mode_off完全指南【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本篇文章系统讲解 Home Assistant 中xiaomi_miio.light_eyecare_mode_off动作的用途、适用设备、UI 与 YAML 两种配置方式、参数细节与实战场景。读完本文你将能够在自动化与脚本中可靠地关闭小米飞利浦智睿台灯2Philips Eyecare Smart Lamp 2的护眼模式并能结合该集成提供的相关动作构建完整的用眼健康自动化流程。动作概述与适用设备xiaomi_miio.light_eyecare_mode_off是Xiaomi Home集成ha_domain: xiaomi_miio为灯光平台提供的动作之一作用是关闭护眼模式eyecare mode。需要特别强调的是该动作仅适用于 Philips Eyecare Smart Lamp 2小米飞利浦智睿台灯2。这一点在动作文档中明确标注也在集成文档的灯光平台部分得到印证Xiaomi Home 集成文档 在 Philips Eyecare Smart Lamp 2 小节中列出其支持的模型为philips.light.sread1并明确该设备具备以下与护眼相关的可控能力Eyecare light护眼灯开/关Ambient light氛围灯开/关两路灯光各自的亮度Brightness场景Scene 1/2/3/4夜灯模式Night light mode开/关延时关灯Delayed turn off以秒为粒度眼疲劳提醒/通知Eye fatigue reminder开/关Eyecare mode护眼模式开/关——即本文动作控制的功能设备暴露的属性中包括eyecare_mode与reminder这意味着护眼模式的当前状态可以通过实体的属性实时读取供自动化条件判断使用。Xiaomi Home 集成共为 Philips Eyecare Smart Lamp 2 提供了 6 个相关动作除本文主角外还包括xiaomi_miio.light_eyecare_mode_on——开启护眼模式文档xiaomi_miio.light_reminder_on/xiaomi_miio.light_reminder_off——开启/关闭眼疲劳提醒xiaomi_miio.light_night_light_mode_on/xiaomi_miio.light_night_light_mode_off——开启/关闭夜灯模式使用前准备接入小米飞利浦台灯2在调用该动作之前需要先将台灯接入 Home Assistant。根据 Xiaomi Home 集成文档 的前置要求设备须先使用Mi Home米家App完成初始化设置而不是使用厂商专用 App。通过 Home Assistant 的配置流config flow添加 Xiaomi Home 集成推荐在配置时提供 Xiaomi 账号凭据集成会自动连接你的设备。需要指定账号所属的服务器区域可选区域为cn、de、i2、ru、sg和us即配置设备时在米家 App 中使用的服务器。完成配置后台灯2会以light实体出现在 Home Assistant 中典型实体 ID 形如light.eyecare_lamp此时xiaomi_miio.light_eyecare_mode_off动作即可正常使用。在自动化与脚本中使用UI 方式该动作支持从 Home Assistant 的可视化编辑器中配置无需手写 YAML。官方文档给出了完整的操作步骤进入SettingsAutomations scenes。打开一个已有的自动化或脚本如果是新建选择Create automationCreate new automation。若在创建新的自动化需在When区块添加触发器脚本则不需要触发器——脚本由其他自动化、语音助手或仪表盘按钮等主动调用。在Then do区块选择Add action。在搜索框中搜索并选择Xiaomi Home: Light eyecare mode off。点击Save保存。UI 中的选项选项说明Entity ID指定要操作的 Philips Eyecare Smart Lamp 2 实体。留空则作用于所有已接入的该类台灯需要注意该动作不支持 targets目标定位机制因此在 UI 中只能通过Entity ID字段手动指定作用对象。在 YAML 中调用该动作如果你习惯直接编写 YAML或希望精确掌控 Home Assistant 底层行为可以按如下方式引用动作。动作的完整调用名称是xiaomi_miio.light_eyecare_mode_off。基础示例官方文档给出的最小可用示例如下action: xiaomi_miio.light_eyecare_mode_off data: entity_id: light.eyecare_lamp该示例会关闭light.eyecare_lamp这台台灯的护眼模式。YAML 参数详解字段说明是否必填类型entity_id要操作的 Philips Eyecare Smart Lamp 2 实体。省略时作用于所有此类台灯否string 或 list其中entity_id支持字符串或字符串列表两种类型。列表形式可用于一次关闭多台台灯的护眼模式action: xiaomi_miio.light_eyecare_mode_off data: entity_id: - light.eyecare_lamp - light.eyecare_lamp_2在自动化中结合触发器使用将动作嵌入完整自动化示例——例如在深夜就寝时自动关闭护眼模式alias: Turn off eyecare mode at bedtime trigger: - platform: time at: 22:30:00 condition: - condition: state entity_id: light.eyecare_lamp attribute: eyecare_mode state: true action: - action: xiaomi_miio.light_eyecare_mode_off data: entity_id: light.eyecare_lamp mode: single上面示例中条件部分读取了台灯实体的eyecare_mode属性该属性在集成文档的 Philips Eyecare Smart Lamp 2 特性列表 中有明确记载确保仅在护眼模式已开启时才执行关闭动作避免无效调用。在脚本中使用脚本中无需触发器可被其他流程反复调用。例如定义一个切换护眼模式关闭的复用脚本alias: Eyecare mode off (all lamps) sequence: - action: xiaomi_miio.light_eyecare_mode_off由于entity_id为可选字段省略时动作会作用于所有已接入的 Philips Eyecare Smart Lamp 2适合在全屋统一管理的场景下批量关闭。与相关动作配合构建完整的用眼健康流程Xiaomi Home 集成文档指出对于 Philips Eyecare Smart Lamp 2集成提供的动作可toggle the reminder, night light, and eyecare modes切换提醒、夜灯与护眼模式。因此可以将本文动作与以下动作组合成一套完整的护眼自动化开启护眼模式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_night_light_mode_on/xiaomi_miio.light_night_light_mode_off——适合夜间低亮度使用场景。示例有人状态检测到离开书桌区域时自动关闭护眼模式与提醒alias: Leave desk, stop eyecare triggers: - trigger: state entity_id: binary_sensor.desk_occupancy to: off actions: - action: xiaomi_miio.light_eyecare_mode_off data: entity_id: light.eyecare_lamp - action: xiaomi_miio.light_reminder_off data: entity_id: light.eyecare_lamp mode: single常见问题与排障要点动作不生效首先确认设备型号为philips.light.sread1Philips Eyecare Smart Lamp 2。该动作不支持其他飞利浦灯具型号如 LED Ball Lampphilips.light.bulb、天花板灯philips.light.ceiling等这些设备没有护眼模式功能。无法发现设备根据 Xiaomi Home 集成排障章节设备不能跨子网/VLAN 通信UDP 源地址问题且需用米家 App 而非厂商专用 App 绑定设备。复杂网络环境请参考 python-miio 文档的跨子网发现方案。想确认当前是否已开启护眼模式直接读取台灯实体的eyecare_mode布尔属性即可无需反复调用开关动作。UI 中没有找到该动作确认已通过配置流成功接入 Xiaomi Home 集成且台灯实体正常在线动作列表基于已加载的集成动态生成。小结xiaomi_miio.light_eyecare_mode_off是 Xiaomi Home 集成为 Philips Eyecare Smart Lamp 2philips.light.sread1提供的护眼模式关闭动作。它既支持在自动化/脚本的可视化编辑器中通过Xiaomi Home: Light eyecare mode off快速配置也支持以xiaomi_miio.light_eyecare_mode_off在 YAML 中精确调用唯一的可选参数entity_id支持单个实体或实体列表留空即作用于全部此类台灯。配合light_eyecare_mode_on、light_reminder_on/off与夜灯模式动作可以轻松搭建一套贴合实际作息的全自动用眼健康管理方案。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考