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

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

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

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

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

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

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

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 Games Services > सेटअप और मैनेजमेंट > कॉन्फ़िगरेशन पर जाएं.

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

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

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

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

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

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

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

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

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

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

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

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

OAuth की सहमति वाली स्क्रीन को कॉन्फ़िगर करना

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

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

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

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

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

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

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

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

जांच करने की सुविधा चालू करना

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

अगले चरण

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