Room Summary Card 背景图片配置完全指南

背景图片功能概述

Room Summary Card 提供了强大的背景图片支持功能，让用户可以创建视觉上更加丰富的房间概览界面。该功能支持多种图片源，并具备智能回退机制和全面的自定义控制能力。

自动区域图片功能

当您在系统中为区域设置了图片时，卡片会自动使用这些图片作为背景：

type: custom:room-summary-card
area: living_room

这个功能无需额外配置，系统会自动检测并应用区域关联的图片。这是最简单的背景设置方式，适合希望快速实现美观界面的用户。

自定义背景图片配置

如果您希望覆盖自动区域图片，可以使用自定义图片路径：

type: custom:room-summary-card
area: living_room
background:
  image: /local/images/living-room.jpg
  opacity: 30  # 设置30%透明度

自定义图片路径支持系统内的本地路径，也支持外部URL。透明度设置范围为0-100，0为完全透明，100为完全不透明。

动态图片实体功能

Room Summary Card 支持使用动态图片实体作为背景，这些图片会随着实体状态变化而自动更新：

type: custom:room-summary-card
area: bedroom
background:
  image_entity: person.john  # 使用人员的头像
  opacity: 40

type: custom:room-summary-card
area: security_room
background:
  image_entity: camera.front_door  # 使用实时摄像头画面
  opacity: 25

动态图片实体特别适合以下场景：

• 人员追踪：显示当前房间内人员的头像
• 安防监控：显示实时摄像头画面
• 动态图片：显示随时间变化的图片

背景图片优先级系统

Room Summary Card 采用智能的图片选择优先级机制：

1. image_entity：优先使用动态图片实体
2. image：其次使用自定义图片路径
3. area.picture：最后回退到区域默认图片

这种机制确保了即使某些图片源不可用，卡片也能显示合适的背景。

背景透明度控制

透明度控制是美化界面的重要工具：

background:
  image: /local/images/room.jpg
  opacity: 50  # 50%透明度

如果不指定透明度，卡片会根据当前主题模式自动调整：

• 浅色模式：使用标准透明度值
• 深色模式：根据实体状态调整透明度

禁用背景图片功能

在某些情况下，您可能需要完全禁用背景图片：

background:
  options:
    - disable

或者结合其他功能标志使用：

features:
  - hide_room_icon  # 隐藏房间图标
background:
  options:
    - disable

禁用背景图片可以获得更简洁的界面，适合信息密集的仪表盘。

实用配置示例

人员实体背景示例

type: custom:room-summary-card
area: master_bedroom
background:
  image_entity: person.john
  opacity: 35
features:
  - hide_room_icon  # 简洁风格

摄像头背景示例

type: custom:room-summary-card
area: garage
background:
  image_entity: camera.garage_cam
  opacity: 20

带回退的图片配置

type: custom:room-summary-card
area: living_room
background:
  image_entity: image.room_photo  # 首选图片实体
  image: /local/images/fallback.jpg  # 备用图片
  opacity: 30

最佳实践建议

1. 图片选择：选择高分辨率但文件大小适中的图片，确保加载速度
2. 透明度设置：建议30-50%透明度，既能美化界面又不影响内容阅读
3. 动态更新：对于频繁变化的图片实体，考虑设置合理的刷新间隔
4. 性能优化：大量使用动态图片时，注意系统资源消耗

通过合理配置Room Summary Card的背景图片功能，您可以创建既美观又实用的智能家居界面，提升整体用户体验。