Skip to main content

通知实体

通知实体是一个能够向设备或服务发送消息的实体,但从 Home Assistant 的角度来看,它保持无状态。

通知实体派生自 homeassistant.components.notify.NotifyEntity, 可以用于发送通知消息,例如(但不限于):

  • 短信
  • 电子邮件
  • 直接消息或聊天
  • 在设备的 LCD 显示屏上显示的屏幕消息

状态

通知实体的状态是一个时间戳,表示最后发送的消息的日期和时间。 与 text 实体不同,notify 实体没有可以设置的状态。

如果您想表示某种可以改变的文本值(因此具有实际状态),您应该使用 text 实体。

属性

由于此集成是无状态的,因此它没有为自身提供任何特定的属性。 所有实体共有的其他属性,如 iconname 等仍然适用。

方法

发送消息

发送消息方法用于向设备或服务发送消息。

class MyNotifier(NotifyEntity):
# 实现以下方法之一。

def send_message(self, message: str, title: str | None = None) -> None:
"""发送消息。"""

async def async_send_message(self, message: str, title: str | None = None) -> None:
"""发送消息。"""