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

यहां Android पर, ऑटोमेशन डीएसएल के बुनियादी कॉन्सेप्ट के बारे में खास जानकारी दी गई है.

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

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

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

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

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

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

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

नोड

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

व्यवहार से जुड़े नोड

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ऑटोमेशन डीएसएल, ऑटोमेशन बनाने की प्रोसेस को आसान और बेहतर बनाता है. यह डिवाइस एपीआई में शामिल Matter स्टैंडर्ड ट्रेट और smart home ट्रेट के एक ही डेटा मॉडल का इस्तेमाल करता है.

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

डीएसएल का सिंटैक्स, Kotlin के सिंटैक्स जैसा ही होता है. साथ ही, यह टाइप-सेफ़ भी होता है. हालांकि, Automation DSL में लिखा गया ऑटोमेशन, 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 नोड में किया जा सके.