Room Summary Card 实体颜色配置完全指南

前言

Room Summary Card 作为智能家居控制面板的重要组成部分，其视觉呈现效果直接影响用户体验。本文将深入讲解如何通过颜色配置打造个性化的房间概览界面，让您的控制面板既美观又实用。

颜色配置基础

两种配置方式对比

1. 卡片配置（推荐）

• 直接在卡片YAML中定义颜色
• 优先级最高，适合临时调整
• 配置示例：

entities:
  - entity_id: light.bedroom
    on_color: warm-white
    off_color: dark-grey
    icon_color: '#FFD700'

2. 实体属性配置

• 通过Home Assistant的customize功能全局设置
• 适合需要长期保持的配色方案
• 配置示例：

customize:
  light.living_room:
    on_color: amber
    off_color: disabled

颜色类型详解

主题颜色名称

Room Summary Card 支持丰富的预设颜色，分为两类风格：

简约风格：

• 基础色系：红(red)、绿(green)、黄(yellow)等
• theme 特殊值：自动匹配当前主题色

Home Assistant完整色板：

• 包含Material Design完整色系
• 如：primary(主色)、accent(强调色)、deep-purple(深紫)等
• 系统级颜色：disabled(禁用灰)、light-grey(浅灰)等

HEX颜色代码

需要精确控制颜色时，可使用十六进制代码：

entities:
  - entity_id: light.kitchen
    on_color: '#FFA726'  // 橙色
    off_color: '#455A64' // 深蓝灰

专业建议：从品牌官网获取HEX色值，可实现设备品牌色统一

颜色优先级机制

理解颜色应用顺序很重要，系统按以下顺序判断：

1. 卡片配置：最直接的设置
2. 实体属性：全局默认值
3. RGB属性：自动获取设备的rgb_color
4. 主题颜色：根据当前UI主题自动适配
5. 领域默认：按实体类型(如switch/light)应用默认色

实战配置案例

流媒体服务主题

entities:
  - entity_id: media_player.spotify
    icon_color: '#1DB954' # Spotify绿
  - entity_id: media_player.apple_tv
    icon_color: '#000000' # 苹果黑

安防状态指示

entities:
  - entity_id: binary_sensor.door
    icon: mdi:door
    on_color: red     # 门开报警
    off_color: green  # 门关安全
  - entity_id: alarm_control_panel.home
    icon_color: amber # 预警状态

智能品牌统一

entities:
  - entity_id: switch.sonoff
    on_color: '#1E88E5' # Sonoff蓝
  - entity_id: vacuum.xiaomi
    icon_color: '#FF6700' # 小米橙

高级技巧

混合配置策略

# 卡片中覆盖重要实体
entities:
  - entity_id: light.main
    on_color: purple # 优先使用

# customize.yaml中设置全局默认
customize:
  light.main:
    off_color: blue-grey # 次要属性

RGB设备智能适配

对于彩色灯光设备：

entities:
  - entity_id: light.hue_color
    # 不设颜色时自动显示当前灯光颜色
  - entity_id: light.hue_white
    on_color: warm-white # 覆盖默认值

设计原则建议

1. 一致性：同一房间保持相同色系
2. 可读性：确保颜色对比度足够
3. 语义化：用颜色传递状态信息（如红色表示警报）
4. 适度原则：避免使用过多鲜艳颜色造成视觉疲劳

通过合理运用这些颜色配置技巧，您的Room Summary Card将不仅功能强大，更能成为智能家居系统的视觉亮点。