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 की सभी इंटिग्रेशन सूचियों में शामिल किया गया है.

नए वर्शन, नंबर वाले दूसरे वर्शन से कभी नहीं बनाए जाते. उदाहरण के लिए, इंटिग्रेशन के लिए जो पहला टेस्ट प्लान बनाया जाएगा, वह उस इंटिग्रेशन के लिए 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 की फिर से जांच की जाती है.

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

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

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

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

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

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

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

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

Play Console पर जाएं

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

  2. पेज के बाईं ओर मौजूद नेविगेशन मेन्यू में, Matter > जांच करें पर जाएं.

  3. आपको जिस इंटिग्रेशन की जांच करनी है उसके लागू नहीं वर्शन के लिए, जांच करें पर क्लिक करें. इस कार्रवाई से एक नया इंटिग्रेशन वर्शन बनता है.

  4. डेवलपमेंट टेस्ट या सर्टिफ़िकेशन टेस्ट में से कोई एक टेस्ट चुनें. नया टेस्ट प्लान बनाना

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

  6. अपना टेस्ट कॉन्फ़िगर करें स्क्रीन पर, अपने टेस्ट को कोई नाम दें और डिवाइसों की सूची में से वे डिवाइस चुनें जिनकी आपको जांच करनी है.

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

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

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

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

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

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

टेस्ट पूरे होने के बाद, आपको जांच के नतीजे दिखेंगे. हर टेस्ट सुइट के एक्ज़ीक्यूट की स्थिति इसके बगल में दिखती है (समस्या ठीक हो गई है, पूरा नहीं हुआ).

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

परीक्षण परिणाम

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

खत्म होने पर:

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

जांच के नतीजे देखना और उन्हें समझना

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

जांच का इतिहास

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

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

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

टेस्ट के दौरान, Console के ये स्टेटस दिखते हैं:

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

वर्शन की जांच की गई और उसे सेव किया गया.

सभी सफल न होने वाले टेस्ट मामलों में, वे वजहें शामिल होती हैं जिनकी वजह से Google, उनकी समीक्षा करता है.

अगर आप चाहें, तो फिर से जांच करें.

समस्या हल करना

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

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

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

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

अधिक जानकारी के लिए डिवाइस की जानकारी देखें.

अपने डिवाइस के वीआईडी/पीआईडी की पुष्टि करें

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

ब्लूटूथ स्निफ़र की समस्या हल करना

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

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

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

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

बीएलई ऐप्लिकेशन, वैल्यू को छोटे एंडियन में दिखाता है, लेकिन आपने Developer Console प्रोजेक्ट में जो वीआईडी/पीआईडी वैल्यू डाली हैं वे बड़े एंडियन में होती हैं.

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

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