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

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

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

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

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

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

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

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

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

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

ऐसी स्क्रीन कॉन्फ़िगर करें जहां OAuth के लिए सहमति दी जाती है. Google Cloud Platform में, उस स्क्रीन के सेटअप पेज को कॉन्फ़िगर और पब्लिश करें जहां OAuth के लिए सहमति दी जाती है. 1. Google Cloud Platform में, उस स्क्रीन के सेटअप पेज पर जाएं जहां OAuth के लिए सहमति दी जाती है. 2. सहमति वाली स्क्रीन, Google Play पर सभी लोगों के लिए (संगठन के बाहर) या सिर्फ़ अपने संगठन के लोगों को (इंटरनल तौर पर) उपलब्ध कराएं. 3. ऐप्लिकेशन का कोई नाम दें - यह नाम Play Console में आपके गेम के नाम से मेल खाना चाहिए. 4. स्कोप जोड़ें: game, game_lite, और drive.appdata. 5. जिस स्क्रीन के लिए सहमति दी जाती है उसे पब्लिश करें. 6. कॉन्फ़िगरेशन की पुष्टि करने के लिए, Play Console पर वापस जाएं.

अगर आपने 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 फ़िंगरप्रिंट पाने और डीबग सर्टिफ़िकेट पाने के लिए, Keytool सुविधा को चलाएं.

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

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

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

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

  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 Services के लिए सर्वर-साइड ऐक्सेस चालू करना लेख पढ़ें.

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

सेटअप से जुड़ी आम गलतियों से बचने के लिए, 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 पर सही प्रमाणपत्र से हस्ताक्षर करें
Google Play Console में, अपने Android ऐप्लिकेशन को गेम से जोड़ते समय, आपको पैकेज का वही नाम और सर्टिफ़िकेट फ़िंगरप्रिंट इस्तेमाल करना होगा जिसका इस्तेमाल आपने ऐप्लिकेशन को पब्लिश करते समय किया था. अगर यह जानकारी मेल नहीं खाती, तो 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 में गेम पब्लिश करें विकल्प का इस्तेमाल करें. बदलावों को पब्लिश करने का तरीका जानने के लिए, गेम में किए गए बदलावों को पब्लिश करने का तरीका देखें.

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

अगले चरण

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

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