सामान्य
सवाल: हमें Actions on Google के फ़ुलफ़िलमेंट इन्फ़्रास्ट्रक्चर को कहां और किस भाषा में लागू करना चाहिए?
जवाब: जब तक यह मॉडर्न एसएसएल (TLS) और OAuth 2.0 के साथ काम करता है, तब तक अपने इंफ़्रास्ट्रक्चर को किसी भी प्लैटफ़ॉर्म और अपनी चुनी गई भाषा में लागू किया जा सकता है. हमारा सुझाव है कि आप अपने बाकी इन्फ़्रास्ट्रक्चर के आस-पास डिप्लॉय करें. इससे, उपयोगकर्ताओं के डिवाइसों पर ऐप्लिकेशन को भरोसेमंद बनाने और उन्हें प्रोसेस करने में लगने वाले समय को कम करने में मदद मिलेगी.
सवाल: क्या डिवाइस के आईडी, यूनीक होने चाहिए?
जवाब: आईडी यूनीक होने चाहिए. अगर आपके पास अपनी सेवा के लिए यूनीक आईडी नहीं हैं, तो कम से कम हर उपयोगकर्ता के लेवल पर, वे यूनीक होने चाहिए. मान लें कि किसी ऐसे उपयोगकर्ता के पास कई होम हैं जिसके दोनों होम, एक ही उपयोगकर्ता से जुड़े हों. एक घर में लाइट चालू करने के लिए कहने से, उसी आईडी वाली लाइट दूसरे घर में चालू नहीं होनी चाहिए.
सवाल: क्या डिवाइसों के नाम यूनीक होने चाहिए?
जवाब: ज़रूरी नहीं है कि नाम यूनीक हों. हालांकि, समय के साथ हम लोगों को बेहतर उपयोगकर्ता अनुभव पाने के लिए, सेट अप करने के बाद गलत नाम रखने के लिए बढ़ावा दे सकते हैं.
यहां नाम रखने के लिए एक आसान गाइड दी गई है:
- नाम में वे चीज़ें होनी चाहिए जिन्हें लोग वाकई बोल सकें.
- हम स्ट्रिंग के सबसेट को पहचानते हैं. इसलिए, अगर आपके पास 'ऐक्मे कलर लाइट' है, तो हम 'एक्म लाइट' का भी जवाब देंगे.
- हमारी सलाह है कि प्रॉडक्ट के लिए जानकारी देने वाला नाम और उपयोगकर्ता के तय किए गए एक या ज़्यादा नाम, दोनों का इस्तेमाल करें.
- लोगों को लाइटों के कमरों का नाम देने की ज़रूरत नहीं है, क्योंकि हमारे पास इसके लिए कमरे हैं
सवाल: डिवाइस की स्थिति कितनी बार अपडेट की जाती है?
जवाब: कुछ समय के लिए रिकॉर्ड की गई स्थिति को QUERY या EXECUTE पर फिर से पाया जाता है. ये उपयोगकर्ता की ओर से की जाने वाली कार्रवाइयां होती हैं. अगर उपयोगकर्ता पूछता है कि ‘क्या लाइट चालू है?' या वह रोशनी चमकाना चाहता है, तो हमें मौजूदा स्थिति का पता लगाने के लिए एक क्वेरी करनी होगी.
सवाल: क्या होम ग्राफ़ को सीधे किसी डिवाइस की मौजूदा स्थिति से अपडेट किया जा सकता है?
जवाब: हां, Report State एपीआई कॉल का इस्तेमाल करें.
खाता लिंक करना और OAuth
सवाल: क्या हमें खाता लिंक करना होगा?
जवाब: हां, उपयोगकर्ता के डिवाइस को प्रोवाइडर की क्लाउड सेवाओं से कनेक्ट करने के लिए, खाता लिंक करना ज़रूरी है.
सवाल: OAuth के लिए, हम ऐक्सेस टोकन की समयसीमा हर 15.213 घंटे में खत्म कर देते हैं. क्या यह ठीक है?
जवाब: हां, लेकिन कृपया थोड़े कम समय में इसकी जांच करें. उदाहरण के लिए, 10 से 20 मिनट. हमारे OAuth क्लाइंट को ज़रूरत के हिसाब से टोकन को रीफ़्रेश करना चाहिए. साथ ही, इसकी समयसीमा को कम करके टेस्ट करने से यह साबित हो जाएगा कि यह काम कर रहा है.
मूड
सवाल: सिंक कब होता है?
जवाब: OAuth के पूरा होने के तुरंत बाद और सिंक का अनुरोध करें कॉल करने के बाद सिंक होता है.
सवाल: SYNC काम क्यों नहीं कर रहा है?
जवाब: कई सामान्य वजहों से ऐसा हो सकता है.
गलत डिवाइस टाइप भेजे जा रहे हैं.
- उदाहरण के लिए, हमें
action.devices.types.LIGHTकी उम्मीद थी, लेकिन आपनेaction.devices.types.Lightभेजा.
- उदाहरण के लिए, हमें
आप ऐसे डिवाइस भेज रहे हैं जिन पर यह सुविधा काम नहीं करती.
- उदाहरण के लिए, आपने
action.devices.types.FLASHLIGHTभेजा है - हम यह विकल्प नहीं देते.
- उदाहरण के लिए, आपने
आप अमान्य/असमर्थित फ़ील्ड भेज रहे हैं.
- उदाहरण के लिए, आपके पास वर्शन फ़ील्ड या कोई ऐसा दूसरा फ़ील्ड है जो हमारे स्पेसिफ़िकेशन में शामिल नहीं है.
आपके सिंक के जवाब में फ़ॉर्मैटिंग की कोई दूसरी समस्या है.
- अपने ब्रैकेट की जांच करें!
आपको खाता जोड़ने में समस्या आ रही है.
- कृपया पुष्टि करें कि आपको सिंक के अनुरोध के पुष्टि हेडर में मान्य ऐक्सेस टोकन मिल रहा है.
सिंक करने के अनुरोध का जवाब देने में बहुत ज़्यादा समय लग रहा है.
- कृपया पुष्टि करें कि सिंक के अनुरोध का जवाब 5 सेकंड में दिया जा रहा है.
सवाल: क्या “मंज़ूरी बाकी है” जवाब ठीक है?
उ: अगर आपके डिवाइस रीयल टाइम में उपलब्ध हैं, तो हम लंबित के बजाय सफल/असफल प्रतिक्रिया को प्राथमिकता देते हैं. अगर आपको लगता है कि आपको 'पुष्टि होना बाकी है' जवाब की ज़रूरत है, तो कृपया हमसे संपर्क करें. हम समझते हैं कि कुछ कम पावर वाले, नॉन-रीयल-टाइम डिवाइसों पर, प्रोसेस के लिए बाकी बचे जवाब और एसिंक्रोनस एक्ज़ीक्यूशन मॉडल की ज़रूरत पड़ सकती है.
जांच और सबमिशन
सवाल: क्या हम स्टेजिंग एनवायरमेंट सेट अप कर सकते हैं?
जवाब: हां, कृपया एक अलग प्रोजेक्ट बनाएं और उस प्रोजेक्ट का सेटअप पूरा करें. अपनी डेवलपमेंट प्रोसेस और इंफ़्रास्ट्रक्चर को मैप करने के लिए, आप जितने चाहें उतने प्रोजेक्ट बना सकते हैं.
सवाल: मुझे अपने ड्राफ़्ट प्रोजेक्ट को कितनी बार अपडेट करना होगा?
जवाब: ड्राफ़्ट प्रोजेक्ट को हर तीन दिन में रीफ़्रेश किया जाना चाहिए. तीन दिनों के बाद, टेस्ट एजेंट मोबाइल-HomeControl सेटिंग से हट जाएगा. अगर आपको इसमें शामिल करना है, तो Actions on Google Console में अपने प्रोजेक्ट के लिए टेस्ट ड्राफ़्ट बटन पर क्लिक करें.
सवाल: क्या एक बार में एक से ज़्यादा डिवाइसों पर टेस्ट किया जा सकता है?
जवाब: Actions on Google एक बार में सिर्फ़ एक "डिवाइस पर आज़माएं" AP के साथ काम करता है. अगर आप "ap1" पर पहली बार टेस्ट ड्राफ़्ट का इस्तेमाल करते हैं और डिवाइसों को सिंक करते हैं, तो (ap1 को अनलिंक किए बिना) सीधे TEST DRAFT "ap2" चलाएं. मोबाइल-HomeControl-सेटिंग से "ap1" हट जाएगा. इसे ठीक करने के लिए, "ap1" पर टेस्ट ड्राफ़्ट फिर से चलाएं और सेटिंग में जाकर "ap1" को अनलिंक किया जा सकता है.
ध्यान दें कि यह एक ऐक्शन पैकेज, उपयोगकर्ता के लिए आपके सभी Google Assistant डिवाइसों पर उपलब्ध होगा. उदाहरण के लिए, आवाज़ से चालू किए गए स्पीकर और Android, दोनों पर अपने नए हार्डवेयर इंटिग्रेशन की जांच की जा सकती है.
सवाल: नाम या उच्चारण की वजह से, मेरे ऐक्शन प्रोजेक्ट के सबमिशन को अस्वीकार कर दिया गया था. मुझे क्या बदलाव करना है?
जवाब: हम नाम के उच्चारण की जांच करते हैं, ताकि यह पक्का किया जा सके कि आने वाले समय में कोई दूसरी कार्रवाई, उच्चारण के नाम को लागू न करे और वह डिसप्ले नेम से मेल खाए. इससे, आने वाले समय में नामों के रजिस्ट्रेशन पर असर डालने वाले गलत इस्तेमाल को रोकने में मदद मिलेगी.
इस नाम का इस्तेमाल जारी रखने के लिए, कृपया सहायता टीम से संपर्क करें और स्पीच टीम की तरफ़ से Assistant में डिसप्ले नेम जोड़ने के लिए, संपर्क करें.
सवाल: Google Home ऐप्लिकेशन के होम कंट्रोल सेक्शन में, मेरी सेट की गई कार्रवाई नहीं दिख रही है, ऐसा क्यों हो रहा है?
जवाब: समस्या इनमें से कोई एक हो सकती है:
- आपने Actions Console में अपने प्रोजेक्ट के लिए, टेस्ट ड्राफ़्ट बटन पर क्लिक नहीं किया.
- डिवाइस पर टेस्ट ऐप्लिकेशन में, एक बार में सिर्फ़ एक कार्रवाई की जा सकती है.
- Actions Console में, अपने ऐक्शन प्रोजेक्ट के सिम्युलेटर टैब पर जाएं. इसके बाद, चालू/बंद टॉगल को 'बंद है' पर टॉगल करके, फिर से 'चालू है' पर टॉगल करें.
- अगर यह कार्रवाई आपके साथ शेयर की गई है, तो कृपया पक्का करें कि शेयर करने के सभी निर्देशों का पालन किया गया हो.
- डिवाइस के टेस्ट की समयसीमा तीन दिनों के बाद खत्म हो जाती है. Actions Console में अपने प्रोजेक्ट के लिए, ड्राफ़्ट की जांच करें बटन पर क्लिक करें.
सवाल: सिम्युलेटर में "talk to <my agent name>" टाइप करने पर, मुझे गड़बड़ी का मैसेज क्यों दिखता है?
जवाब: स्मार्ट होम की कार्रवाइयों में, बोले जाने वाले नामों का इस्तेमाल नहीं किया जाता है. सिम्युलेटर में जांच करने के लिए, आपको Android या iOS फ़ोन पर खाता लिंक करना होगा, जिस पर Google Home app (GHA) इंस्टॉल किया गया हो. खाता जोड़ने की प्रक्रिया शुरू करने से पहले, आपके पास अपने खाते से जुड़े डिवाइस भी होने चाहिए.
सवाल: सिम्युलेटर का इस्तेमाल करते समय, मुझे गड़बड़ियां क्यों मिल रही हैं?
जवाब: लागू की गई smart home कार्रवाइयों की जांच करने के लिए सिम्युलेटर का इस्तेमाल नहीं किया जा सकता. अगर आपको किसी ऐसे होम ऑटोमेशन प्रोजेक्ट के लिए सिम्युलेटर का इस्तेमाल करना है जो अभी प्रोडक्शन में है, तो आपको जांच के लिए एक नया प्रोजेक्ट बनाना होगा.
रिपोर्ट की स्थिति
सवाल: क्या रिपोर्ट की स्थिति लागू करने के लिए ज़रूरी शर्तें हैं?
जवाब: प्रोजेक्ट को स्मार्ट होम एपीआई का इस्तेमाल करना होगा और OAuth2 के साथ काम करना होगा. साथ ही, प्रोजेक्ट में ऐसी विशेषताएं होनी चाहिए जिनकी स्थिति(स्थितियों) को रिपोर्ट किया जाना हो.
सवाल: हमें किसी डिवाइस पर स्थिति की शिकायत कितनी बार करनी होगी?
जवाब: Google की दिलचस्पी ट्रांज़िशन और टर्मिनल की स्थिति में है. हालांकि, अगर कम समय में कई स्थितियों में बदलाव होते हैं (उदाहरण के लिए, कोई उपयोगकर्ता एक मिनट में फ़्रिज को तीन बार खोलता और बंद करता है या डिमर को स्लाइड करता है), तो हमें सिर्फ़ आखिरी स्थिति की जानकारी चाहिए.
सवाल: क्या रिपोर्ट स्टेट कॉल करते समय, डिवाइस की पूरी जानकारी देना ज़रूरी है?
जवाब: अधूरे स्टेटस को अपडेट नहीं किया जा सकता. इसलिए, Report State कॉल में हमेशा अपडेट की गई किसी खास ट्रैट का पूरा डेटा शामिल होना चाहिए. अगर दो विशेषताओं की वजह से अंतर पैदा होता है, तो उनकी फिर से रिपोर्ट की जानी चाहिए.
सवाल: क्या Google, मेरे डिवाइस की स्थिति जानने के लिए, उसके बारे में क्वेरी कर सकता है (इसका मतलब है कि डिवाइस की पोलिंग करानी है)?
जवाब: यह एक फ़ॉलबैक तरीका है. हम इसका सुझाव नहीं देते. अगर हमें ऐसे उपयोगकर्ताओं के लिए बार-बार किसी डिवाइस के पोल कराने की ज़रूरत पड़े, तो हम इस बात की गारंटी नहीं दे सकते कि यह अतिरिक्त लोड कितना होगा. यह ज़रूरत नए विज़ुअल प्लैटफ़ॉर्म की वजह से आ रही है. इसके अलावा, लोड होने की अनजान समस्या के अलावा, उपयोगकर्ता को खराब अनुभव मिलेगा. हमें लगता है कि इस प्लैटफ़ॉर्म के लिए Report State अहम है.
सवाल: फ़िलहाल, किस तरह की traits रिपोर्ट की स्थिति के बारे में बताती है?
जवाब: ऐसे सभी सार्वजनिक एट्रिब्यूट काम करते हैं जिनके राज्यों से जुड़े होते हैं. डिवाइस की ऑनलाइन स्थिति में होने वाले किसी भी बदलाव की रिपोर्ट भी की जानी चाहिए.
ध्यान दें कि सीन में स्थितियां नहीं होती हैं. हालांकि, उनकी वजह से डिवाइस(डिवाइसों) की स्थिति(स्थितियों) में बदलाव हो सकता है. अगर Google Home Graph में किसी भी डिवाइस की स्थिति में बदलाव होता है, तो इसकी फिर से रिपोर्ट की जानी चाहिए.
सवाल: क्या रिपोर्ट की स्थिति के लिए टाइमस्टैंप भेजना ज़रूरी है?
जवाब: हमें टाइमस्टैंप की ज़रूरत नहीं होती. पिछली बार भेजे गए मैसेज की स्थिति, पिछले कॉल को ओवरराइड कर देगी.
सवाल: अगर मैं पहले से ही क्वेरी में राज्य की जानकारी भेज रहा/रही हूं और/या पूरी कर रहा/रही हूं, तो क्या मुझे अलग से स्थिति की रिपोर्ट करनी होगी?
जवाब: Home Graph सिर्फ़ उस राज्य को सेव करता है जिसे Report State से भेजा जाता है. EXECUTE और QUERY इंटेंट के जवाब के तौर पर मिलने वाली स्थिति का इस्तेमाल, सिर्फ़ उपयोगकर्ता के बोलकर दिए जाने वाले रिस्पॉन्स के लिए किया जाता है और इसे सेव नहीं किया जाता. इसलिए, Report State को कॉल किया जाना चाहिए, भले ही डिवाइस की नई स्थिति, EXECUTE या QUERY इंटेंट के रिस्पॉन्स के तौर पर पहले ही लौटा दी गई हो.
सवाल: दी गई समयसीमा के अंदर रिपोर्ट के स्टेटस को पूरी तरह से लागू न करने पर क्या होगा?
जवाब: इसकी वजह से, उपयोगकर्ता का अनुभव खराब होगा. उदाहरण के लिए, GHA और विज़ुअल प्लैटफ़ॉर्म पर. इसका मतलब होगा कि हमारे पास राज्य के लिए कई QUERY इंटेंट होंगे, जिन्हें पोल के लिए भेजा जाएगा और हम इस बात की गारंटी नहीं दे सकते कि पार्टनर क्लाउड पर ज़्यादा लोड के लिए यह सवाल क्या होगा.
सवाल: मैं रिपोर्ट के लागू होने की स्थिति की जांच कैसे करूं?
जवाब: होम ग्राफ़ व्यूअर का इस्तेमाल करें - यह सेल्फ़-सर्विस टेस्टिंग टूल है जो आपको Home Graph में सेव किए गए आपके डिवाइस की मौजूदा स्थिति दिखाता है.
सवाल: क्या हम रिपोर्ट की स्थिति के लिए, किसी भी क्रम में अनुरोध आईडी का इस्तेमाल कर सकते हैं?
जवाब: हमारा सुझाव है कि अगर EXECUTE अनुरोध से Report State ट्रिगर होता है, तो पार्टनर उसी अनुरोध आईडी का इस्तेमाल करें जो EXECUTE अनुरोध से मिला है. ऐसा न करने पर, किसी भी रैंडम अनुरोध आईडी का इस्तेमाल किया जा सकता है.
सवाल: अगर किसी उपयोगकर्ता के पास एक से ज़्यादा डिवाइस हैं और उनमें से किसी एक की स्थिति बदल जाती है, तो क्या हमें सभी डिवाइसों की नई स्थिति की रिपोर्ट करनी होगी?
जवाब: नहीं. आपको सिर्फ़ उस डिवाइस की स्थिति की रिपोर्ट देनी होगी.
सबसे सही तरीके
सवाल: इंतज़ार के समय को किस तरह से स्वीकार किया जाता है?
जवाब: 200 मि॰से॰ से कम का समय सही है. 2 से 5 सेकंड के बीच का समय सही है. अगर इंतज़ार का समय पांच सेकंड के आस-पास है, तो हमसे संपर्क करें.
सवाल: ऑफ़लाइन होने पर, आवाज़ से चालू होने वाला स्पीकर कैसे काम कर सकता है?
A: ऑफ़लाइन डिवाइसों के लिए ऑफ़लाइन स्थिति दिखाएं. इस गड़बड़ी के लिए हम टीटीएस के तौर पर 'अभी उपलब्ध नहीं' लौटाते हैं. ज़्यादा जानकारी के लिए, गड़बड़ियां और अपवाद देखें.