Android DSL kavramları

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:

1. Başlatıcı: Otomasyonu etkinleştiren ilk koşulları (ör. bir özellikteki değişiklik) tanımlar. Otomasyonların 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ı karartan bir otomasyonunuz olabilir. Bu örnekte:

1. Başlatma: TV'nin açılması, TV özelliğinde durum değişikliği olarak değerlendirilir.
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 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.

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 yürütülen birden fazla işlem düğümü olabilir. Örneğin, aynı anda birden fazla ışığı açma. 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, 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 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 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ümanına bağlanı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 ö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. 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ı şekilde 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.