Bu makalede, Android'deki Automation DSL'nin temel kavramlarına genel bir bakış sunulmaktadır.
Otomasyon bileşenleri
Otomasyonlar genellikle şu sırayla değerlendirilen aşağıdaki temel bileşenlerden oluşur:
- Başlatıcı: Otomasyonu etkinleştiren ilk koşulları (ör. bir özellikteki değişiklik) tanımlar. Otomasyonun başlatıcısı olmalıdır.
- Koşul: Otomasyon etkinleştirildikten sonra değerlendirilecek ek kısıtlamalar. Otomasyon işlemlerinin devam etmesi için bir koşuldaki ifadenin
true
olarak değerlendirilmesi gerekir. - İşlem: Tüm koşullar karşılandığında gerçekleştirilen komutlar veya durum güncellemeleri.
Örneğin, gün batımı ile gün doğumu arasında odadaki TV açıldığında odanın ışıklarını karartan bir otomasyonunuz olabilir. Bu örnekte:
- Başlatma: TV'nin açılması, TV özelliğinde durum değişikliği olarak kabul edilir.
- Koşul: TV'nin bulunduğu evin geçerli saati değerlendirilir.
- İşlem: TV ile aynı odadaki ışıklar karartılır.
Otomasyon, odadaki TV açıldığında etkinleştirilir ancak yalnızca "gün batımı ile gün doğumu arasında" koşulu karşılandığında yürütülür.
Temel yapıya ek olarak, Home API'lerindeki otomasyonlar, geliştiriciler ve kullanıcılar tarafından tanımlanmak için kullanılabilecek ad ve açıklama gibi meta veriler de içerir.
Düğümler
Home API'lerinde bir otomasyonun mantıksal yapısı düğümlerden oluşur. Düğümler, varlık davranışlarını veya yürütme akışlarını temsil eden soyut, yeniden kullanılabilir birimlerdir. Her düğümün giriş değişkenleri ve diğer düğümler tarafından kullanılabilen çıkış değişkenleri olabilir.
Düğüm | Düğüm Türü | Kotlin uygulaması | Açıklama |
---|---|---|---|
Starter | Davranışsal |
StarterNodeDsl
|
Bir özelliğin durumu (herhangi bir özellik) değiştiğinde otomasyon başlatır. |
StateReader | Davranışsal |
StateReaderNodeDsl
|
Bir özellik özelliğini okur ve değerini koşul düğümlerinde kullanılmak üzere yakalamanıza olanak tanır. |
İşlem | Davranışsal |
ActionNodeDsl
|
Özellik komutlarını çağırır. |
Sıralı | Yürütme akışı |
SequentialFlow
|
İç içe yerleştirilmiş işlem düğümlerini sırayla yürütür. Bu, varsayılan yürütme davranışıdır. |
Parallel | Yürütme akışı |
ParallelFlow
|
İç içe yerleştirilmiş işlem düğümlerini paralel olarak yürütür. |
Durum | Yürütme akışı |
ConditionNodeDsl
|
Yürütme akışını, mantıksal ifadelerin değerlendirmelerine göre koşullu olarak değiştirin. Koşullar, bir başlatıcıyla (başlatıcıya özel koşullar) ilişkilendirilebilir veya genel olabilir (tüm başlatıcılar için geçerli). |
Seçin | Yürütme akışı |
SelectFlow
|
Birden fazla başlatıcının otomasyonu etkinleştirmesine izin verir. |
Expression | Değer |
Expression
|
Bir özelliğin özelliğinin değeri, bir sabit veya değişmez değer olabilir ve liste, sayı, Boole veya dize olarak değerlendirilmelidir. |
Davranış düğümleri
Başlatıcılar ve işlemler gibi düğümler, davranış düğümleridir. Başlatıcılar, cihaz özelliği değişikliklerine göre bir otomasyonu etkinleştirir. İşlemler, cihaz komutları gönderir veya özellikleri günceller.
Davranış düğümleri genellikle cihaz özelliklerine ve diğer düğümlerde giriş olarak kullanılmak üzere çıkış özelliği durumuna bağlıdır.
Yürütme akışı düğümleri
Bazı düğümler, sıralı ve paralel gibi yürütme akışlarını temsil eder. Bu düğümlerin her biri, otomasyonu tanımlayan davranış düğümlerini içerir.
Örneğin, sıralı bir akış, sıralı düzende yürütülen düğümler içerebilir. Bunlar genellikle başlangıç, koşul ve işlem olur.
Paralel akışta aynı anda birden fazla işlem düğümü yürütülebilir. Örneğin, aynı anda birden fazla ışık açılabilir. Paralel akışı izleyen düğümler, paralel akışın tüm dalları tamamlanana kadar yürütülmez.
Başka bir yürütme akışı türü olan koşul akışı, bir ifadenin değerlendirilmesine bağlı olarak yürütme akışını değiştirebilir.
Örneğin, gece olup olmamasına göre işlem yapan bir otomasyonunuz olabilir. Bir koşul düğümü günün saatini kontrol eder ve ardından bu değerlendirmeye göre uygun yürütme yolunu izler.
Otomasyonunuzu etkinleştirebilecek birden fazla başlatıcıya sahip olmak istediğinizde seçme akışı kullanışlıdır. select
akışına iki veya daha fazla başlatıcı eklediğinizde otomasyonu başlatıcılardan herhangi biri etkinleştirebilir.
Örneğin, gün batımında, sıcaklık belirli bir eşiğin üzerine çıktığında veya parlaklık eşiği aştığında panjurları indiren bir otomasyon yazabilirsiniz. Bu senaryoların her biri üç ayrı başlatıcı tarafından ele alınır ve üçü de select
akışına dahil edilir.
İç içe yerleştirilmiş akışlar
Karmaşık otomasyonlarda yürütme akışı düğümleri de iç içe yerleştirilebilir. Örneğin, paralel akışı yürüten sıralı bir akışınız olabilir.
DSL düğümleri, aşağıdaki tabloda belirtilen kısıtlamalara göre belirli ihtiyaçlarınızı karşılamak için çeşitli şekillerde iç içe yerleştirilebilir ve birleştirilebilir. Oluşturucu sütunu, her tür düğümde neyin kullanılabileceğini ayrıntılı olarak açıklayan Kotlin tür güvenli oluşturucu dokümanına bağlanır.
Düğüm | Aşağıdaki düğüm türünü ve verileri içerebilir | Aşağıdaki düğüm türlerinden birinde olmalıdır. |
---|---|---|
Starter | İfade | Sıralı seçeneğini belirleyin. |
ManualStarter | Sıralı seçeneğini belirleyin. | |
StateReader | İfade (genellikle bir özellik özelliği değerinden oluşur) | İşlem, Koşul |
İşlem | Komut, Varlık, İfade | Paralel, Seçmeli, Sıralı |
Sıralı | Paralel, Seçmeli, Sıralı | |
Parallel | İşlem | Sıralı |
Durum | İfade | Paralel, Sıralı |
Seçin | Condition, Sequential, Starter, ManualStarter | Sıralı ve akıştaki ilk düğüm olmalıdır. |
Otomasyon DSL'si
Ev API'lerinde otomasyonlar, Automation DSL (alana özgü dil) kullanılarak tanımlanır. Automation DSL, Kotlin tür güvenli oluşturucular kullanılarak Kotlin DSL (alana özgü dil) olarak uygulanır ve özellikle otomasyon şablonlarını tanımlamak için tasarlanmıştır.
Bir otomasyon derlendiğinde, Kotlin tür güvenli oluşturucular Kotlin veri sınıfları oluşturur. Bu sınıflar daha sonra protokol arabelleği JSON'a serileştirilir. Bu JSON, Google'ın Otomasyon Hizmetleri'ne çağrı yapmak için kullanılır.
Otomasyon DSL'si, otomasyon oluşturma sürecini basitleştirir ve kolaylaştırır. Cihaz API'sinde yer alan Matter standart özelliklerin ve smart home özelliklerin veri modelini doğal olarak kullanır.
Otomasyon DSL'si, bir kullanıcının evinde bulunan belirli cihaz örneklerinin aksine, otomasyonun mantığını soyut cihaz türleri açısından da tanımlar. Geliştiricinin, gerçek cihaz örneklerini ve diğer önemli parametre değerlerini belirtmek için çalışma zamanında kullanılabilecek giriş parametreleri sağlamasına olanak tanır.
DSL söz dizimi Kotlin'inkine benzer ve aynı derecede tür güvenlidir. Ancak Automation DSL'de yazılan bir otomasyon, aynı otomasyonun saf Kotlin'de yazılmış halinden daha basit ve kısadır.
Örnek
Aşağıda, Automation DSL kullanılarak yazılmış ve bir cihazı açan örnek bir otomasyon verilmiştir:
val automation = automation {
name = "MyFirstAutomation"
description = "If light1 is on, turn on light2."
isActive = true
sequential {
val onOffTrait = starter<_>(device1, OnOffLightDevice, OnOff)
condition() { expression = onOffTrait.onOff equals true }
action(device2, OnOffLightDevice) { command(OnOff.on()) }
}
}
Bu otomasyon çok basittir: device1
(bir ışık) açıldığında (onOff
özelliği true
olarak değiştiğinde) device2
öğesini açmak için on()
komutunu gönderir.
Otomasyonda, düğümlerinin sırayla çalışacağını belirten bir sequential
düğümü kullanılır.
sequential
düğümünde starter
, condition
ve action
gibi davranış düğümleri bulunur. starter
düğümünün çıkışı, condition
düğümünde kullanılmak üzere bir değişkene atanır.