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 में 'टेस्ट' टैब के बाद से सभी इंटिग्रेशन सूचियों में शामिल किया गया है.
नए वर्शन, नंबर वाले अन्य वर्शन से कभी नहीं बनाए जाते. उदाहरण के लिए, इंटिग्रेशन के लिए आपका बनाया गया पहला टेस्ट प्लान, उस इंटिग्रेशन के लिए v.1 वर्शन बनाएगा. जांच के लिए कोई और प्लान बनाने पर, उस इंटिग्रेशन के लिए v.2 वर्शन बन जाएगा. हालांकि, यह वर्शन v.1 पर आधारित नहीं होगा. इसके बजाय, यह वर्शन v.1 की तरह ही, इंटिग्रेशन के अपग्रेड किए गए इंस्टेंस पर आधारित है.
इंटिग्रेशन का लागू नहीं वर्शन, इंटिग्रेशन के उस इंस्टेंस को दिखाता है जो वर्शन नहीं है. इसे डेवलप करें टैब पर मैनेज किया जाता है.
दूसरे शब्दों में, Matter > Developer Console में जांच करें पर:
- इंटिग्रेशन के लागू नहीं वर्शन के लिए जांच करें पर क्लिक करने पर, एक नया वर्शन बन जाता है. यह वर्शन नंबर, नंबर वाले किसी भी मौजूदा वर्शन से एक ज़्यादा होगा.
- अगर नंबर वाला कोई वर्शन मौजूद नहीं है, तो वर्शन v.1 बनाया जाता है.
- अगर वर्शन v.1 मौजूद है, तो v.2 वर्शन बनाया जाएगा. अगर वर्शन v.2 मौजूद है, तो इसका मतलब है कि वर्शन v.3 बनाया गया है. इसी तरह, बाकी वर्शन भी बनाए जाएंगे.
- अगर इंटिग्रेशन के नंबर वाले वर्शन (उदाहरण के लिए, v.1) के लिए जांच करें पर क्लिक किया जाता है, तो कोई नया वर्शन v.1 बनाया जाता. इसके बजाय, वर्शन v.1 की फिर से जांच की जाती है.
ज़्यादा जानकारी के लिए, इंटिग्रेशन वर्शन देखें.
टेस्ट प्लान बनाएं
इंटिग्रेशन वर्शन, ऐसे इंटिग्रेशन का स्नैपशॉट होते हैं जिसे बदला नहीं गया है. इसका मतलब है कि सर्टिफ़िकेशन के लिए टेस्ट प्लान बनाते समय, इंटिग्रेशन के लिए कोई टेस्ट प्लान बनाते समय, उस इंटिग्रेशन से जुड़ा सारा मेटाडेटा वही होना चाहिए जो आपको लॉन्च किए गए इंटिग्रेशन के लिए इस्तेमाल करना है.
सर्टिफ़िकेशन के लिए टेस्ट प्लान बनाने से पहले, पक्का करें कि आपने ये काम कर लिए हों:
- कंपनी प्रोफ़ाइल बनाई.
- इंटिग्रेशन के लिए, प्रोडक्शन वेंडर आईडी (VID) डाला गया.
- कॉन्फ़िगर किया गया सेटअप और ब्रैंडिंग.
अगर आपने इंटिग्रेशन के लिए ये सभी चरण पूरे नहीं किए हैं, तो सर्टिफ़िकेशन टेस्टिंग के लिए बनाए गए इंटिग्रेशन वर्शन को सर्टिफ़ाइड नहीं किया जा सकता. आपको इसका नया वर्शन बनाना होगा, जिसका मतलब है कि टेस्ट, फ़ील्ड ट्रायल, और प्रमाणित करने के चरणों को फिर से दोहराना है.
अगर इंटिग्रेशन वाले वर्शन के सर्टिफ़ाइड होने से पहले अपनी ब्रैंडिंग को अपडेट करना है, तो आपको एक नया वर्शन भी बनाना होगा और फिर से शुरू करना होगा.
टेस्ट प्लान बनाने के लिए:
प्रोजेक्ट की सूची में जाकर, उस प्रोजेक्ट के बगल में खोलें पर क्लिक करें जिस पर आपको काम करना है.
पेज के बाईं ओर मौजूद नेविगेशन मेन्यू में, Matter > जांच करें पर जाएं.
आपको जिस इंटिग्रेशन की जांच करनी है उसके लागू नहीं वर्शन के लिए, जांच करें पर क्लिक करें. इस कार्रवाई से, इंटिग्रेशन का नया वर्शन बनता है.
डेवलपमेंट टेस्ट या सर्टिफ़िकेशन टेस्ट का टेस्ट टाइप चुनें.
- अगर आप Google नेटवर्क में सर्टिफ़िकेशन के लिए तैयारी कर रहे हैं, तो सर्टिफ़िकेशन टेस्ट चुनें.
- डेवलपमेंट टेस्ट का इस्तेमाल सर्टिफ़िकेशन के लिए नहीं किया जा सकता.
जांचें पर क्लिक करें. अगर आपको कोई डिवाइस नहीं मिला गड़बड़ी वाली स्क्रीन दिखती है, तो इसका मतलब है कि इस इंटिग्रेशन के लिए किसी डिवाइस को अभी तक नेटवर्क में शामिल नहीं किया गया है. ज़्यादा जानकारी के लिए, दूसरे डिवाइस से जोड़ने में समस्या का हल देखें.
टेस्ट कॉन्फ़िगर करें स्क्रीन पर, अपने टेस्ट को एक नाम दें और डिवाइसों की सूची में से उन डिवाइसों को चुनें जिनकी आपको जांच करनी है.
आगे बढ़ें: प्लान को टेस्ट करें बटन पर क्लिक करें.
टेस्ट प्लान बनाएं पेज पर, टेस्ट सुइट सेक्शन में जाकर, वे टेस्ट सुइट चुनें जिन्हें आपको चलाना है.
अगर आपको Test Suite से बाहर निकलना है, तो डेवलपर सेंटर पर वापस जाएं पर क्लिक करें.
टेस्ट प्लान चलाएं
Test Suite में, टेस्ट प्लान बनाएं पेज पर जाकर, टेस्ट करें पर क्लिक करें. सभी टेस्ट की स्थिति और लॉग के साथ, टेस्ट एनवायरमेंट पेज दिखता है.
जांच पूरी होने के बाद, आपको जांच के नतीजे दिखेंगे. इसके बगल में, हर टेस्ट सुइट को चलाने की स्थिति दिखती है (समस्या ठीक हो गई है, पूरा नहीं हो सका).
लॉग पैनल में, हर टेस्ट के लागू होने की स्थिति दिखती है.
टेस्ट एनवायरमेंट पेज से किसी टेस्ट प्लान को फिर से टेस्ट करने के लिए, टेस्ट पूरा होने के बाद सबसे ऊपर फिर से जांच करें पर क्लिक करें.
पूरा हो जाने पर:
- जांच का इतिहास पेज पर जाने के लिए, हो गया पर क्लिक करें या
- टेस्ट के नतीजे सबमिट करने के लिए, सबमिट करें पर क्लिक करें.
अपनी जांच के नतीजे देखना और उन्हें समझना
Test Suite में जांच का इतिहास पेज पर, टेस्ट प्लान सेक्शन में अपनी पसंद के टेस्ट प्लान के लिए, फिर से जांच करें पर क्लिक करें. इसके बाद, डेवलपमेंट प्लान या सबमिट नहीं किए गए सर्टिफ़िकेशन टेस्ट प्लान के पिछले नतीजे देखे जा सकते हैं. यह आपको टेस्ट एनवायरमेंट पेज पर ले जाएगा. यहां उस टेस्ट के नतीजे दिखते हैं.
सबमिट किए गए सर्टिफ़िकेशन प्लान के लिए, सर्टिफ़िकेशन के लिए सेव किए गए सेक्शन में नतीजे पर क्लिक करें और जांच के नतीजों की रिपोर्ट देखें.
इंटिग्रेशन वर्शन के लिए भी जांच के नतीजे, Developer Console में टेस्ट टैब से ऐक्सेस किए जा सकते हैं. जांच का इतिहास देखने के लिए, देखें पर क्लिक करें. ऐसा करने से, उस पेज पर मौजूद किसी भी इंटिग्रेशन वर्शन को Test Suite में जांच का इतिहास पेज पर ले जाया जाएगा.
कंसोल के स्टेटस
जांच के दौरान, कंसोल के ये स्टेटस मिलते हैं:
| Section | Status | जानकारी | ज़रूरी शर्त | आगे क्या करें |
|---|---|---|---|---|
| टेस्ट के लिए तैयार | तैयार है | integration का यह वर्शन जांच के लिए तैयार है. | लागू नहीं | integrationके इस वर्शन की जांच करें. |
| टेस्ट किया गया | तैयार है | integration के इस वर्शन की जांच की गई है और इसे फ़ील्ड ट्रायल या सर्टिफ़िकेशन के लिए सबमिट किया जा सकता है. |
वर्शन की जांच की गई और उसे सेव किया गया. फ़ेल हुए सभी टेस्ट केस में, वे वजहें शामिल होती हैं जिनकी वजह से Google, उनकी समीक्षा कर सकता है. |
ज़रूरत पड़ने पर, फिर से जांच करें. |
समस्या हल करना
टेस्ट सुइट में, कमीशन किया गया डिवाइस नहीं दिखता है
अगर आपने किसी डिवाइस को टेस्ट वेंडर आईडी (VID) और प्रॉडक्ट आईडी (PID) से जोड़ा है, लेकिन Developer Console में टेस्ट सुइट के साथ डिवाइस की जांच करने की कोशिश करने पर यह नहीं दिखता है, तो कई इंटिग्रेशन में एक ही टेस्ट VID और PID कॉम्बो का इस्तेमाल करने की वजह से ऐसा हो सकता है.
समस्या हल करने के लिए, Developer Console से सभी टेस्ट डिवाइस हटाएं और उस डिवाइस को जोड़ें जिसकी आपको फिर से जांच करनी है.
आपने सही डिवाइस को जोड़ा है या नहीं, इसकी पुष्टि करने के लिए, डिवाइस के मैन्युफ़ैक्चरर और मॉडल की जानकारी (CHIP_DEVICE_CONFIG_DEVICE_* वैल्यू) को टेस्ट फ़र्मवेयर की यूनीक वैल्यू पर सेट किया जा सकता है.
अधिक जानकारी के लिए डिवाइस की जानकारी देखें.
अपने डिवाइस के वीआईडी/पीआईडी की पुष्टि करें
अगर आपको Google के साथ इंटिग्रेशन शुरू करना है, तो आपको Google Home Console पर एक प्रोजेक्ट और इंटिग्रेशन बनाना होगा.
आपके डिवाइस में मौजूद वीआईडी/पीआईडी की वैल्यू, Developer Console प्रोजेक्ट में डाले गए वीआईडी/पीआईडी से मेल खानी चाहिए.
0xFFF1—0xFFF4को टेस्ट करने के लिए रिज़र्व रखा गया है. उनका इस्तेमाल बुनियादी कमीशन और कंट्रोल टेस्ट के लिए किया जा सकता है, लेकिन डेवलपमेंट के इन चरणों के दौरान इनका इस्तेमाल नहीं किया जा सकता:
मोबाइल के लिए nRF Connect जैसे ब्लूटूथ इंजीनियरिंग ऐप्लिकेशन का इस्तेमाल करके, सेवा डेटा फ़ील्ड में बीकन डिवाइस का वीआईडी/पीआईडी देखा जा सकता है.
nRF Connect के Android वर्शन से लिए गए इस स्क्रीनशॉट में, आपको दिखेगा कि सेवा डेटा फ़ील्ड के चौथे बाइट से शुरू होने वाले वीआईडी/पीआईडी को 5A23FFFE के तौर पर लिस्ट किया गया है. यह 5A23 के वीआईडी और FFFE के पीआईडी के बारे में बताता है —
दोनों ही छोटे एंडियन फ़ॉर्मैट में होते हैं.
BLE ऐप्लिकेशन, वैल्यू को छोटे एंडियन में दिखाता है, लेकिन अपने Developer Console प्रोजेक्ट में डाले गए VID/PID की वैल्यू बड़े एंडियन में होती हैं.
पुष्टि करें कि ब्लूटूथ स्निफ़र जो दिख रहा है उसके आधार पर आपके Actions Console प्रोजेक्ट में सही वैल्यू और फ़ॉर्मैट डाले गए हैं.
उदाहरण के तौर पर दिए गए स्क्रीनशॉट की वैल्यू के लिए, Developer Console में VID और पीआईडी, 235A और FEFF होंगे.