场景实体
场景实体是一个能够为一组实体再现所需状态的实体。场景实体可以激活场景以控制一组设备,但从 Home Assistant 的角度来看,它依然是无状态的。
场景实体衍生自 homeassistant.components.scene.Scene
。
如果您想表示可以开关的东西(因此具有实际状态),则应该使用 switch
实体。
场景实体还可以通过场景编辑器或 YAML 由用户创建。
属性
由于该集成是无状态的,因此它没有为自己提供任何特定属性。
所有实体共有的其他属性,如 icon
和 name
等,仍然适用。
方法
激活
激活场景。
class MySwitch(Scene):
# 实现这些方法之一。
def activate(self, **kwargs: Any) -> None:
"""激活场景。尝试将实体置于请求的状态。"""
async def async_activate(self, **kwargs: Any) -> None:
"""激活场景。尝试将实体置于请求的状态。"""
激活方法可用于激活特定设备或服务的场景。
当用户按下场景 activate
按钮或调用 scene.turn_on
动作以激活场景时,Home Assistant 会调用它。
可用的设备类别
没有特定的设备类别。场景实体上未 设置 device_class
属性。