Google Play Games की सेवाएं सेट अप की जा रही हैं

इस दस्तावेज़ में बताया गया है कि अपने Android गेम के लिए Google Play गेम सेवाएं सेट अप करने के लिए, Google Play Console का इस्तेमाल कैसे करें. Google Play Console आपको गेम सेवाओं को मैनेज करने और अपने गेम की पुष्टि करने के लिए मेटाडेटा को कॉन्फ़िगर करने की एक ही जगह उपलब्ध कराता है.

Google Play Console में अपना गेम जोड़ने के लिए, यह सामान्य तरीका अपनाएं:

• अपने गेम के लिए गेम प्रोजेक्ट बनाएं. साथ ही, गेम का नाम और ब्यौरा जैसी जानकारी दें.
• Google Play की गेम सेवाओं से गेम की पुष्टि करने और उसकी पुष्टि करने के लिए, ज़रूरी क्रेडेंशियल बनाएं और उन्हें लिंक करें.

नीचे दिए गए सेक्शन में, इन चरणों के बारे में ज़्यादा जानकारी दी गई है.

पहला चरण. Google Play Console में साइन इन करना

साइन इन करने के लिए, Google Play Console पर जाएं. अगर आपने Google Play Console के लिए पहले रजिस्टर नहीं किया है, तो आपको ऐसा करने के लिए कहा जाएगा.

दूसरा चरण. Google Play Console में अपना गेम जोड़ें

अपना गेम जोड़ने के लिए, यह तरीका अपनाएं:

1. अगर आपने पहले से कोई गेम नहीं बनाया है, तो Play Console में गेम बनाएं. ज़्यादा जानकारी के लिए यहां देखें.
2. बढ़ाएं > Play की गेम सेवाएं > सेट अप और मैनेजमेंट > कॉन्फ़िगरेशन पर जाएं.

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

   • Play की गेम सेवाओं का नया प्रोजेक्ट बनाना: Play Games सेवा से जुड़ा प्रोजेक्ट बनाने के लिए, क्लाउड प्रोजेक्ट होना ज़रूरी है.

     • अगर आपके पास इस गेम के लिए पहले से ही कोई क्लाउड प्रोजेक्ट है, तो ड्रॉपडाउन सूची से अपना क्लाउड प्रोजेक्ट चुनें और इस्तेमाल करें चुनें.

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

   • Play की गेम सेवाओं के किसी मौजूदा प्रोजेक्ट का इस्तेमाल करना: अगर मौजूदा पैकेज का नाम बदलने के लिए Play Console में कोई नया गेम बनाया जा रहा है या आपके पास अलग-अलग पैकेज नाम वाले गेम के मुफ़्त और पैसे चुकाकर वर्शन इस्तेमाल करने वाले वर्शन हैं, तो इस विकल्प का इस्तेमाल किया जा सकता है. Play की गेम सेवाओं से जुड़ा प्रोजेक्ट चुनें और इस्तेमाल करें पर क्लिक करें.

4. Play की गेम सेवाओं का एक गेम प्रोजेक्ट बनाया जाता है और उससे जुड़ी एंट्री आपके लिए Google Cloud कंसोल में बनाई जाती है.

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

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

तीसरा चरण. OAuth 2.0 क्लाइंट आईडी जनरेट करना

आपके गेम की पुष्टि करने और उसे Google Play की गेम सेवाओं पर कॉल करने की अनुमति पाने के लिए, OAuth 2.0 क्लाइंट आईडी होना ज़रूरी है. Play की गेम सेवाओं के लिए क्रेडेंशियल सेट अप करने के लिए Google Cloud Platform का इस्तेमाल करके क्लाइंट आईडी बनाएं. यह क्लाइंट आईडी और गेम के बीच का असोसिएशन होता है. इसके बाद, Google Play Console का इस्तेमाल करके क्रेडेंशियल जोड़ें, क्लाइंट आईडी को अपने गेम से जोड़ें.

ज़्यादा जानकारी के लिए, नीचे दिया गया तरीका अपनाएं:

a. उस स्क्रीन को कॉन्फ़िगर करना जहां OAuth के लिए सहमति दी जाती है

अगर आपने अभी तक OAuth के लिए सहमति वाली स्क्रीन कॉन्फ़िगर नहीं की है, तो क्रेडेंशियल सेक्शन में आपको कॉन्फ़िगर करने के लिए एक मैसेज दिखेगा.

कॉन्फ़िगर करें पर क्लिक करें. इससे, आगे के निर्देशों वाला एक डायलॉग बॉक्स खुलता है. साथ ही, Google Cloud Platform के लिए डीप लिंक भी खुलता है.

ध्यान दें: पक्का करें कि सहमति वाली स्क्रीन उन सभी लोगों के लिए उपलब्ध हो जिनके लिए गेम उपलब्ध है. दायरों की आखिरी सूची में games, games_lite, और drive.appdata शामिल होने चाहिए. इनमें से किसी भी दायरे के लिए, ऐप्लिकेशन की पुष्टि करने की ज़रूरत नहीं होगी. हमारा सुझाव है कि सहमति देने वाली स्क्रीन को तुरंत पब्लिश करें. अगर ऐसा नहीं हो सकता, तो टेस्टर को गेम में साइन-इन करने की अनुमति देने के लिए, सहमति वाली स्क्रीन उपलब्ध कराई जा सकती है.

अगर आपने OAuth के लिए सहमति देने वाली स्क्रीन का सेटअप पूरा कर लिया है, तो हो गया पर क्लिक करें. Google Play Console अपने-आप रीफ़्रेश हो जाता है. कॉन्फ़िगरेशन पूरा होने पर आप क्रेडेंशियल बना पाएंगे:

b. क्रेडेंशियल बनाना

अपने गेम को Google Play की गेम सेवाओं का इस्तेमाल करने की अनुमति देने के लिए, आपको अनुमति वाले OAuth2 क्लाइंट आईडी से क्रेडेंशियल बनाना होगा.

क्रेडेंशियल सेक्शन में, क्रेडेंशियल जोड़ें पर क्लिक करें.

विज़र्ड में, चुनें कि आपको Android क्रेडेंशियल बनाना है (अगर आपके गेम का APK, उपयोगकर्ता की पुष्टि करेगा और PGS एपीआई का इस्तेमाल करेगा) या गेम सर्वर क्रेडेंशियल (अगर आपका गेम सर्वर PGS एपीआई का इस्तेमाल करेगा). अपने मनचाहे क्रेडेंशियल टाइप के लिए खास निर्देशों का पालन करें.

Android

क्रेडेंशियल की जानकारी सेट अप करना

यह पक्का करें कि नाम फ़ील्ड में दिया गया नाम आपके गेम के नाम से मेल खाता हो. चुनें कि पायरेसी चालू करनी है या नहीं.

अनुमति देने की सुविधा सेट अप करें

इसके बाद, इस गेम प्रोजेक्ट के लिए इस्तेमाल करने के लिए कोई OAuth क्लाइंट आईडी चुनें. अगर आपके पास पहले से OAuth2 क्लाइंट आईडी हैं, तो इनमें से कोई एक चुनें. हालांकि, आम तौर पर आपको नया खाता बनाना होता है. OAuth क्लाइंट बनाएं पर क्लिक करें. इससे डीप लिंक और Google Cloud Platform में OAuth क्लाइंट आईडी बनाने के निर्देशों वाला एक डायलॉग बॉक्स खुलेगा.

1. ऐप्लिकेशन टाइप के तौर पर Android चुनें.
2. नाम फ़ील्ड में अपने गेम का नाम डालें.
3. पैकेज का नाम फ़ील्ड में अपने Android ऐप्लिकेशन के पैकेज का नाम डालें.

4. कोई टर्मिनल खोलें और रिलीज़ के SHA1 फ़िंगरप्रिंट पाने और डीबग सर्टिफ़िकेट पाने के लिए Keytoolutility चलाएं.

   रिलीज़ सर्टिफ़िकेट का फ़िंगरप्रिंट पाने के लिए, यह निर्देश दें:

   keytool -list -keystore <path-to-production-keystore> -v

   डीबग सर्टिफ़िकेट का फ़िंगरप्रिंट पाने के लिए, यह निर्देश दें:

   keytool -list -keystore <path-to-debug-keystore> -v

   ध्यान दें: Windows पर, डीबग कीस्टोर C:\Users\<USERNAME>\.android\debug.keystore पर मौजूद होता है. Mac या Linux पर, डीबग कीस्टोर आम तौर पर ~/.android/debug.keystore पर होता है.

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

6. SHA1 फ़िंगरप्रिंट को साइनिंग सर्टिफ़िकेट वाले फ़िंगरप्रिंट (SHA1) फ़ील्ड में चिपकाएं.

7. बनाएं पर क्लिक करें.

Android पर OAuth 2.0 के बारे में ज़्यादा जानकारी के लिए, OAuth2 सेवाओं में पुष्टि करना देखें.

चेतावनी: इस चरण में कॉन्फ़िगर किए गए पैकेज के नाम और साइनिंग सर्टिफ़िकेट को रिकॉर्ड करना न भूलें. अपने ऐप्लिकेशन में किसी दूसरे सर्टिफ़िकेट या पैकेज के नाम का इस्तेमाल करने पर पुष्टि नहीं हो पाएगी.

डायलॉग में हो गया पर क्लिक करने के बाद, उपलब्ध क्लाइंट आईडी रीफ़्रेश हो जाएंगे. ड्रॉप-डाउन मेन्यू से वह क्रेडेंशियल चुनें जो आपने बनाया था. इसके बाद, बदलाव सेव करें पर क्लिक करें. इससे ड्राफ़्ट के तौर पर क्रेडेंशियल बन जाता है, जिससे आपको अपने गेम में Play की गेम सेवाओं के लिए पुष्टि करने की सुविधा मिल जाती है.

आप शायद दो क्रेडेंशियल बनाना चाहें: एक रिलीज़ सर्टिफ़िकेट फ़िंगरप्रिंट से और दूसरा डीबग सर्टिफ़िकेट के फ़िंगरप्रिंट से. पक्का करें कि दोनों के लिए एक ही पैकेज नाम का इस्तेमाल किया गया हो. इससे Google Play की गेम सेवाएं आपके लिंक किए गए APK से उन कॉल की पहचान कर पाती हैं जिन पर किसी भी सर्टिफ़िकेट से साइन किया गया है. Android के लिए सर्टिफ़िकेट पर हस्ताक्षर करने के बारे में ज़्यादा जानने के लिए, अपने ऐप्लिकेशन पर हस्ताक्षर करना लेख पढ़ें.

गेम सर्वर

क्रेडेंशियल की जानकारी सेट अप करना

यह पक्का करें कि नाम फ़ील्ड में दिया गया नाम आपके गेम के नाम से मेल खाता हो.

अनुमति देने की सुविधा सेट अप करें

इसके बाद, इस गेम प्रोजेक्ट के लिए इस्तेमाल करने के लिए कोई OAuth क्लाइंट आईडी चुनें. अगर आपके पास पहले से OAuth2 क्लाइंट आईडी हैं, तो इनमें से कोई एक चुनें. हालांकि, आम तौर पर आपको नया खाता बनाना होता है. OAuth क्लाइंट बनाएं पर क्लिक करें. इससे डीप लिंक और Google Cloud Platform में OAuth क्लाइंट आईडी बनाने के निर्देशों वाला एक डायलॉग बॉक्स खुलेगा.

1. ऐप्लिकेशन टाइप के तौर पर वेब ऐप्लिकेशन चुनें.
2. नाम फ़ील्ड में अपने गेम का नाम डालें.
3. बनाएं पर क्लिक करें.

Android पर OAuth 2.0 के बारे में ज़्यादा जानकारी के लिए, OAuth2 सेवाओं में पुष्टि करना देखें.

डायलॉग में हो गया पर क्लिक करने के बाद, उपलब्ध क्लाइंट आईडी रीफ़्रेश हो जाएंगे. ड्रॉप-डाउन मेन्यू से वह क्रेडेंशियल चुनें जो आपने बनाया था. इसके बाद, बदलाव सेव करें पर क्लिक करें. इससे क्रेडेंशियल के तौर पर ड्राफ़्ट बन जाता है, जिससे आपको अपने गेम सर्वर से Play की गेम सेवाओं के लिए पुष्टि करने की सुविधा मिलती है. अपने गेम सर्वर के साथ Play की गेम सेवाओं का इस्तेमाल करने के बारे में ज़्यादा जानकारी के लिए, Google Play Games सेवाओं का सर्वर-साइड ऐक्सेस चालू करना देखें.

सेटअप से जुड़ी सामान्य समस्याओं से बचना

सेटअप से जुड़ी आम गलतियों से बचने के लिए, Google Play की गेम सेवाओं के इस्तेमाल के लिए अपना गेम सेट अप करते समय इन सुझावों का पालन करें.

1. Google Play Console की मदद से अपना गेम सेट अप करना

अगर आपने Google Cloud Console में अपने ऐप्लिकेशन के लिए Oauth 2.0 क्लाइंट आईडी बनाया है, तो Google Play की गेम सेवाओं को गेम की उपलब्धि, लीडरबोर्ड, और क्लाइंट आईडी के बीच संबंध के बारे में पता नहीं चलेगा. इसे असोसिएट करने के लिए, आपको Oauth 2.0 क्लाइंट आईडी का इस्तेमाल करके क्रेडेंशियल बनाना होगा, जैसा कि क्रेडेंशियल बनाएं में बताया गया है.

2. Android में सही ऐप्लिकेशन आईडी का उपयोग करें

ऐप्लिकेशन आईडी एक ज़रूरी स्ट्रिंग संसाधन है जिसका रेफ़रंस आपको Android मेनिफ़ेस्ट में देना होगा. ऐप्लिकेशन आईडी स्ट्रिंग में, Google Play Console से दिए गए क्लाइंट आईडी की शुरुआत में सिर्फ़ अंक (आम तौर पर, 12 या उससे ज़्यादा) होते हैं. ऐप्लिकेशन आईडी, कॉन्फ़िगरेशन पेज में सबसे ऊपर मिल सकता है. साथ ही, इसे आपके गेम के नाम के नीचे प्रोजेक्ट आईडी के तौर पर लेबल किया जाता है.

3. अपने APK पर सही प्रमाणपत्र से हस्ताक्षर करें

अपने Android ऐप्लिकेशन को Google Play Console में मौजूद गेम से जोड़ते समय, आपको उसी पैकेज का नाम और सर्टिफ़िकेट का फ़िंगरप्रिंट इस्तेमाल करना होगा जो आपने ऐप्लिकेशन पब्लिश करने के लिए इस्तेमाल किया था. मेल न खाने पर, Google Play की गेम सेवाओं को किए जाने वाले कॉल नहीं हो पाएंगे. आपको दो क्लाइंट आईडी बनाने चाहिए. इनमें से एक, रिलीज़ सर्टिफ़िकेट के फ़िंगरप्रिंट के साथ और दूसरा डीबग सर्टिफ़िकेट फ़िंगरप्रिंट के साथ होना चाहिए. साथ ही, दोनों के लिए एक ही पैकेज नाम का इस्तेमाल करना चाहिए. Google Play Console में साइनिंग सर्टिफ़िकेट तय करने के तरीके के बारे में ज़्यादा जानने के लिए, अपने ऐप्लिकेशन पर साइन करना देखें.

4. Android के लिए डेवलप करते समय, Play Games SDK टूल को लाइब्रेरी प्रोजेक्ट के तौर पर शामिल करें. इसे JAR के तौर पर न जोड़ें

पक्का करें कि आपके Android प्रोजेक्ट में Google Play services का SDK टूल, लाइब्रेरी प्रोजेक्ट के तौर पर बताया गया हो. ऐसा न करने पर, जब आपका ऐप्लिकेशन Google Play services के संसाधन नहीं ढूंढ पाएगा, तब गड़बड़ियां हो सकती हैं. Google Play services का इस्तेमाल करने के लिए, अपना Android प्रोजेक्ट सेट अप करने का तरीका जानने के लिए, Google Play Services सेट अप करना देखें.

5. डेवलपमेंट के दौरान टेस्टर खाते से साइन इन करें

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

6. Google Cloud Platform में सहमति वाली स्क्रीन पब्लिश करना

Google Play Console में ऐप्लिकेशन पब्लिश करने से पहले, Google Cloud Platform पर सहमति वाली स्क्रीन को पब्लिश करें. इस चरण के बिना, सार्वजनिक दर्शक Play की गेम सेवाओं की किसी भी सुविधा का इस्तेमाल नहीं कर पाएंगे.

7. रिलीज़ के समय, अपना गेम पब्लिश करने से पहले, Play की गेम सेवाओं की सेटिंग को पब्लिश करें

ऐसा हो सकता है कि डेवलपर अपने ऐप्लिकेशन के लिए, Google Play की गेम सेवाओं की सेटिंग पब्लिश किए बिना ही गलती से अपने ऐप्लिकेशन को पब्लिश कर दें. इससे नॉन-टेस्टर खातों से साइन इन करने वाले खिलाड़ियों को गड़बड़ियों का सामना करना पड़ सकता है. ऐसा इसलिए होता है, क्योंकि ऐप्लिकेशन गेम की सही सेटिंग का रेफ़रंस नहीं दे सकता. अपने गेम को रिलीज़ करते समय, सबसे पहले अपनी गेम सेटिंग पब्लिश करना न भूलें. इसके लिए, Google Play Console में गेम पब्लिश करें विकल्प का इस्तेमाल करें. अपने बदलावों को पब्लिश करने का तरीका जानने के लिए, गेम में किए गए बदलावों को पब्लिश करना देखें.

अन्य सलाह पाने के लिए, इन्हें देखें:

• Android की समस्या हल करने वाली गाइड - डेवलपर के दस्तावेज़ में, Android गेम डेवलप करते समय होने वाली समस्याओं को हल करने का तरीका बताया गया है.

अगले चरण

आगे बढ़ने से पहले, आपको अपने गेम में टेस्ट खाते जोड़ने चाहिए, जैसा कि जांच के लिए खाते चालू करना वाले लेख में बताया गया है. जिन उपयोगकर्ताओं के पास अनुमति वाले टेस्ट खाते हैं उनके पास Play की गेम सेवाओं के ऐसे गेम प्रोजेक्ट का ऐक्सेस होगा जिसे अभी पब्लिश नहीं किया गया है. साथ ही, वे यह जांच कर सकते हैं कि कॉन्फ़िगर की गई आपकी Google Play गेम सेवाएं ठीक से काम कर रही हैं या नहीं.

ऊपर बताए गए शुरुआती सेटअप टास्क पूरे करने के बाद, अपने गेम के लिए सुविधाएं कॉन्फ़िगर करें. जैसे, लीडरबोर्ड और उपलब्धियां. ज़्यादा जानकारी के लिए, सुविधाएं चालू करें से जुड़ा लेख देखें.