2025.3.4
首页 ▸ Dashboards ▸

图片实体卡片

图片实体卡片以图像的形式显示实体。它不仅可以显示来自 URL 的图像，还可以显示 camera 实体的图片。

图片实体卡片 背景根据实体状态变化。

将 图片实体卡片 添加到您的仪表板

  1. 要添加卡片，请按照 从视图添加卡片 的步骤 1-4。

    • 在步骤 2 中，在 按卡片 选项卡上，选择 图片实体卡片。

  2. 添加图片：

    • 上传图片 允许您从显示 Home Assistant 用户界面的系统中选择一张图片。
    • 本地路径 允许您选择存储在 Home Assistant 上的图片。例如：/homeassistant/images/lights_view_background_image.jpg。
    • 网络 URL 允许您使用来自网络的图片。例如 https://www.home-assistant.io/images/frontpage/assist_wake_word.png。

  3. 定义 图片实体卡片 的特定参数。

    • 有关特定设置的描述，请参阅 YAML 配置下的描述。
    • 它们同样适用于用户界面。

  4. 保存您的更改。

YAML 配置

当你使用 YAML 模式或更喜欢在 UI 的代码编辑器中使用 YAML 时，以下 YAML 选项可用。

Configuration Variables

Looking for your configuration file?
type string Required

picture-entity

entity string Required

用于图片的摄像头、图像或人员 entity_id。

camera_image string (Optional)

要使用的摄像头 entity_id。（如果 entity 已经是摄像头实体，则不是必需的。）

camera_view string (Optional, default: auto)

“live” 将显示实时视图，如果 stream 已启用。

image string (Optional)

图像的 URL。要使用本地托管的图像，请参见 托管。

state_image map (Optional)

将实体状态映射到图像（state: image URL，请查看下面的示例）。

state_filter map (Optional)

基于状态的 CSS 过滤器

aspect_ratio string (Optional)

强制图像的高度与宽度成比例。有效格式：高度百分比值（23%）或以冒号或 “x” 分隔符表示的比率（16:9 或 16x9）。对于比率，第二个元素可以省略，将默认为 “1”（1.78 等于 1.78:1）。

fit_mode string (Optional, default: cover)

定义图像如何拉伸/裁剪以适应卡片区域。cover：图像保持其纵横比并填充给定尺寸。图像将被裁剪以适应。contain：图像保持其纵横比，但被调整大小以适应给定尺寸。fill：图像被调整大小以填充给定尺寸。如果需要，图像将被拉伸或压缩以适应。

name string (Optional)

重写实体名称。

show_name boolean (Optional, default: true)

在页脚中显示名称。

show_state boolean (Optional, default: true)

在页脚中显示状态。

theme string (Optional)

使用任何已加载主题覆盖此卡的主题。有关主题的更多信息，请参见 前端文档。

tap_action map (Optional)

点击卡片时采取的操作。请参见 操作文档。

hold_action map (Optional)

点击并按住卡片时采取的操作。请参见 操作文档。

double_tap_action map (Optional)

双击卡片时采取的操作。请参见 操作文档。

如何使用 state_filter

指定不同的 CSS 过滤器

state_filter:
  "on": brightness(110%) saturate(1.2)
  "off": brightness(50%) hue-rotate(45deg)

示例

基本示例：

type: picture-entity
entity: light.bed_light
image: /local/bed_light.png

每个状态的不同图像：

type: picture-entity
entity: light.bed_light
state_image:
  "on": /local/bed_light_on.png
  "off": /local/bed_light_off.png

显示来自 FFmpeg 摄像头的实时画面：

type: picture-entity
entity: camera.backdoor
camera_view: live
tap_action:
  action: perform-action
  perform_action: camera.snapshot
  data:
    entity_id: camera.backdoor
    filename: '/shared/backdoor-{{ now().strftime("%Y-%m-%d-%H%M%S") }}.jpg'

文件名需要是您的系统中 Home Assistant 可写的路径。您可能需要配置 allowlist_external_dirs （文档）。

相关主题