Persistent Notification

Persistent Notification 集成可用于在前端显示必须由你手动关闭的通知。

自动化

持久通知触发器可在持久通知更新时触发自动化。可通过为 notification_id 提供 ID 将触发器限制为特定通知；若省略该值，则自动化会对任意通知 ID 触发。若未提供 update_type，自动化会在以下更新类型时触发：added、removed、updated 或 current。若在 update_type 选项中提供其中一个或多个值，则仅在这些 update_type 事件发生时触发。

完整细节请参阅 Home Assistant 自动化入门指南或自动化文档。

YAML 中持久通知触发器示例如下：

automation:
  - triggers:
      - trigger: persistent_notification
        # Optional. Possible values: added, removed, updated, current
        update_type:
          - added
          - removed
        # Optional.
        notification_id: invalid_config

可用于条件或动作的更多触发数据，请参阅自动化触发器变量：Persistent Notification。

动作：Create

persistent_notification.create 动作用于创建带有消息、标题和通知 ID 的持久通知。

Data attribute	Optional	Description
`message`	no	通知正文。
`title`	yes	通知标题。
`notification_id`	yes	如果提供 `notification_id`，且已存在相同 ID 的通知，则会覆盖该通知。

下面是你的自动化配置中使用静态内容的action示例。

actions:
  - action: persistent_notification.create
    data:
      message: "Your message goes here"
      title: "Custom subject"

如果你想显示运行时信息，需要使用模板。

actions:
  - action: persistent_notification.create
    data:
      title: >
        Thermostat is {{ state_attr('climate.thermostat', 'hvac_action') }}
      message: "Temperature {{ state_attr('climate.thermostat', 'current_temperature') }}"

persistent_notification.dismiss 动作需要提供 notification_id。

Data attribute	Optional	Description
`notification_id`	no	必须提供 `notification_id` 以标识要移除的通知。

此动作允许你通过脚本或自动化移除通知。

actions:
  - action: persistent_notification.dismiss
    data:
      notification_id: "1234"

persistent_notification.dismiss_all 动作允许你移除所有通知。

actions:
  - action: persistent_notification.dismiss_all

Markdown 支持

message 属性支持 Markdown 格式语法。示例如下：

类型	消息
一级标题	`# Headline`
二级标题	`## Headline`
换行	`\n`
粗体	`My bold text`
斜体	`My italic text`
链接	`[Link](https://home-assistant.io/)`
图片	`![Home Assistant my image](/home-assistant/local/my_image.jpg)`

Note

此处的 /local/ 指向 .homeassistant/www/ 文件夹。

创建持久通知

前往设置 > 开发者工具 > 动作，然后在动作下拉框中选择 persistent_notification.create。在 data 字段中输入类似下方示例的内容，并点击 执行动作。

{
  "notification_id": "1234",
  "title": "Sample notification",
  "message": "This is a sample text."
}

这将创建上方所示的通知条目。

作为通知器使用

如果已加载 Notify 集成，持久通知也可作为预配置通知器使用，对应实体为 notify.persistent_notification。这样即可用于需要通知器的功能，例如通知组或 Alert 集成。

可在 data 中使用以下属性以扩展功能。

Data attribute	Optional	Description
`notification_id`	yes	如果提供 `notification_id`，且已存在相同 ID 的通知，则会覆盖该通知。

#Persistent Notification

#自动化

#动作：Create

#Markdown 支持

#创建持久通知

#作为通知器使用

Persistent Notification

自动化

动作：Create

Markdown 支持

创建持久通知

作为通知器使用