iOS DSL kılavuzu

Çeşitli otomasyon DSL düğümlerinin bir otomasyon oluşturmak için nasıl kullanılabileceğini anlamak üzere aşağıdaki kılavuzu kullanın.

Tüm otomasyon DSL'leri tek bir automation düğümüne yerleştirilir. automation düğümü, dış Swift dili bağlamı ile yerleşik DSL bağlamı arasındaki sınırı oluşturur.

Sıralı akış

Sıralı akış, varsayılan otomasyon akışı türüdür.

Aşağıda, başlatıcı, koşul ve işlemden oluşan sıralı bir akış kullanan çok basit bir otomasyon DSL şablonu verilmiştir:

import GoogleHomeSDK
import GoogleHomeTypes

automation (
...
) {
  starter(...)
  condition {...}
  action {...}
}

Ek düğümler ekleyerek bu işlemi daha hassas hale getirebilirsiniz.

Başlangıç

Başlatıcı düğümler, bir otomasyonu etkinleştiren ilk koşulları tanımlar. Örneğin, durum veya değer değişikliği. Otomasyonun en az bir başlatıcısı olmalıdır. Aksi takdirde doğrulama başarısız olur. Bir otomasyona birden fazla başlatıcı eklemek için select düğümünü kullanmanız gerekir.

Özellik niteliğine dayalı başlatıcı

Bir özellik niteliğine dayalı başlatıcı düğüm bildirirken şunları belirtin:

• cihaz
• özelliğin ait olduğu cihaz türü
• özellik

starter(
  thermostat,
  Matter.TemperatureSensorDeviceType.self,
  Matter.TemperatureMeasurementTrait.self
)

Cihaz türü parametresi, otomasyonun bir cihazdaki hangi cihaz türünü hedeflediğini belirtmenize olanak tanıdığı için zorunludur. Örneğin, bir cihaz FanDeviceType ve HeatingCoolingUnitDeviceType bileşenlerinden oluşabilir. Bu bileşenlerin her ikisi de OnOffTrait özelliğini içerir. Cihaz türünü belirterek otomasyonu cihazın hangi parçasının tetiklediğiyle ilgili belirsizliği ortadan kaldırabilirsiniz.

Etkinliğe dayalı başlatıcı

Bir etkinliğe dayalı başlatıcı düğüm bildirirken şunları belirtin:

• cihaz
• özelliğin ait olduğu cihaz türü
• etkinlik

starter(
  doorbell,
  Google.GoogleDoorbellDeviceType.self,
  Google.DoorbellPressTrait.DoorbellPressedEvent
)

Parametrelerle birlikte bir yapıya ve etkinliğe dayalı başlatıcı

Bazı etkinliklerin parametreleri olabilir. Bu nedenle, bu parametrelerin de başlatıcıya dahil edilmesi gerekir.

Örneğin, bu başlatıcı, otomasyonu saat 07:00'de etkinleştirmek için TimeTrait cihazının ScheduledEvent özelliğini kullanır:

typealias TimeTrait = Google.TimeTrait

let earlyMorning = starter(
  structure,
  TimeTrait.ScheduledEvent.self
) {
  TimeTrait.ScheduledEvent.clockTime(TimeOfDay(hours: 7, minutes: 0))
}

Hava durumuna dayalı başlatıcı

Hava durumu özelliğini kullanarak başlatıcıda mevcut veya tahmini hava koşullarını belirtebilirsiniz:

let weatherState = starter<_>(structure, trait = Weather)

Örnek otomasyonlar sayfasında Yağmur yağma ihtimali varsa panjurları kapat örneğine bakın.

Manuel başlatıcı

Manuel başlatıcı, kullanıcının otomasyonu manuel olarak çalıştırmasına olanak tanıyan özel bir başlatıcı türüdür.

Manuel başlatıcı tanımlarken:

• Özellik veya cihaz türü belirtmeyin.
• Automation.execute() yöntemini çağıran bir kullanıcı arayüzü öğesi sağlayın.

Manuel başlatıcıyı başka bir başlatıcıyla birlikte select akışına yerleştirdiğinizde manuel başlatıcı, diğer başlatıcıyı geçersiz kılar:

select {
  manualStarter()
  starter(
    thermostat,
    Matter.TemperatureSensorDeviceType.self,
    Matter.TemperatureMeasurementTrait.self
  )
}

Manuel başlatıcıdan sonraki condition düğümlerinin değerlendirileceğini ve condition ifadesine bağlı olarak otomasyonun yürütülmesini engelleyebileceğini unutmayın.

Otomasyonunuzu, condition düğümlerinin manuel başlatıcıyla etkinleştirilen bir otomasyonu engellemeyeceği şekilde yapılandırmanın bir yolu, diğer başlatıcıyı condition ile birlikte ayrı bir sıralı akışa yerleştirmektir:

import GoogleHomeSDK
import GoogleHomeTypes

automation (
...
) {

  select {
    sequential {
      starter(...)
      condition {...}
    }
    sequential {
      manualStarter()
    }
  }
  action {...}

}

Bir özelliğin değerine referans verme

Bir ifadedeki özelliğin değerini kullanmak için aşağıdaki söz dizimini kullanın.

stateReader ile:

typealias TimeTrait = Google.TimeTrait

let time = stateReader(structure, TimeTrait.self)
time
let currTime = time.currentTime

starter ile:

typealias LaundryWasherDeviceType = Matter.LaundryWasherDeviceType
typealias OnOffTrait = Google.OnOffTrait

let starterNode = starter(device1, LaundryWasherDeviceType.self, OnOffTrait.self)
starterNode
condition {
  starterNode.onOff.equals(true)
}

Koşul düğümleri ve ifadeleri

Koşul düğümü, otomasyonun devam edip etmeyeceğini belirleyen bir karar noktasını temsil eder. Bir otomasyonda birden fazla condition düğümü olabilir. Herhangi bir condition düğümünün ifadesi false olarak değerlendirilirse otomasyonun tamamının yürütülmesi sona erer.

condition düğümünde, ifade tek bir boole değeri olarak değerlendirildiği sürece çeşitli operatörleri kullanarak birden fazla koşul ölçütünü birleştirebilirsiniz. Sonuç değeri true ise koşul karşılanır ve otomasyon, sonraki düğümü yürütmeye devam eder. false ise otomasyon o noktada yürütmeyi durdurur.

İfadeler, Swift'teki ifadelere benzer şekilde oluşturulur ve Enum değerlerinin yanı sıra sayılar, karakterler, dizeler ve Boole değerleri gibi temel değerleri içerebilir. Alt ifadeleri parantez içine alarak gruplandırmak, değerlendirilme sırasını kontrol etmenize olanak tanır.

Birden fazla alt ifadeyi tek bir ifadede birleştiren bir condition örneği aşağıda verilmiştir:

condition {
  let exp1 = starterNode.lockState.equals(.unlocked)
  let exp2 = stateReaderNode.lockState.equals(true)
  let exp3 = occupancySensingDevice.occupied.notEquals(0)
  (exp1.and(exp2)).or(exp3)
}

Başlatıcı aracılığıyla erişilen bir özelliğin değerine referans verebilirsiniz:

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 düğümünde özellik niteliği değerlerine referans vermenin diğer yolu, stateReader düğümünü kullanmaktır.

Bunu yapmak için önce özellik niteliği değerini bir stateReader düğümünde yakalayın. stateReader, structure ve özelliği bağımsız değişken olarak alır:

typealias ActivatedCarbonFilterMonitoringTrait = Matter.ActivatedCarbonFilterMonitoringTrait

let filterMonitoringState = stateReader(structure, ActivatedCarbonFilterMonitoringTrait.self)

Ardından condition düğümünde stateReader öğesine referans verin:

condition {
filterMonitoringState.changeIndication.equals(.warning)
}

Karşılaştırma ve mantıksal operatörler kullanılarak bir condition düğümünde birden fazla stateReaders kullanılabilir:

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)
}

Koşul süresi

Koşulda bir boole ifadesinin yanı sıra, otomasyonun çalıştırılması için ifadenin doğru olması gereken bir zaman aralığı belirtebilirsiniz. Örneğin, yalnızca bir ışık on dakika boyunca açık kaldığında tetiklenen bir koşul tanımlayabilirsiniz.

condition(for: .seconds(600)) {
lightStateReader.onOff.equals(true)
}

Süre, 1 ila 30 dakika arasında değişebilir.

İşlem düğümleri

İşlem düğümü, otomasyonun gerçekleştiği yerdir. Bu örnekte işlem, AssistantBroadcastTrait aracının broadcast() komutunu çağırır:

action(speaker, SpeakerDeviceType.self) {
  Google.AssistantBroadcastTrait.broadcast(msg: "Oven Cycle Complete")
}