請參閱下列指南，瞭解如何使用各種 Automation DSL 節點建構自動化程序。
所有自動化 DSL 都會放在單一 automation 節點中。automation 節點會形成外部 Swift 語言情境與內嵌 DSL 情境之間的界線。
依序流程
依序流程是自動化流程的預設類型。
以下是相當基本的 Automation DSL 範本，使用由啟動條件、限制條件和動作組成的循序流程：
import GoogleHomeSDK
import GoogleHomeTypes
automation (
...
) {
starter(...)
condition {...}
action {...}
}
您可以新增節點來調整路徑。
Starter
啟動條件節點會定義啟動自動化動作的初始情況。例如狀態或值的變更。自動化程序必須至少有一個啟動器，否則無法通過驗證。如要在自動化巨集中新增多個啟動器，必須使用 select 節點。
根據特徵屬性建立的入門款
宣告以特徵屬性為基礎的啟動器節點時，請指定：
- 裝置
- 特徵所屬的裝置類型
- 特徵
starter(
thermostat,
Matter.TemperatureSensorDeviceType.self,
Matter.TemperatureMeasurementTrait.self
)
裝置類型參數為必要參數，因為您可藉此指定自動化程序要處理的裝置類型。舉例來說，裝置可能由 FanDeviceType 和 HeatingCoolingUnitDeviceType 組成，兩者都包含 OnOffTrait 特徵。指定裝置類型後，系統就能明確知道裝置的哪個部分會觸發自動化動作。
根據活動的起跑者
宣告以事件為基礎的啟動節點時，請指定：
- 裝置
- 特徵所屬的裝置類型
- 活動
starter(
doorbell,
Google.GoogleDoorbellDeviceType.self,
Google.DoorbellPressTrait.DoorbellPressedEvent
)
根據結構和事件 (含參數) 建立啟動條件
部分事件可能含有參數，因此這些參數也必須納入啟動器。
舉例來說，這個啟動條件會使用 TimeTrait 的 ScheduledEvent 在早上 7 點啟動自動化動作：
typealias TimeTrait = Google.TimeTrait
let earlyMorning = starter(
structure,
TimeTrait.ScheduledEvent.self
) {
TimeTrait.ScheduledEvent.clockTime(TimeOfDay(hours: 7, minutes: 0))
}
手動啟動
手動啟動條件是一種特殊的啟動條件，可讓使用者手動執行自動化動作。
宣告手動啟動器時：
- 請勿指定特性或裝置類型。
- 提供呼叫
Automation.execute()的 UI 元素。
在 select 流程中手動放置啟動條件時，如果同時放置其他啟動條件，手動啟動條件會覆寫其他啟動條件：
select {
manualStarter()
starter(
thermostat,
Matter.TemperatureSensorDeviceType.self,
Matter.TemperatureMeasurementTrait.self
)
}
請注意，系統會評估手動啟動器後方的任何 condition 節點，並視 condition 運算式而定，可能會封鎖自動化作業的執行。
如要建構自動化動作，讓 condition 節點不會封鎖透過手動啟動條件啟動的自動化動作，其中一種方法是將其他啟動條件及其 condition 放在個別的循序流程中：
import GoogleHomeSDK
import GoogleHomeTypes
automation (
...
) {
select {
sequential {
starter(...)
condition {...}
}
sequential {
manualStarter()
}
}
action {...}
}
參照屬性值
如要在運算式中使用屬性的值，請使用下列語法。
使用 stateReader：
typealias TimeTrait = Google.TimeTrait
let time = stateReader(structure, TimeTrait.self)
time
let currTime = time.currentTime
使用 starter：
typealias LaundryWasherDeviceType = Matter.LaundryWasherDeviceType
typealias OnOffTrait = Google.OnOffTrait
let starterNode = starter(device1, LaundryWasherDeviceType.self, OnOffTrait.self)
starterNode
condition {
starterNode.onOff.equals(true)
}
條件節點和運算式
條件節點代表決策點，可決定自動化作業是否繼續執行。自動化動作可以有多個 condition 節點。
如果任何 condition 節點的運算式評估結果為 false，整個自動化程序就會終止。
在 condition 節點中，只要運算式評估為單一布林值，您就可以使用各種運算子合併多個條件準則。如果結果值為 true，則符合條件，自動化作業會繼續執行下一個節點。如果是 false，自動化動作就會在該點停止執行。
運算式的形成方式與 Swift 中的運算式類似，可能包含原始值 (例如數字、字元、字串和布林值)，以及列舉值。使用半形括號將子運算式分組，即可控制運算式的評估順序。
以下是 condition 的範例，可將多個子運算式合併為單一運算式：
condition {
let exp1 = starterNode.lockState.equals(.unlocked)
let exp2 = stateReaderNode.lockState.equals(true)
let exp3 = occupancySensingDevice.occupied.notEquals(0)
(exp1.and(exp2)).or(exp3)
}
您可以參照透過啟動器存取的特徵值：
typealias OnOffTrait = Matter.OnOffTrait
let starterNode = starter(device, OnOffTrait.self)
starterNode
condition {
starterNode.onOff.equals(true)
}
val starterNode = starter<_>(device, OnOff)
condition() { expression = starterNode.onOff equals true }
stateReader
在 condition 節點中參照特徵屬性值的另一種方式是使用 stateReader 節點。
如要這麼做，請先在 stateReader 節點中擷取特徵屬性值。stateReader 會將 structure 和特徵做為引數：
typealias ActivatedCarbonFilterMonitoringTrait = Matter.ActivatedCarbonFilterMonitoringTrait
let filterMonitoringState = stateReader(structure, ActivatedCarbonFilterMonitoringTrait.self)
然後在 condition 節點中參照 stateReader：
condition {
filterMonitoringState.changeIndication.equals(.warning)
}
使用比較和邏輯運算子，condition 節點中可使用多個 stateReaders：
typealias ArmDisarm = Google.ArmDisarmTrait
typealias DoorLockDevice = Matter.DoorLockDeviceType
typealias DoorLock = Matter.DoorLockTrait
let armState = stateReader(doorLock, DoorLockDevice.self, ArmDisarm )
let doorLockState = stateReader(doorLock, DoorLockDevice.self, DoorLock)
armState
doorLockState
condition {
let exp1 = armState.armState
let exp2 = doorLockState.lockState
exp1.and(exp2)
}
條件時間長度
除了條件中的布林值運算式，您還可以指定時間範圍，只有在該範圍內運算式為 true 時，自動化動作才會執行。舉例來說，您可以定義條件，只有在燈亮了十分鐘後才觸發。
condition(for: .seconds(600)) {
lightStateReader.onOff.equals(true)
}
時間長度可設定為 1 到 30 分鐘。
動作節點
自動化作業的實際工作會在動作節點中進行。
在本範例中，動作會叫用 AssistantBroadcastTrait 的 broadcast() 指令：
action(speaker, SpeakerDeviceType.self) {
Google.AssistantBroadcastTrait.broadcast(msg: "Oven Cycle Complete")
}