Home APIs Android SDK के रिलीज़ नोट

2025-06-05

  Home APIs का सार्वजनिक बीटा वर्शन 1.3.1  

इस रिलीज़ में गड़बड़ियां ठीक की गई हैं. साथ ही, Home APIs Android SDK टूल के बीटा वर्शन की क्वालिटी को बेहतर बनाया गया है.

कम से कम वर्शन

  • Google Play services: 25.19.32
  • Google Hub के फ़र्मवेयर के कम से कम वर्शन:
    • कास्ट: 3.75.468222
    • Fuchsia: 26.20250116.103.2201
  • Android SDK: home.android.sdk_202505_EAP_1_3_1_RC06
  • Google Home ऐप्लिकेशन: यह किसी भी वर्शन के साथ काम करता है
  • androidx.core लाइब्रेरी: यह किसी भी वर्शन के साथ काम करती है
  • Matter का वर्शन: 1.4.0.0

नई सुविधाएं

विशेषताएं

  • इसमें SyntheticSwitch ट्रैट को शामिल किया गया है. इससे, Matter स्विच डिवाइसों से जनरेट होने वाले इवेंट को मैनेज करना आसान हो जाता है. साथ ही, स्विच से ऑटोमेशन स्टार्टर को ट्रिगर करने की सुविधा मिलती है.
  • ExtendedDoorLock ट्रेट में एक अहम बदलाव किया गया है: user_id फ़ील्ड का डेटाटाइप, String से बदलकर Long कर दिया गया है.

    इस ट्रैट का इस्तेमाल करने वाले ऐप्लिकेशन को फिर से कंपाइल करना होगा.

Android सैंपल ऐप्लिकेशन

स्ट्रक्चर, डिवाइसों, टाइप, ट्रैट, और ऑटोमेशन की स्थिति को लॉग करने के लिए फ़ंक्शन जोड़े गए हैं, ताकि डीबग करना आसान हो.

ज्ञात समस्याएं

Android सैंपल ऐप्लिकेशन में, ऑटोमेशन बनाएं बटन को ट्रिगर करने के लिए, कभी-कभी कई टैप की ज़रूरत पड़ती है.

पहले से मालूम समस्याएं ठीक की गईं

  • अगर Google Home ऐप्लिकेशन (GHA) में होम की जगह की जानकारी सेट नहीं की गई है, तो ऑटोमेशन बनाते समय Google Home ऐप्लिकेशन FailedPreconditionException के साथ क्रैश हो जाता है. होम की जगह की जानकारी सेट करने का तरीका जानने के लिए, Google होम का पता बदलें लेख पढ़ें.
  • Android सैंपल ऐप्लिकेशन में, connectivityState PARTIALLY_ONLINE वाले डिवाइस को पहले उपयोगकर्ता को ऑफ़लाइन के तौर पर दिखाया गया था. इस स्थिति को अब ऑनलाइन के तौर पर दिखाया जाता है.

2025-05-12

  Home APIs का सार्वजनिक बीटा वर्शन 1.3  

इस रिलीज़ में गड़बड़ियां ठीक की गई हैं. साथ ही, Home APIs Android SDK टूल के बीटा वर्शन की क्वालिटी को बेहतर बनाया गया है.

कम से कम वर्शन

  • Google Play services: 25.16.33
  • Google Hub के फ़र्मवेयर के कम से कम वर्शन:
    • कास्ट: 3.75.468222
    • Fuchsia: 26.20250116.103.2201
  • Android SDK: home.android.sdk_202504_EAP_1_3_RC00
  • Google Home ऐप्लिकेशन: यह किसी भी वर्शन के साथ काम करता है
  • androidx.core लाइब्रेरी: यह किसी भी वर्शन के साथ काम करती है
  • Matter का वर्शन: 1.4.0.0

नई सुविधाएं

ज्ञात समस्याएं

अगर Google Home ऐप्लिकेशन (GHA) में होम की जगह की जानकारी सेट नहीं की गई है, तो ऑटोमेशन बनाते समय Google Home ऐप्लिकेशन क्रैश हो जाता है और FailedPreconditionException दिखता है. ऐसा करने का तरीका जानने के लिए, Google होम का पता बदलना लेख पढ़ें.

  • समस्या हल करने का तरीका: ऑटोमेशन बनाने की कोशिश करने से पहले, देख लें कि घर का पता डिस्कवरी एपीआई का इस्तेमाल करके मौजूद है या नहीं.

पहले से मालूम समस्याएं ठीक की गईं

  • वाई-फ़ाई से मोबाइल नेटवर्क पर स्विच करने पर, डिवाइस को कंट्रोल करने में ज़्यादा समय लग सकता है.
  • हब को फ़ैक्ट्री रीसेट करने के बाद, हो सकता है कि डिवाइसों की स्थिति 'ऑफ़लाइन' दिखे.

2025-04-09

  Home APIs का सार्वजनिक बीटा वर्शन 1.2.1  

इस रिलीज़ में गड़बड़ियां ठीक की गई हैं. साथ ही, Home APIs Android SDK टूल के बीटा वर्शन की क्वालिटी को बेहतर बनाया गया है.

कम से कम वर्शन

  • Google Play services: 25.09.33
  • Google Hub के फ़र्मवेयर के कम से कम वर्शन:
    • कास्ट: 3.75.468222
    • Fuchsia: 24.20241009.103.19006011
  • Android SDK: home.android.sdk_202503_EAP_1_2_1_RC02
  • Google Home ऐप्लिकेशन: यह किसी भी वर्शन के साथ काम करता है
  • androidx.core लाइब्रेरी: 1.10.0
  • Matter का वर्शन: 1.4.0.0
1. फ़िलहाल, यह बिल्ड प्रोडक्शन के लिए रोल आउट किया जा रहा है. यह 22 अप्रैल, 2025 तक सभी डिवाइसों के लिए उपलब्ध हो जाएगा.

नई सुविधाएं

  • होम ग्राफ़ से ऑब्जेक्ट लोड करते समय बेहतर परफ़ॉर्मेंस.
  • Automation API
    • इकाई फ़िल्टर के लिए सहायता जोड़ी गई है. इससे ऑटोमेशन, ऑटोमेशन में बताई गई शर्तों के आधार पर, डिवाइसों को डाइनैमिक तौर पर चुन सकते हैं.
  • Device API
    • क्लाउड-टू-क्लाउड डिवाइस की जानकारी अब BasicInformationTrait में उपलब्ध है.

ज्ञात समस्याएं

  • वाई-फ़ाई से मोबाइल नेटवर्क पर स्विच करने पर, डिवाइस को कंट्रोल करने में ज़्यादा समय लग सकता है.
  • हब को फ़ैक्ट्री रीसेट करने के बाद, हो सकता है कि डिवाइसों की स्थिति 'ऑफ़लाइन' दिखे.

पहले से मालूम समस्याएं ठीक की गईं

  • अगर डिस्कवरी एपीआई को शुरू करने से पहले या शुरू होने की प्रोसेस पूरी होने से पहले कॉल किया जाता है, तो code 14: UNKNOWN के साथ HomeException और "कोई रास्ता नहीं मिला" मैसेज दिखता है.
  • अगर किसी ऐसे एनवायरमेंट में एक से ज़्यादा स्ट्रक्चर और उपयोगकर्ता हैं, तो स्ट्रक्चर और उपयोगकर्ताओं के बीच स्विच करने पर, हो सकता है कि कोई डिवाइस वापस न मिले.

2025-03-14

  Home APIs का सार्वजनिक बीटा वर्शन 1.2.0  

इस रिलीज़ में गड़बड़ियां ठीक की गई हैं. साथ ही, Home APIs Android SDK टूल के बीटा वर्शन की क्वालिटी को बेहतर बनाया गया है.

कम से कम वर्शन

  • Google Play services का कम से कम वर्शन: 25.06.32
  • Google Hub के फ़र्मवेयर के कम से कम वर्शन:
    • Cast का वर्शन: 3.75.456944
    • Fuchsia का कम से कम वर्शन: 24.20241009.103.1900601
  • Android SDK: home.android.sdk_1_2_0_RC06
  • Google Home ऐप्लिकेशन का कम से कम वर्शन: यह किसी भी वर्शन के साथ काम करता है
  • androidx.core लाइब्रेरी का कम से कम वर्शन: 1.10.0
  • Matter का वर्शन: 1.3.0.0
    • ध्यान दें: फ़िलहाल, Matter डिवाइस के अलग-अलग टाइप और क्लस्टर का इस्तेमाल नहीं किया जा सकता.

नई सुविधाएं

  • Automation API:
    • ऑटोमेशन की शर्तों में तारीख की सीमाओं और कुछ तारीखों के लिए काम करता है. बीच में के साथ तारीखों का इस्तेमाल करना देखें.
    • पिछली रिलीज़ में, Discovery API ने कुछ बिटमैप फ़ील्ड के लिए, NumberSetConstraint दिखाया था, जबकि उसे BitmapConstraint दिखाना चाहिए था. ये फ़ील्ड अब उम्मीद के मुताबिक, BitmapConstraint दिखाते हैं. यह सिर्फ़ LevelControl और optionsOverride बिटमैप के लिए काम करता है.optionsMask

ज्ञात समस्याएं

  • वाई-फ़ाई से मोबाइल नेटवर्क पर स्विच करने पर, डिवाइस को कंट्रोल करने में ज़्यादा समय लग सकता है.
  • हब को फ़ैक्ट्री रीसेट करने के बाद, हो सकता है कि डिवाइसों की स्थिति 'ऑफ़लाइन' दिखे.
  • अगर डिस्कवरी एपीआई को शुरू करने से पहले या शुरू होने की प्रोसेस पूरी होने से पहले कॉल किया जाता है, तो code 14: UNKNOWN के साथ HomeException और "कोई रास्ता नहीं मिला" मैसेज दिखता है.
    • समस्या हल करने का तरीका: Discovery API को सिर्फ़ तब कॉल करें, जब आपको ऑटोमेशन के लिए उम्मीदवारों की ज़रूरत हो. उम्मीदवार की इकाइयों को पहले से फ़ेच और कैश मेमोरी में सेव न करें. किसी इकाई पर डिस्कवरी एपीआई के तरीकों को कॉल करने से पहले, यह देख लें कि वह इकाई ऑनलाइन है या नहीं.
  • अगर किसी ऐसे एनवायरमेंट में एक से ज़्यादा स्ट्रक्चर और उपयोगकर्ता हैं, तो स्ट्रक्चर और उपयोगकर्ताओं के बीच स्विच करने पर, हो सकता है कि कोई डिवाइस वापस न मिले.

पहले से मालूम समस्याएं ठीक की गईं

  • लॉन्च होने के बाद, Home APIs ऐप्लिकेशन पहली बार HomeManager.structures() को कॉल करने पर, उसे कोई स्ट्रक्चर नहीं मिलता. भले ही, एक या उससे ज़्यादा स्ट्रक्चर मौजूद हों. इससे गलत धारणा बनती है कि Google खाते से कोई स्ट्रक्चर नहीं जुड़ा है.
  • ऑटोमेशन लोड करने, बनाने, और उनमें बदलाव करने पर, उपयोगकर्ताओं को लंबे समय तक इंतज़ार करना पड़ सकता है.
  • Camera ऐप्लिकेशन से सेटअप फ़्लो शुरू करने वाले उपयोगकर्ताओं को, Matter को कमिशन करने के लिए, क्यूआर कोड को दो बार स्कैन करना होगा.
  • अगर स्ट्रक्चर में 200 से ज़्यादा डिवाइस शामिल हैं, तो हो सकता है कि डिस्कवरी एपीआई कोई भी डिवाइस न दिखाए.

2025-01-29

  Home APIs का सार्वजनिक बीटा वर्शन 1.1.0  

इस रिलीज़ में गड़बड़ियां ठीक की गई हैं. साथ ही, Home APIs Android SDK टूल के बीटा वर्शन की क्वालिटी को बेहतर बनाया गया है.

कम से कम वर्शन

  • Google Play services का कम से कम वर्शन: 25.02.32
  • Google Hub के फ़र्मवेयर के कम से कम वर्शन:
    • Cast का वर्शन: 3.75.456944
    • Fuchsia का कम से कम वर्शन: 24.20241009.103.1900500
  • Android SDK: home.android.sdk_202412_EAP_1_1_RC04
  • Google Home ऐप्लिकेशन का कम से कम वर्शन: यह किसी भी वर्शन के साथ काम करता है
  • androidx.core लाइब्रेरी का कम से कम वर्शन: 1.10.0
  • Matter का वर्शन: 1.3.0.0
    • ध्यान दें: फ़िलहाल, Matter डिवाइस के अलग-अलग टाइप और क्लस्टर का इस्तेमाल नहीं किया जा सकता.

नई सुविधाएं

  • Streaming API:
  • एक साथ कई अनुरोध करने की सुविधा देने वाला एपीआई (प्रयोग के तौर पर उपलब्ध):

ज्ञात समस्याएं

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

पहले से मालूम समस्याएं ठीक की गईं

  • हो सकता है कि लॉग इन किए गए Google खाते को स्विच करने में समस्या आ जाए और गड़बड़ी का मैसेज दिखे.
  • ऐसा हो सकता है कि Google TV डिवाइस, उन ऑटोमेशन के लिए काम न करें जिनमें MediaPlayback ट्रैट का इस्तेमाल किया गया हो.
  • ऐसे स्ट्रक्चर में जिसमें सिर्फ़ Google हब है:
    • Matter डिवाइस, Google Home ऐप्लिकेशन में ऑफ़लाइन दिख सकते हैं.
    • Google Assistant, Matter डिवाइसों को कंट्रोल नहीं कर सकती.
    • स्मार्ट डिसप्ले, Matter डिवाइसों को कंट्रोल नहीं कर सकते या किसी भी Matter डिवाइस की स्थिति नहीं दिखा सकते.
  • हो सकता है कि कुछ डिवाइसों के लिए, ऐप्लिकेशन हमेशा सही स्थिति न दिखाए. साथ ही, आपका ऐप्लिकेशन ऐसी स्थिति दिखाए जो Google के ऐप्लिकेशन, जैसे कि Google Home ऐप्लिकेशन से मिली स्थिति से अलग हो. आम तौर पर, ऐसा इसलिए होता है, क्योंकि डिवाइस Google को स्थिति की जानकारी नहीं देते.
    • समस्या हल करने का तरीका: Google के किसी ऐप्लिकेशन से स्थिति की जांच करने पर, मेल न खाने की समस्या हल हो जाती है.

2025-01-14

Home API को शुरू करने के लिए अपडेट किया गया दिशा-निर्देश.

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

2025-01-07

  Home APIs का सार्वजनिक बीटा वर्शन रिलीज़  

सार्वजनिक बीटा वर्शन के दौरान, सभी डेवलपर अपने ऐप्लिकेशन बनाना और उनकी जांच करना शुरू कर सकते हैं.

इस रिलीज़ में गड़बड़ियां ठीक की गई हैं. साथ ही, Home APIs Android SDK के बीटा वर्शन की क्वालिटी को बेहतर बनाया गया है. इसमें Google Nest Audio और Google TV डिवाइसों के लिए बेहतर सहायता भी शामिल है.

कम से कम वर्शन

  • Google Play services का कम से कम वर्शन: 24.45.34
  • Google Hub के फ़र्मवेयर के कम से कम वर्शन:
    • Cast का वर्शन: 3.74.444798
    • Fuchsia का कम से कम वर्शन: 22.20240805.103.161
  • Android SDK: home.android.sdk_202411_EAP_1_0_1_RC00
  • Google Home ऐप्लिकेशन (GHA) का कम से कम वर्शन: किसी भी वर्शन के साथ काम करता है
  • androidx.core लाइब्रेरी का कम से कम वर्शन: 1.10.0
  • Matter का वर्शन: 1.3.0.0
    • ध्यान दें: फ़िलहाल, इस सुविधा का इस्तेमाल, प्रॉविज़नल Matter डिवाइस टाइप और क्लस्टर के साथ नहीं किया जा सकता.

ज्ञात समस्याएं

  • हो सकता है कि लॉग इन किए गए Google खाते को स्विच करने में समस्या आ जाए और गड़बड़ी का मैसेज दिखे.
    • समस्या हल करने का तरीका: अनुमतियों का फ़्लो फिर से चलाएं या ऐप्लिकेशन को रीस्टार्ट करें.
  • ऐसा हो सकता है कि Google TV डिवाइस, उन ऑटोमेशन के लिए काम न करें जिनमें MediaPlayback ट्रैट का इस्तेमाल किया गया हो.
  • ऐसे स्ट्रक्चर में जिसमें सिर्फ़ Google हब है:
    • Google Home ऐप्लिकेशन (GHA) में, Matter डिवाइसों के ऑफ़लाइन होने की जानकारी दिख सकती है.
    • Google Assistant, Matter डिवाइसों को कंट्रोल नहीं कर सकती.
    • स्मार्ट डिसप्ले, Matter डिवाइसों को कंट्रोल नहीं कर सकते या किसी भी Matter डिवाइस की स्थिति नहीं दिखा सकते.
  • ऐसा हो सकता है कि कुछ डिवाइसों के लिए, ऐप्लिकेशन हमेशा सही स्थिति न दिखाए. साथ ही, आपका ऐप्लिकेशन ऐसी स्थिति दिखाए जो Google के ऐप्लिकेशन, जैसे कि Google Home ऐप्लिकेशन (GHA) से अलग हो. आम तौर पर, ऐसा तब होता है, जब डिवाइस Google को अपनी स्थिति की जानकारी नहीं देते.
    • समस्या हल करने का तरीका: Google के किसी ऐप्लिकेशन से स्थिति की जांच करने पर, मेल न खाने की समस्या हल हो जाती है.

पहले से मालूम समस्याएं ठीक की गईं

  • अगर इस प्रोसेस के दौरान ऐप्लिकेशन को छोटा किया जाता है, तो हो सकता है कि कमीशनिंग पूरी न हो पाए.
    • समस्या हल करने का तरीका: अपने ऐप्लिकेशन में कमिशनिंग एपीआई का इस्तेमाल करने पर, आधी स्क्रीन वाली सूचनाओं को रोकने के लिए, suppressHalfSheetNotification() एपीआई का इस्तेमाल करें.
  • सर्वर साइड की समस्या की वजह से, हो सकता है कि OkGoogle स्टार्टर, ऑटोमेशन में काम न करें.
  • Fuchsia पर काम करने वाले ऐसे हब का इस्तेमाल करते समय जिसमें स्ट्रक्चर में कोई Matter डिवाइस नहीं है, अगर हब को तीन घंटे से ज़्यादा समय तक बिना इस्तेमाल के छोड़ दिया जाता है, तो पहले Matter डिवाइस को चालू करने पर, वह डिवाइस ऑफ़लाइन हो जाता है.
  • किसी हब के लिए फ़ैक्ट्री डेटा रीसेट करने के बाद, हो सकता है कि नए डिवाइसों को दिए गए निर्देश काम न करें. भले ही, डिवाइस ऑनलाइन के तौर पर दिख रहा हो.