Matter इंटिग्रेशन की जांच करना

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

Google Home Developer Console में जांच पेज होता है. यहां Google Home Test Suite का इस्तेमाल करके, अपने Matter इंटिग्रेशन को कॉन्फ़िगर किया जा सकता है और उसकी जांच की जा सकती है. Test Suite, Developer Console में बनाया गया एक अलग ऐप्लिकेशन है. यह सभी इंटिग्रेशन टेस्ट को मैनेज करता है.

इंटिग्रेशन के वेंडर आईडी और प्रॉडक्ट आईडी के लिए डिवाइसों को कमिशन किया जाना चाहिए. साथ ही, Developer Console के साथ इस्तेमाल किए जा रहे खाते के लिए, Google Home app (GHA) में उपलब्ध होना चाहिए, ताकि उनकी जांच की जा सके. ज़्यादा जानकारी के लिए, Matter डिवाइस को जोड़ना लेख पढ़ें.

Test Suite को किसी खास Matter प्रोजेक्ट कॉन्फ़िगरेशन से जुड़े डिवाइसों के सेट पर चलाया जा सकता है. यह पक्का करने के लिए कि सब कुछ सही तरीके से काम कर रहा है, अपने इंटिग्रेशन पर Test Suite चलाना बहुत ज़रूरी है.

जांच करें पेज पर, Matter ऐसे इंटिग्रेशन जांच के लिए तैयार हैं में सूची में शामिल किए जाते हैं जो पूरे हो चुके हैं और जिनकी जांच की जा सकती है.

Matter जिन इंटिग्रेशन की जांच की जा चुकी है उन्हें जांच की गई सेक्शन में लिस्ट किया गया है.

टेस्ट प्लान के टाइप

टेस्ट प्लान दो तरह के होते हैं:

• डेवलपमेंट टेस्ट प्लान का इस्तेमाल, Matter का इस्तेमाल करके डिवाइसों को कंट्रोल करने की जांच करने के लिए किया जाता है. इनमें बदलाव किया जा सकता है, लेकिन इन्हें Matter सर्टिफ़िकेट के लिए सबमिट नहीं किया जा सकता.

• सर्टिफ़िकेट टेस्ट प्लान, खास तौर पर Matter सर्टिफ़िकेट के लिए होते हैं. इनमें बदलाव नहीं किया जा सकता. इस विकल्प को चुनने पर, आपके Matter इंटिग्रेशन का नया वर्शन बन जाएगा.

सर्टिफ़िकेट के लिए जांच के नतीजे सबमिट करने के लिए, Developer Console में Test Suite का इस्तेमाल करें. अगर आपको डेवलपमेंट के दौरान, जांच के मकसद से Test Suite चलाना है, तो स्टैंडअलोन वर्शन के लिए Google Home टेस्ट सुइट पेज देखें.

इंटिग्रेशन के वर्शन

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

नए वर्शन, नंबर वाले अन्य वर्शन से कभी नहीं बनाए जाते. उदाहरण के लिए, किसी इंटिग्रेशन के लिए बनाया गया पहला टेस्ट प्लान, उस इंटिग्रेशन के लिए v.1 वर्शन बनाएगा. कोई दूसरा टेस्ट प्लान बनाने पर, उस इंटिग्रेशन के लिए v.2 वर्शन बन जाएगा. हालांकि, यह वर्शन v.1 पर आधारित नहीं होगा. इसके बजाय, यह वर्शन, इंटिग्रेशन के ऐसे इंस्टेंस पर आधारित है जिसका कोई वर्शन नहीं है. यह v.1 जैसा ही है.

किसी इंटिग्रेशन का लागू नहीं वर्शन, इंटिग्रेशन के ऐसे इंस्टेंस को दिखाता है जिसका वर्शन नहीं है. इसे डेवलप करें टैब पर मैनेज किया जाता है.

दूसरे शब्दों में, Developer Console में Matter > जांच करें पर जाएं:

• अगर इंटिग्रेशन के उपलब्ध नहीं है वर्शन के लिए जांच करें पर क्लिक किया जाता है, तो एक नया वर्शन बन जाता है. वर्शन का नंबर, मौजूदा वर्शन के नंबर से एक ज़्यादा होगा.
  • अगर कोई नंबर वाला वर्शन मौजूद नहीं है, तो v.1 वर्शन बनाया जाता है.
  • अगर वर्शन v.1 मौजूद है, तो वर्शन v.2 बनाया जाता है. अगर वर्शन v.2 मौजूद है, तो वर्शन v.3 बनाया जाता है. इसी तरह, आगे भी वर्शन बनाए जाते हैं.
• अगर इंटिग्रेशन के नंबर वाले वर्शन (उदाहरण के लिए, v.1) के लिए टेस्ट करें पर क्लिक किया जाता है, तो नया वर्शन नहीं बनाया जाता. इसके बजाय, v.1 वर्शन की फिर से जांच की जाती है.

ज़्यादा जानकारी के लिए, इंटिग्रेशन के वर्शन देखें.

टेस्ट प्लान बनाना

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

सर्टिफ़िकेट के लिए टेस्ट प्लान बनाने से पहले, पक्का करें कि आपने ये काम पूरे कर लिए हों:

1. कंपनी प्रोफ़ाइल बनाई हो.
2. इंटिग्रेशन के लिए, प्रोडक्शन वेंडर आईडी (वीआईडी) डाला हो.
3. कॉन्फ़िगर किया गया सेटअप और ब्रैंडिंग.

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

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

टेस्ट प्लान बनाने के लिए:

Developer Console पर जाएं

1. प्रोजेक्ट की सूची में, उस प्रोजेक्ट के बगल में मौजूद खोलें पर क्लिक करें जिस पर आपको काम करना है.

1. पेज की बाईं ओर मौजूद नेविगेशन मेन्यू में, Matter > जांच करें पर जाएं.
2. आपको जिस इंटिग्रेशन की जांच करनी है उसके वर्शन N/A के लिए, जांच करें पर क्लिक करें. इस कार्रवाई से नया इंटिग्रेशन वर्शन बनता है.
3. डेवलपमेंट टेस्ट या सर्टिफ़िकेशन टेस्ट में से कोई एक टेस्ट टाइप चुनें और टेस्ट करें पर क्लिक करें.
   • अगर आपको Google के पारिस्थितिक तंत्र में सर्टिफ़िकेट पाने की तैयारी करनी है, तो सर्टिफ़िकेशन टेस्ट चुनें.
   • सर्टिफ़िकेट पाने के लिए, डेवलपमेंट टेस्ट का इस्तेमाल नहीं किया जा सकता.

4. अपना टेस्ट कॉन्फ़िगर करें स्क्रीन पर, अपने टेस्ट के लिए कोई नाम दें. साथ ही, जोड़ने के लिए कोई डिवाइस चुनने के लिए, डिवाइस अपने-आप जोड़ें पर क्लिक करें.

   • Android डिवाइस के लिए:

   

   

   1. पक्का करें कि आपने अपने फ़ोन में GHA इंस्टॉल किया हो.
   2. अपने फ़ोन को यूएसबी केबल की मदद से होस्ट मशीन से कनेक्ट करें.
   3. आपको अपने डिवाइस पर यूएसबी डीबग करने की सुविधा चालू करनी होगी. इसके बाद, APK com.chip.interop.moblysnippet अपने-आप डाउनलोड और इंस्टॉल हो जाएगा.
   4. फ़ोन कनेक्ट होने के बाद, अपने डिवाइस को अपने-आप जोड़ने के लिए, पेयरिंग कोड और डिवाइस का नाम डालें.
   5. iOS डिवाइस के लिए: आपको अपने डिवाइस को मैन्युअल तरीके से जोड़ना होगा. मैन्युअल तरीके से जोड़ने के निर्देशों के लिए, Google Home ऐप्लिकेशन सेक्शन देखें.
   6. अगर आपके पास कोई मौजूदा डिवाइस है, तो आपसे उस डिवाइस को अनपेयर करने और फिर से जोड़ने या किसी नए डिवाइस को जोड़ने के लिए कहा जा सकता है.

5. आगे बढ़ें: प्लान की जांच करें बटन पर क्लिक करें.

6. टेस्ट प्लान बनाएं पेज पर, टेस्ट सुइट सेक्शन में, वे टेस्ट सुइट चुनें जिन्हें आपको चलाना है.

अगर आपको Test Suite से बाहर निकलना है, तो exit_to_app Developer Center पर वापस जाएं पर क्लिक करें.

टेस्ट प्लान चलाना

Test Suite में, टेस्ट प्लान बनाएं पेज पर जाकर, टेस्ट चलाएं पर क्लिक करें. टेस्ट एनवायरमेंट पेज दिखता है. इसमें सभी टेस्ट का स्टेटस और लॉग दिखते हैं.

जांच पूरी होने के बाद, आपको जांच के नतीजे दिखेंगे. हर टेस्ट सुइट के पास, उसके लागू होने का स्टेटस दिखता है (पास हुआ, पास नहीं हुआ).

लॉग पैनल में, हर टेस्ट के स्टेटस की जानकारी दिखती है.

टेस्टिंग एनवायरमेंट पेज पर जाकर, किसी टेस्ट प्लान की फिर से जांच करने के लिए, सबसे ऊपर मौजूद play_circle_filled फिर से जांच करें पर क्लिक करें. ऐसा तब करें, जब टेस्ट पूरा हो गया हो.

पूरा होने के बाद:

• टेस्ट का इतिहास पेज पर जाने के लिए, हो गया पर क्लिक करें या
• सर्टिफ़िकेट के लिए टेस्ट के नतीजे सबमिट करने के लिए, सबमिट करें पर क्लिक करें.

टेस्ट के नतीजे देखना और उनका विश्लेषण करना

Test Suite में टेस्ट का इतिहास पेज पर, किसी डेवलपमेंट प्लान या सबमिट नहीं किए गए सर्टिफ़िकेट टेस्ट प्लान के लिए, पिछले टेस्ट के नतीजे देखे जा सकते हैं. इसके लिए, टेस्ट प्लान सेक्शन में जाकर, अपने पसंदीदा टेस्ट प्लान के लिए फिर से टेस्ट करें पर क्लिक करें. ऐसा करने पर, आपको टेस्ट एनवायरमेंट पेज पर ले जाया जाएगा. यहां आपको उस टेस्ट के नतीजे दिखेंगे.

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

इंटिग्रेशन वर्शन के लिए, जांच के नतीजों को Developer Console में जांच करें टैब से भी ऐक्सेस किया जा सकता है. उस पेज पर मौजूद किसी भी इंटिग्रेशन वर्शन के जांच के इतिहास के लिए, देखें पर क्लिक करें. ऐसा करने पर, आपको Test Suite में जांच के इतिहास वाले पेज पर ले जाया जाएगा.

कंसोल के स्टेटस

टेस्ट फ़ेज़ में, Console में ये स्थितियां दिखती हैं:

Section	स्टेटस	जानकारी	ज़रूरी शर्त	आगे क्या करें
परीक्षण के लिए तैयार	तैयार	integration का यह वर्शन, टेस्ट के लिए तैयार है.	लागू नहीं	integrationके इस वर्शन को आज़माएं.
जांचा गया	तैयार	integration के इस वर्शन की जांच की गई है और इसे Field Trial या सर्टिफ़िकेशन के लिए सबमिट किया जा सकता है.	वर्शन की जांच की गई और उसे सेव कर दिया गया. जिन टेस्ट केस की पुष्टि नहीं हुई है उनमें Google के लिए समीक्षा करने की वजहें शामिल होती हैं.	अगर ज़रूरत हो, तो फिर से जांच करें.

फिर से जांच करें

सर्टिफ़िकेशन

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

डेवलेपमेंट

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

समस्या का हल

टेस्ट सुइट में, कमीशन किया गया डिवाइस न दिखना

अगर आपने किसी डिवाइस को टेस्ट वेंडर आईडी (वीआईडी) और प्रॉडक्ट आईडी (पीआईडी) के साथ जोड़ा है, लेकिन Developer Console में Test Suite की मदद से डिवाइस की जांच करने पर वह नहीं दिखता है, तो ऐसा कई इंटिग्रेशन में एक ही टेस्ट वीआईडी और पीआईडी कॉम्बिनेशन का इस्तेमाल करने की वजह से हो सकता है.

समस्या हल करने के लिए, Developer Console से सभी टेस्ट डिवाइस हटाएं और उस डिवाइस को फिर से जोड़ें जिसकी आपको फिर से जांच करनी है.

यह पुष्टि करने के लिए कि आपने सही डिवाइस जोड़ा है, अपने टेस्ट फ़र्मवेयर में डिवाइस के लिए मैन्युफ़ैक्चरर और मॉडल की जानकारी (CHIP_DEVICE_CONFIG_DEVICE_* वैल्यू) को यूनीक वैल्यू पर सेट किया जा सकता है.

ज़्यादा जानकारी के लिए, डिवाइस की जानकारी देखें.

अपने डिवाइस के VID/PID की पुष्टि करना

अगर आपको Google के साथ इंटिग्रेशन डेवलप करना है, तो आपको Google Home Console पर एक प्रोजेक्ट और इंटिग्रेशन बनाना होगा.

आपके डिवाइस से भेजी जा रही VID/PID वैल्यू, आपके Developer Console प्रोजेक्ट में डाली गई VID/PID वैल्यू से मेल खानी चाहिए.

• वीआईडी 0xFFF1 — 0xFFF4, टेस्टिंग के लिए रिज़र्व हैं. इनका इस्तेमाल, कमिशन करने और कंट्रोल करने से जुड़े बुनियादी टेस्ट के लिए किया जा सकता है. हालांकि, इनका इस्तेमाल डेवलपमेंट के इन चरणों के दौरान नहीं किया जा सकता:
  • जांच करना
  • फ़ील्ड ट्रायल
  • OTA

nRF Connect for Mobile जैसे ब्लूटूथ इंजीनियरिंग ऐप्लिकेशन का इस्तेमाल करके, सेवा डेटा फ़ील्ड में बीकनिंग डिवाइस का VID/PID देखा जा सकता है.

nRF Connect के Android वर्शन के इस स्क्रीनशॉट में, आपको VID/PID को सेवा डेटा फ़ील्ड के चौथे बाइट से शुरू होने वाले 5A23FFFE के तौर पर दिखेगा. इससे पता चलता है कि लिटल इंडियन फ़ॉर्मैट में, वीआईडी 5A23 और पीआईडी FFFE है.

BLE ऐप्लिकेशन, वैल्यू को लिटल इंडियन में दिखाता है, लेकिन Developer Console प्रोजेक्ट में डाली गई VID/PID वैल्यू, बिग इंडियन में होती हैं.

पुष्टि करें कि ब्लूटूथ स्निफ़र से मिली जानकारी के आधार पर, आपके Actions Console प्रोजेक्ट में सही वैल्यू और फ़ॉर्मैट डाले गए हों.

उदाहरण के तौर पर दिए गए स्क्रीनशॉट में दी गई वैल्यू के लिए, Developer Console में VID और PID की वैल्यू, क्रमशः 235A और FEFF होगी.