Android DSL के कॉन्सेप्ट

यह Android पर, ऑटोमेशन डीएसएल की बुनियादी अवधारणाओं की खास जानकारी है.

ऑटोमेशन के कॉम्पोनेंट

ऑटोमेशन में ये बुनियादी कॉम्पोनेंट शामिल होते हैं. आम तौर पर, इनका आकलन इसी क्रम में किया जाता है:

1. स्टार्टर — यह उन शुरुआती शर्तों को तय करता है जिनसे ऑटोमेशन चालू होता है. जैसे, किसी एट्रिब्यूट में बदलाव. किसी ऑटोमेशन में एक स्टार्टर होना ज़रूरी है.
2. शर्त — ऑटोमेशन चालू होने के बाद, आकलन करने के लिए कोई अतिरिक्त कंस्ट्रेंट. ऑटोमेशन की कार्रवाइयों को आगे बढ़ाने के लिए, शर्त में दिए गए एक्सप्रेशन का आकलन true होना चाहिए.
3. कार्रवाई — वे कमांड या स्टेटस अपडेट जो सभी शर्तें पूरी होने पर किए जाते हैं.

उदाहरण के लिए, मान लें कि आपके पास एक ऐसा ऑटोमेशन है जो सूर्यास्त और सूर्योदय के बीच, कमरे में मौजूद टीवी चालू होने पर, उस कमरे की लाइटें डिम कर देता है. इस उदाहरण में:

1. स्टार्टर — टीवी चालू किया गया. यह टीवी के एट्रिब्यूट में बदलाव है.
2. शर्त— उस घर के लिए मौजूदा समय का आकलन किया जाता है जिसमें टीवी मौजूद है.
3. कार्रवाई — टीवी वाले कमरे की लाइटें डिम की जाती हैं.

कमरे में मौजूद टीवी चालू होने पर, ऑटोमेशन चालू हो जाएगा. हालांकि, ऑटोमेशन सिर्फ़ तब काम करेगा, जब "समय सूर्यास्त और सूर्योदय के बीच हो" की शर्त पूरी होगी.

बुनियादी स्ट्रक्चर के अलावा, Home APIs में मौजूद ऑटोमेशन में मेटाडेटा भी शामिल होता है. जैसे, name और description. इनका इस्तेमाल, डेवलपर और उपयोगकर्ता, ऑटोमेशन की पहचान करने के लिए कर सकते हैं.

नोड

Home APIs में, ऑटोमेशन का लॉजिकल स्ट्रक्चर नोड से मिलकर बनता है. नोड, अमूर्त और दोबारा इस्तेमाल किए जा सकने वाली इकाइयां होती हैं. ये इकाइयां, एंटिटी के व्यवहार या एक्ज़ीक्यूशन फ़्लो को दिखाती हैं. हर नोड में इनपुट वैरिएबल के साथ-साथ, आउटपुट वैरिएबल भी हो सकते हैं. इनका इस्तेमाल, अन्य नोड कर सकते हैं.

व्यवहारजन्य नोड

स्टार्टर और ऐक्शन जैसे नोड, व्यवहारजन्य नोड होते हैं. स्टार्टर, डिवाइस के एट्रिब्यूट में बदलाव के आधार पर, ऑटोमेशन चालू करते हैं. ऐक्शन, डिवाइस के कमांड जारी करते हैं या एट्रिब्यूट अपडेट करते हैं.

व्यवहारजन्य नोड आम तौर पर, डिवाइस के एट्रिब्यूट से जुड़े होते हैं. साथ ही, अन्य नोड में इनपुट के तौर पर इस्तेमाल करने के लिए, एट्रिब्यूट का स्टेटस आउटपुट करते हैं.

एक्ज़ीक्यूशन फ़्लो नोड

कुछ नोड, एक्ज़ीक्यूशन फ़्लो को दिखाते हैं. जैसे, क्रम में और पैरलल. इनमें से हर नोड में, व्यवहारजन्य नोड शामिल होते हैं. ये नोड, ऑटोमेशन को तय करते हैं.

उदाहरण के लिए, क्रम में फ़्लो में ऐसे नोड शामिल हो सकते हैं जो क्रम से लागू होते हैं. आम तौर पर, ये स्टार्टर, शर्त, और कार्रवाई होते हैं.

पैरलल फ़्लो में, एक ही समय पर कई ऐक्शन नोड लागू हो सकते हैं. जैसे, एक ही समय पर कई लाइटें चालू करना. पैरलल फ़्लो के बाद आने वाले नोड, तब तक लागू नहीं होंगे, जब तक पैरलल फ़्लो की सभी ब्रांच पूरी नहीं हो जातीं.

एक्ज़ीक्यूशन फ़्लो का एक और टाइप कंडीशन फ़्लो है. यह किसी एक्सप्रेशन के आकलन के आधार पर, एक्ज़ीक्यूशन फ़्लो को बदल सकता है.

उदाहरण के लिए, मान लें कि आपके पास एक ऐसा ऑटोमेशन है जो रात के समय के आधार पर कोई कार्रवाई करता है. कंडीशन नोड, दिन के समय की जांच करता है. इसके बाद, उस आकलन के आधार पर, सही एक्ज़ीक्यूशन पाथ को फ़ॉलो करता है.

सेलेक्ट फ़्लो तब काम का होता है, जब आपको एक से ज़्यादा स्टार्टर चाहिए, जो आपके ऑटोमेशन को चालू कर सकें. जब दो या उससे ज़्यादा स्टार्टर को select फ़्लो में शामिल किया जाता है, तो इनमें से कोई भी स्टार्टर, ऑटोमेशन को चालू कर सकता है.

उदाहरण के लिए, ऐसा ऑटोमेशन लिखा जा सकता है जो सूर्यास्त के समय, तापमान किसी तय थ्रेशोल्ड से ज़्यादा होने पर या चमक किसी थ्रेशोल्ड से ज़्यादा होने पर, पर्दे नीचे कर देता है. इनमें से हर स्थिति को तीन अलग-अलग स्टार्टर हैंडल करते हैं. इन तीनों को select फ़्लो में रैप किया जाएगा.

नेस्ट किए गए फ़्लो

कॉम्प्लेक्स ऑटोमेशन में, एक्ज़ीक्यूशन फ़्लो नोड को नेस्ट भी किया जा सकता है. उदाहरण के लिए, आपके पास एक ऐसा क्रम में होने वाला फ़्लो हो सकता है जो पैरलल फ़्लो को लागू करता है.

डीएसएल नोड को नेस्ट किया जा सकता है और अपनी खास ज़रूरतों के हिसाब से अलग-अलग तरीकों से जोड़ा जा सकता है. इसके लिए, यहां दी गई टेबल में बताए गए कंस्ट्रेंट का पालन करना होगा. बिल्डर कॉलम, Kotlin के टाइपसेफ़ बिल्डर के दस्तावेज़ से लिंक होता है. इसमें हर तरह के नोड में इस्तेमाल की जा सकने वाली चीज़ों के बारे में जानकारी दी गई है.

ऑटोमेशन डीएसएल

Home APIs में, ऑटोमेशन को ऑटोमेशन डीएसएल (डोमेन-स्पेसिफ़िक लैंग्वेज) का इस्तेमाल करके तय किया जाता है. ऑटोमेशन डीएसएल को Kotlin डीएसएल (डोमेन-स्पेसिफ़िक लैंग्वेज) के तौर पर लागू किया जाता है. इसके लिए, Kotlin के टाइप-सेफ़ बिल्डर का इस्तेमाल किया जाता है. इसे खास तौर पर, ऑटोमेशन टेंप्लेट तय करने के लिए डिज़ाइन किया गया है.

ऑटोमेशन कंपाइल होने पर, Kotlin के टाइप-सेफ़ बिल्डर, Kotlin के डेटा क्लास जनरेट करते हैं. इसके बाद, इन्हें प्रोटोकॉल बफ़र JSON में सीरियल किया जाता है. इसका इस्तेमाल, Google की ऑटोमेशन सेवाओं को कॉल करने के लिए किया जाता है.

ऑटोमेशन डीएसएल, ऑटोमेशन बनाने की प्रोसेस को आसान और बेहतर बनाता है. यह Device API में मौजूद Matter स्टैंडर्ड एट्रिब्यूट और smart home एट्रिब्यूट के उसी डेटा मॉडल का इस्तेमाल करता है.

ऑटोमेशन डीएसएल, किसी उपयोगकर्ता के घर में मौजूद डिवाइस के खास इंस्टेंस के बजाय, अमूर्त डिवाइस टाइप के हिसाब से ऑटोमेशन के लॉजिक को भी तय करता है. यह डेवलपर को ऐसे इनपुट पैरामीटर देने की अनुमति देता है जिनका इस्तेमाल, रनटाइम के दौरान डिवाइस के असल इंस्टेंस के साथ-साथ, अन्य ज़रूरी पैरामीटर की वैल्यू तय करने के लिए किया जा सकता है.

डीएसएल का सिंटैक्स, Kotlin के सिंटैक्स जैसा होता है. साथ ही, यह उतना ही टाइप-सेफ़ होता है. हालांकि, ऑटोमेशन डीएसएल में लिखा गया ऑटोमेशन, Kotlin में लिखे गए उसी ऑटोमेशन से ज़्यादा आसान और छोटा होता है.

उदाहरण

यहां ऑटोमेशन डीएसएल का इस्तेमाल करके लिखा गया एक ऑटोमेशन दिया गया है. यह ऑटोमेशन, किसी डिवाइस को चालू करता है:

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

यह ऑटोमेशन बहुत बुनियादी है: जब device1 (एक लाइट) चालू होती है, तो onOff एट्रिब्यूट की वैल्यू true हो जाती है. इसके बाद, device2 को चालू करने के लिए, on() कमांड भेजा जाता है.

ऑटोमेशन में sequential नोड का इस्तेमाल किया जाता है. इससे पता चलता है कि इसके नोड, क्रम से चलेंगे.

sequential नोड में, starter, condition, और action जैसे व्यवहारजन्य नोड शामिल होते हैं. starter नोड का आउटपुट, condition नोड में इस्तेमाल करने के लिए, किसी वैरिएबल को असाइन किया जाता है.