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

bookmark_border संग्रह की मदद से व्यवस्थित रहें अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.

2025-04-09

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

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

कम से कम वर्शन

• Google Play services: 25.09.33
• Google Hub के फ़र्मवेयर के कम से कम वर्शन:
  • कास्ट: 3.75.468222
  • Fuchsia: 24.20241009.103.1900601¹
• 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 टूल के लिए, सामान्य रूप से उपलब्ध (GA) क्वालिटी को बेहतर बनाया गया है.

कम से कम वर्शन

• 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 और "कोई रास्ता नहीं मिला" मैसेज दिखता है.
  • समस्या हल करने का तरीका: सिर्फ़ तब डिस्कवरी एपीआई को कॉल करें, जब आपको ऑटोमेशन के लिए उम्मीदवारों की ज़रूरत हो. उम्मीदवार की इकाइयों को पहले से फ़ेच और कैश मेमोरी में सेव न करें. किसी इकाई पर डिस्कवरी एपीआई के तरीकों को कॉल करने से पहले, यह देख लें कि वह इकाई ऑनलाइन है या नहीं.
• अगर किसी ऐसे एनवायरमेंट में एक से ज़्यादा स्ट्रक्चर और उपयोगकर्ता हैं, तो स्ट्रक्चर और उपयोगकर्ताओं के बीच स्विच करने पर, हो सकता है कि कोई डिवाइस वापस न मिले.

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

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

2025-01-29

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

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

कम से कम वर्शन

• 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:
  • इवेंट स्ट्रीम उपलब्ध कराती है, जो जोड़े गए, बदले गए, और हटाए गए स्ट्रक्चर, कमरों, और डिवाइसों के बारे में सूचना देती हैं.
  • इकाई के संबंध से जुड़े इवेंट की सदस्यता लें लेख पढ़ें.
• एक साथ कई अनुरोध करने की सुविधा देने वाला एपीआई (प्रयोग के तौर पर उपलब्ध):
  • इससे डेवलपर को एक साथ कई निर्देश भेजने की सुविधा मिलती है.
  • एक साथ कई निर्देश भेजना देखें.

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

• ऑटोमेशन लोड करने, बनाने, और उनमें बदलाव करने पर, उपयोगकर्ताओं को लंबे समय तक इंतज़ार करना पड़ सकता है.
• कैमरा ऐप्लिकेशन से सेटअप फ़्लो शुरू करने वाले उपयोगकर्ताओं को, 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 डिवाइस को चालू करने पर, वह डिवाइस ऑफ़लाइन हो जाता है.
• किसी हब के लिए फ़ैक्ट्री डेटा रीसेट करने के बाद, हो सकता है कि नए डिवाइसों को दिए गए निर्देश काम न करें. भले ही, डिवाइस ऑनलाइन के तौर पर दिख रहा हो.