wait_for_trigger 與 wait_template：寫出「會等待」的自動化

charles · 發表於 3 天前

一般的自動化是「觸發 → 做事 → 結束」。
但有些流程是「做一件事 → 等某件事發生 → 再做下一件」。

這時候就需要 wait。

兩種等待

wait_for_trigger — 等一個「事件發生」（狀態從 A 變成 B）
wait_template — 等一個「條件成立」（現在就成立的話立刻通過）

差別很重要：

# wait_for_trigger：等「變成」 on
- wait_for_trigger:
- trigger: state
entity_id: binary_sensor.門
to: "on"
# 門「已經」是 on 的話，它會繼續等下一次變化（可能永遠等不到）
# wait_template：等「是」 on
- wait_template: "{{ is_state('binary_sensor.門', 'on') }}"
# 門已經是 on 的話，立刻通過

複製代碼

九成的情況你要的是 wait_template，因為你在意的是狀態，不是變化的那一瞬間。

一定要加 timeout

- wait_template: "{{ is_state('binary_sensor.洗衣機', 'off') }}"
timeout: "02:00:00"
continue_on_timeout: true

複製代碼

沒有 timeout 的話，自動化會無限期卡在那裡。
它會一直佔著一個執行位置，而且在「執行中」的自動化裡看得到，
但你不會注意到 —— 直到某天發現這個自動化再也沒動過。

continue_on_timeout: true（預設）— 逾時就繼續往下跑
continue_on_timeout: false — 逾時就整個中止

怎麼知道是等到了還是逾時

wait 之後會有一個 wait.completed 變數：

- wait_template: "{{ is_state('binary_sensor.洗衣機','off') }}"
timeout: "02:00:00"
- choose:
- conditions: "{{ wait.completed }}"
sequence:
- action: notify.mobile_app_charles
data: {message: 洗衣完成}
default:
- action: notify.mobile_app_charles
data: {message: 洗衣機跑超過兩小時了，去看一下？}

複製代碼

用 wait_for_trigger 的話還有 wait.trigger，
裡面是「是哪個觸發器完成的」，可以配多個觸發器分流。

完整範例一：洗衣機完成通知

這個是用功率判斷，不需要洗衣機本身智能。

alias: 洗衣機完成通知
triggers:
# 功率超過 100W 持續 1 分鐘 = 開始洗了
- trigger: numeric_state
entity_id: sensor.洗衣機功率
above: 100
for: "00:01:00"
actions:
- action: notify.mobile_app_charles
data:
message: 洗衣機開始運轉
# 等功率掉到 5W 以下並維持 3 分鐘 = 洗完了
# （中間脫水前會短暫低功率，所以 for 不能太短）
- wait_template: >
{{ states('sensor.洗衣機功率') | float(999) < 5 }}
timeout: "03:00:00"
continue_on_timeout: true
- choose:
- conditions: "{{ wait.completed }}"
sequence:
- action: notify.mobile_app_charles
data:
title: 洗衣完成
message: 衣服放太久會有味道，記得去晾
data:
actions:
- action: SNOOZE_LAUNDRY
title: 十分鐘後再提醒
default:
- action: notify.mobile_app_charles
data:
message: 洗衣機跑三小時了還沒停，可能卡住了
mode: single

複製代碼

那個 for: 3 分鐘是重點。
洗衣機在換程序的時候功率會短暫歸零，沒有 for 的話會提早通知。

完整範例二：離家後確認門鎖

alias: 離家後五分鐘確認門鎖
triggers:
- trigger: state
entity_id: person.charles
to: not_home
actions:
- delay: "00:05:00"
- if:
- condition: state
entity_id: lock.前門
state: unlocked
then:
- action: notify.mobile_app_charles
data:
title: 門沒鎖
message: 要幫你鎖嗎？
data:
actions:
- action: LOCK_DOOR
title: 鎖上
# 等使用者按按鈕，最多等 10 分鐘
- wait_for_trigger:
- trigger: event
event_type: mobile_app_notification_action
event_data:
action: LOCK_DOOR
timeout: "00:10:00"
- if: "{{ wait.completed }}"
then:
- action: lock.lock
target: {entity_id: lock.前門}
- action: notify.mobile_app_charles
data: {message: 已鎖上}
mode: single

複製代碼

這個用 wait_for_trigger 是對的，因為「按下按鈕」本來就是一個事件，不是狀態。

範例三：等多個條件其中之一

wait_for_trigger 可以放多個觸發器，任一個成立就繼續：

- wait_for_trigger:
- trigger: state
entity_id: binary_sensor.前門
to: "on"
id: 前門
- trigger: state
entity_id: binary_sensor.後門
to: "on"
id: 後門
timeout: "00:30:00"
- action: notify.mobile_app_charles
data:
message: >
{{ wait.trigger.id if wait.completed else '半小時內沒人回來' }} 有動靜

複製代碼

mode 要怎麼配

有 wait 的自動化一定要想清楚 mode：

同時只該有一個在等 → single（洗衣機那個）
重新觸發要重新計時 → restart
多個對象各自等 → parallel（多扇門各自計時）

用 single 而且經常重複觸發的話，去日誌搜 already running，
看看是不是一直在漏。

wait 跟 delay 的差別

delay — 固定等多久，時間到就繼續
wait — 等到某件事，可能三秒也可能兩小時

有些人用 delay 30 分鐘 來等洗衣機，那是猜的。
用 wait 才是真的知道它洗完了。

---

一個小提醒：wait 期間如果你重新載入自動化或重啟 HA，那次執行就沒了。

所以「等很久」的流程（例如等三小時）要有容錯 ——
我的洗衣機自動化另外加了一個「每天晚上檢查一次洗衣機功率是不是異常」的保險。

		自動登入	找回密碼
密碼			立即註冊

wait_for_trigger 與 wait_template：寫出「會等待」的自動化

瀏覽過的版塊