Google Play की गेम सेवाएं सेट अप करना

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

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

• अपने गेम के लिए एक गेम प्रोजेक्ट बनाएं और उसकी जानकारी दें. जैसे, गेम का नाम और ब्यौरा.

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

शुरू करने से पहले

Google Play की गेम सेवाएं कॉन्फ़िगर करने से पहले, यह तरीका अपनाएं.

Google Play डेवलपर खाता बनाना

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

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

Google Cloud प्रोजेक्ट बनाना

आपके पास Google Cloud प्रोजेक्ट सेट अप होना चाहिए. ज़्यादा जानकारी के लिए, ये लेख पढ़ें:

• Google Cloud का इस्तेमाल शुरू करना
• प्रोजेक्ट बनाना

Play Console का इस्तेमाल करने के लिए, आपको उन एपीआई को चालू करना होगा जिनका इस्तेमाल आपको अपने प्रोजेक्ट के साथ करना है.

gcloud services enable \
   --project "PROJECT" \
   "games.googleapis.com"

Play Console में साइन इन करना

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

अपने गेम को Play Console में जोड़ना

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

1. Play Console में, एक ऐप्लिकेशन बनाएं और बताएं कि यह एक गेम है. ज़्यादा जानकारी के लिए, अपना ऐप्लिकेशन बनाना और सेट अप करना लेख पढ़ें.

2. उपयोगकर्ता बढ़ाएं > Play की गेम सेवाएं > सेटअप और मैनेजमेंट > कॉन्फ़िगरेशन पर जाएं.

3. बताएं कि आपका गेम पहले से Google API (जैसे, Firebase) का इस्तेमाल करता है या नहीं. यह ज़रूरी है कि आप सही विकल्प चुनें. ऐसा न करने पर, Google API का इस्तेमाल करते समय आपके गेम में समस्याएं आ सकती हैं. यहां विकल्प दिए गए हैं:

   • नहीं, मेरे गेम में Google API का इस्तेमाल नहीं किया जाता: अगर नया गेम बनाया जा रहा है, या आपने इसके लिए कभी Google API सेट अप नहीं किया है, तो यह विकल्प चुनें. अपने गेम का नाम डालें. इसके बाद, बनाएं पर क्लिक करें.

   • हां, मेरे गेम में पहले से Google API का इस्तेमाल किया जाता है: अगर आपने पहले से ही गेम के लिए Google API सेट अप किया है, तो यह विकल्प चुनें. ऐसा करने पर, आपको Google Cloud Console से अपने प्रोजेक्ट की सूची दिखेगी. सूची में से अपना प्रोजेक्ट चुनें. इसके बाद, इस्तेमाल करें पर क्लिक करें.

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

   Play की गेम सेवाओं का एक गेम प्रोजेक्ट बनाया जाता है. साथ ही, Google Cloud Console में आपके लिए एक एंट्री बनाई जाती है.

4. प्रॉपर्टी सेक्शन में, प्रॉपर्टी में बदलाव करें पर क्लिक करके, अपने गेम के लिए जानकारी जोड़ें. जैसे, ब्यौरा, कैटगरी, और ग्राफ़िक ऐसेट. प्रॉपर्टी कॉन्फ़िगर करने के लिए यहां कुछ दिशा-निर्देश दिए गए हैं:

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

   • आपके गेम का डिसप्ले नाम और ब्यौरा, Play Store पर आपके गेम के स्टोर पेज में सेट अप किए गए नाम और ब्यौरे से मेल खाना चाहिए.

   • ग्राफ़िक ऐसेट बनाने के बारे में दिशा-निर्देश पाने के लिए, अपने ऐप्लिकेशन को दिखाने के लिए प्रीव्यू ऐसेट जोड़ना और Google Play पर चुनी गई इमेज के लिए दिशा-निर्देश लेख पढ़ें.

OAuth 2.0 क्लाइंट आईडी जनरेट करना

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

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

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

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

कॉन्फ़िगर करें पर क्लिक करें. इससे एक डायलॉग बॉक्स खुलेगा, जिसमें ज़्यादा निर्देश और Google Cloud का डीप लिंक होगा.

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

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

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

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

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

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

टेस्टिंग चालू करना

यह पक्का करने के लिए कि आपके गेम में Google Play की गेम सेवाएं सही तरीके से काम कर रही हैं, Google Play पर गेम में किए गए बदलावों को पब्लिश करने से पहले, गेम सेवाओं की जांच करें.

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

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

टेस्टर को अपने गेम के लिए, Play Games की सेवाओं के एपीआई इस्तेमाल करने की अनुमति देने के दो तरीके हैं:

• हर व्यक्ति के लिए, अलग-अलग ईमेल पते जोड़कर.

• ग्रुप लेवल पर, Play Console के रिलीज़ ट्रैक के लिए Play की गेम सेवाएं चालू करके.

अपने गेम प्रोजेक्ट में, अलग-अलग टेस्टर को जोड़ने के लिए:

1. Google Play Console में, अपने गेम के लिए टेस्टर टैब खोलें (उपयोगकर्ता बढ़ाएं > Play Games की सेवाएं > सेटअप और मैनेजमेंट > टेस्टर).
2. टेस्टर जोड़ें बटन पर क्लिक करें.
3. डायलॉग बॉक्स में, उन लोगों के Google खातों का ईमेल पते डालें जिन्हें आपको टेस्टर के तौर पर जोड़ना है. इन्हें कॉमा लगाकर अलग करें या हर ईमेल पते को एक लाइन में लिखें.
4. उपयोगकर्ताओं को टेस्टर के तौर पर सेव करने के लिए, जोड़ें पर क्लिक करें. आपने टेस्टर के तौर पर जिन खातों को जोड़ा है उनके मालिकों को, कुछ घंटों में Play की गेम सेवाएं ऐक्सेस करने की अनुमति मिल जाएगी.

किसी ग्रुप को टेस्टिंग का ऐक्सेस देने के लिए, Play की गेम सेवाओं को ऐक्सेस करने के लिए कोई रिलीज़ ट्रैक चालू करें:

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

आपके पास उन सभी उपयोगकर्ताओं को गेम टेस्ट करने का ऐक्सेस देने का विकल्प होता है जिनके पास किसी रिलीज़ ट्रैक पर टेस्ट APK का ऐक्सेस है. यह ठीक उसी तरह काम करता है जैसे आपने उन्हें टेस्टर की सूची में अलग-अलग जोड़ा हो. ऐसा करने के लिए, यह तरीका अपनाएं:

1. PGS टेस्टर सेक्शन (उपयोगकर्ता बढ़ाएं > Play की गेम सेवाएं > सेटअप और मैनेजमेंट > टेस्टर) खोलें और रिलीज़ ट्रैक टैब चुनें. इस पेज पर, उन ट्रैक की सूची भी देखी जा सकती है जिनके लिए Play Games की सेवाओं की टेस्टिंग पहले से चालू है.
2. ट्रैक जोड़ें पर क्लिक करें.
3. Play की गेम सेवाओं की टेस्टिंग के लिए, एक या उससे ज़्यादा ट्रैक चुनें.
4. ट्रैक जोड़ें पर क्लिक करें.

चुने गए रिलीज़ ट्रैक अब, Play की गेम सेवाओं की टेस्टिंग के लिए चालू किए गए ट्रैक की सूची में दिखेंगे.

यह सुविधा सिर्फ़ तब उपलब्ध होती है, जब Google Play Console में आपके गेम से कोई Android ऐप्लिकेशन लिंक किया गया हो.

सामान्य समस्याओं से बचना

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

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

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

2. Android में सही ऐप्लिकेशन आईडी का इस्तेमाल करना

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

3. अपने APK को सही सर्टिफ़िकेट से साइन करना

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

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

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

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

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

6. Google Cloud में, ऐसी स्क्रीन जहां OAuth के लिए सहमति दी जाती है को पब्लिश करना

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

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

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

ज़्यादा सलाह पाने के लिए, Android के लिए समस्या हल करने की गाइड देखें.

अगले चरण

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