Android DSL kavramları

Bu makalede, Android'deki Automation DSL'nin temel kavramlarına genel bir bakış sunulmaktadır.

Otomasyon bileşenleri

Otomasyonlar, genellikle bu sırayla değerlendirilen aşağıdaki temel bileşenlerden oluşur:

1. Başlatıcı: Otomasyonu etkinleştiren ilk koşulları (ör. bir özellikteki değişiklik) tanımlar. Otomasyonun bir başlatıcısı olmalıdır.
2. Koşul: Otomasyon etkinleştirildikten sonra değerlendirilecek ek kısıtlamalar. Otomasyon işlemlerinin devam etmesi için bir Koşul'daki ifadenin true olarak değerlendirilmesi gerekir.
3. İş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ı kısan bir otomasyonunuz olabilir. Bu örnekte:

1. Başlatma: TV'nin açılması, TV özelliğinde durum değişikliği olarak kabul edilir.
2. Koşul: TV'nin bulunduğu evin geçerli saati değerlendirilir.
3. İşlem: TV ile aynı odadaki ışıklar karartılıyor.

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, 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 ve yeniden kullanılabilir birimlerdir. Her düğümde giriş değişkenlerinin yanı sıra diğer düğümler tarafından kullanılabilen çıkış değişkenleri olabilir.

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 bir işlem gerçekleştiren bir otomasyonunuz olabilir. 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. İki veya daha fazla başlatıcıyı select akışına eklediğinizde başlatıcılardan herhangi biri otomasyonu etkinleştirebilir.

Örneğin, gün batımında, sıcaklık belirli bir eşiğin üzerine çıktığında veya parlaklık belirli bir eşiği aştığında panjurları indiren bir otomasyon yazabilirsiniz. Bu senaryoların her biri üç ayrı başlangıçla ele alınır ve üçü de select akışına dahil edilir.

Bir if-then-else akışı (IfFlow), otomasyon içinde koşullu yürütmenin dallanmasına olanak tanır. Koşul false ise otomasyonun tamamını durduran bir condition düğümünün aksine, bir if-then-else akışı, koşul doğru olduğunda belirli işlemleri koşullu olarak yürütür ve alternatif koşullara veya yedek işlemlere geri dönebilir ya da otomasyondaki sonraki düğümlere devam edebilir. Daha fazla bilgi için Koşullu yürütme başlıklı makaleye bakın.

İç 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 iç içe yerleştirilebilir ve çeşitli şekillerde birleştirilebilir. Oluşturucu sütunu, her düğüm türünde neyin kullanılmasına izin verildiğini ayrıntılı olarak açıklayan Kotlin tür güvenli oluşturucu dokümanlarına bağlantı verir.

Otomasyon DSL'si

Ev API'lerinde otomasyonlar, Automation DSL (alana özgü dil) kullanılarak tanımlanır. Automation DSL, Kotlin DSL (alana özgü dil) olarak uygulanır, Kotlin tür güvenli oluşturucularını kullanı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 özellikler 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. Bu, 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ılmasına kıyasla 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 cihazını 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.