Android के लिए Google Home API, एक यूनिफ़ाइड एपीआई उपलब्ध कराते हैं. इससे डेवलपर, उपयोगकर्ता के होम में मौजूद इकाइयों की स्थिति के साथ इंटरैक्ट कर पाते हैं. ये इकाइयां, डिवाइसों और उपयोगकर्ता के होम और कमरों से जुड़ी गैर-डिवाइस जानकारी के बारे में बता सकती हैं.
Home API, इन इकाइयों को तय करते हैं जिनके साथ उपयोगकर्ता इंटरैक्ट कर सकता है:
- स्ट्रक्चर, एक ऐसे होम को कहते हैं जिसमें कमरे और डिवाइस शामिल होते हैं.
- कमरे, स्ट्रक्चर का हिस्सा होते हैं और इनमें डिवाइस शामिल होते हैं.
- डिवाइस में एट्रिब्यूट वाली ट्रेट लागू होती हैं, वे टाइप के मुताबिक काम करते हैं, इवेंट जनरेट करते हैं, और निर्देशों का जवाब देते हैं.
- ऑटोमेशन, स्ट्रक्चर का हिस्सा होते हैं. ये होम के मेटाडेटा और डिवाइसों का इस्तेमाल करके, होम में टास्क अपने-आप पूरे करते हैं.
पहली इमेज में, इस आर्किटेक्चर के बारे में बताया गया है:
Home API के साथ काम करने वाले डिवाइसों में, Matter की सुविधा हो सकती है. यह स्मार्ट होम के लिए एक ओपन स्टैंडर्ड है. इसके अलावा, ये Google Home के Cloud-to-cloud डिवाइस भी हो सकते हैं. ऐसा हो सकता है कि कुछ डिवाइसों में, दोनों तरह की सुविधाओं को शामिल किया गया हो. ज़्यादा जानकारी के लिए, Android पर काम करने वाले डिवाइस टाइप देखें.
Matter में, डिवाइस के फ़ंक्शन को क्लस्टर के हिसाब से ग्रुप किया जाता है. इन्हें Home API में Matter स्टैंडर्ड ट्रेट के तौर पर दिखाया जाता है. Home API, Matter स्पेसिफ़िकेशन में बताए गए Matter क्लस्टर के स्टैंडर्ड सेट के साथ काम करते हैं.
Google Home के इकोसिस्टम में, डिवाइस के फ़ंक्शन को स्मार्ट होम की विशेषताओं के हिसाब से ग्रुप किया जाता है. इन्हें Home API में, Google की स्मार्ट होम की विशेषताओं के तौर पर दिखाया जाता है. Home API, Cloud-to-cloud प्रोग्राम में तय की गई स्मार्ट होम की विशेषताओं के सेट के साथ काम करते हैं.
फ़ोन बनाने वाली कंपनी के हिसाब से क्लस्टर और प्लैटफ़ॉर्म की खासियतें जैसी अन्य सुविधाएं भी उपलब्ध हैं. ज़्यादा जानने के लिए, Android पर डेटा मॉडल देखें.
नेटवर्क
Google Home का नेटवर्क, स्मार्ट होम से जुड़े अनुभव को बेहतर बनाने, मैनेज करने, सुरक्षित रखने, और इंटिग्रेट करने के लिए एक आसान प्लैटफ़ॉर्म उपलब्ध कराता है. दूसरे डायग्राम में दिखाया गया है कि सभी कॉम्पोनेंट एक साथ कैसे काम करते हैं.
इस इकोसिस्टम में Google Automation Engine शामिल है. यह ऑटोमेशन को सेव करता है और उन्हें चलाता है. इससे घर में टास्क और डिवाइस की सेटिंग को ऑटोमेट किया जा सकता है.
Home APIs, स्ट्रक्चर में मौजूद डिवाइसों को ऐक्सेस करने की अनुमति देने के लिए OAuth 2.0 का इस्तेमाल करता है. OAuth की मदद से, कोई उपयोगकर्ता अपने लॉगिन क्रेडेंशियल शेयर किए बिना किसी ऐप्लिकेशन या सेवा को अनुमति दे सकता है.
Google Home Developer Console का इस्तेमाल, Home APIs प्रोजेक्ट के सभी चरणों को मैनेज करने के लिए किया जाता है. जैसे, ब्रैंड की पुष्टि करना, डेवलपमेंट करना, टेस्टिंग करना, सर्टिफ़िकेट पाना, और आखिर में लॉन्च करना. इससे डेवलपमेंट की प्रोसेस आसान हो जाती है. साथ ही, Google Home के नेटवर्क के ज़रिए मज़बूत टूल और डिस्ट्रिब्यूशन उपलब्ध कराए जाते हैं.
भाषा
Android के लिए Home API, Kotlin में लिखे गए हैं. ये एक सामान्य Kotlin इंटरफ़ेस उपलब्ध कराते हैं, जो स्थिति और सदस्यता को मैनेज करने के लिए Flow का इस्तेमाल करता है. इससे, स्टैंडर्ड सदस्यता एपीआई के मुकाबले कई फ़ायदे मिलते हैं.
हमारा सुझाव है कि अगर आपको कोरूटीन, फ़्लो, और Jetpack Compose के बारे में नहीं पता है, तो Kotlin के दस्तावेज़ पढ़ें:
- Kotlin की मदद से Android ऐप्लिकेशन बनाना
- Android के लिए Kotlin सीखें
- Android पर Kotlin कोरूटीन. ये कोडलैब आपके काम के हो सकते हैं:
- Android पर Kotlin फ़्लो और खास तौर पर, StateFlow.
- स्टेट और Jetpack Compose, खास तौर पर
collectAsStateWithLifecycle()फ़ंक्शन. यह फ़ंक्शन, फ़्लो को सब्सक्राइब करने और अनसब्सक्राइब करने की प्रोसेस को अपने-आप मैनेज करता है. यह इस बात पर निर्भर करता है कि उस स्टेट को दिखाने वाला यूज़र इंटरफ़ेस (यूआई) फ़ोरग्राउंड में है या नहीं. - अगर आपको Automation API का इस्तेमाल करना है, तो Kotlin के टाइप-सेफ़ बिल्डर के बारे में पढ़ना आपके लिए फ़ायदेमंद होगा. इससे आपको यह समझने में मदद मिलेगी कि Automation DSL कैसे काम करता है.
इकाई के आइडेंटिफ़ायर
Home APIs में मौजूद हर इकाई का एक आईडी होता है, जो उसकी मुख्य पहचान होती है. यह आईडी एक यूनीक और स्थिर पहचानकर्ता होता है. यह इकाई के जीवनकाल में कभी नहीं बदलता. इस आईडी का इस्तेमाल, ऑब्जेक्ट को कैश मेमोरी में सेव करने या समानता की जांच करने के लिए किया जा सकता है, क्योंकि किसी इकाई का मेटाडेटा बदल सकता है.
HasId इंटरफ़ेस देखें. इससे आपको यह पता चलेगा कि किन इकाइयों का आईडी होता है.
शब्दावली मैपिंग
Home API में मौजूद इकाइयां, Matter और Cloud-to-cloud कॉन्सेप्ट से इस तरह मैप होती हैं:
| Home APIs | Matter | Cloud-to-cloud |
|---|---|---|
| ट्रेट | क्लस्टर | ट्रेट |
| एट्रिब्यूट | एट्रिब्यूट | एट्रिब्यूट, राज्य |
| निर्देश | निर्देश | निर्देश |
| इवेंट | इवेंट | फ़ॉलो अप जवाब, सूचना |