automations 结构体是自动化脚本的核心。您可以在此处指定自动化行为,包括启动方式、条件和操作。这些条件和操作统称为自动化规则。
automations 结构体包含一条或多条自动规则,每条规则始终包含一组启动方式和操作。规则可以选择性地包含条件,这些条件是必须满足的额外限定条件,脚本才能执行。
| 密钥 | 类型 | 说明 |
|---|---|---|
|
|
可选 自动化操作的名称。 此名称不会向用户显示,仅供开发者参考。 |
|
|
|
[入门版] |
必填 启动器列表。 |
|
|
可选 条件 |
|
|
|
[Action] |
必填 操作列表 |
示例
以下是 automations 结构的两个入门示例。
在第一个示例中,当名为“我的电视”的 TV 开启时,自动化操作会启动。
触发后,系统会执行以下操作:
两个 LIGHT 设备(名为“灯 A”和“灯 B”)已开启,并设置为亮度级别 50。
automations:
- name: Dim the lights
starters:
- type: device.state.OnOff
device: My TV - Living Room
state: on
is: true
actions:
- type: device.command.OnOff
devices:
- Light A - Living Room
- Light B - Living Room
on: true
- type: device.command.BrightnessAbsolute
devices:
- Light A - Living Room
- Light B - Living Room
brightness: 50
在第二个示例中,同一自动化操作会在每周一和周四的日落时启动:
automations:
- name: Dim the lights
starters:
- type: time.schedule
at: SUNSET
weekday:
- MONDAY
- THURSDAY
state: on
is: true
actions:
- type: device.command.OnOff
devices:
- Light A - Living Room
- Light B - Living Room
on: true
- type: device.command.BrightnessAbsolute
devices:
- Light A - Living Room
- Light B - Living Room
brightness: 50
首发阵容
启动方式结构体用于指定导致自动化脚本执行的启动方式。每个 automation 可能包含一个或多个启动方式,并且至少有一个启动方式的评估结果必须为 true,系统才会评估后续条件。
time.schedule 启动器示例:
type: time.schedule
at: sunrise+30min
weekdays:
- MON
- TUE
以下是设备状态变化启动器的示例:
type: device.state.Volume
device: My TV - Living Room
state: currentVolume
greaterThan: 1
lessThan: 10
设备事件启动器示例:
type: device.event.DoorbellPress
device: My doorbell - Frontdoor
以下是基于住宅在家/外出模式变化的启动方式示例:
type: home.state.HomePresence
state: homePresenceMode
is: HOME
条件
条件可以与逻辑运算符 and、or 和 not 结合使用,以表达更复杂的逻辑。
在以下示例中,有一个 condition 结构体,其中包含一个 time 条件和一个 device.state 条件。此 Struct 允许脚本在以下情况下运行:在周一或周二的日落和日出之间,或者电视音量在 1 到 10 之间:
type: or
conditions:
- type: time.between
before: sunrise
after: sunset
weekdays:
- MON
- TUE
- type: device.state
device: My TV - Living Room
trait: Volume
state: currentVolume
greaterThanOrEqualTo: 1
lessThanOrEqualTo: 10
以下是一个基本的 time 条件示例,它将自动化脚本的执行时间限制在周末上午 10:00 之前:
type: time.between
before: 10am
weekdays:
- SAT
- SUN
温控器设备传感器温度条件:
type: device.state.TemperatureSetting
device: My Thermostat - Living Room
state: thermostatTemperatureAmbient
greaterThan: 65F
home.state.HomePresence 条件示例:
type: home.state.HomePresence
state: homePresenceMode
is: AWAY
操作
与启动方式和条件一样,每个操作都有一个 type,用于指示正在指定的操作类型。
最重要且最有用的是 device.command 命令类型。关灯的操作示例。
type: device.command.OnOff
devices:
- Light A - Living Room
on: false
在多项其他操作之间添加延迟的操作。
type: time.delay
for: 5min