自动化操作

automations 结构体是自动化脚本的核心。您可以在此处指定自动化行为,包括启动方式、条件和操作。这些条件和操作统称为自动化规则。

automations 结构体包含一条或多条自动规则,每条规则始终包含一组启动方式和操作。规则可以选择性地包含条件,这些条件是必须满足的额外限定条件,脚本才能执行。

密钥 类型 说明

name

String

可选

自动化操作的名称。

此名称不会向用户显示,仅供开发者参考。

starters

[入门版]

必填

启动器列表。

condition

Condition

可选

条件

actions

[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

查看操作的完整列表。