Android के लिए Play Games Services का इस्तेमाल शुरू करना

Google Sign-In API के बंद होने के बाद, हम 2026 में Games v1 एसडीके को हटा रहे हैं. फ़रवरी 2025 के बाद, Google Play पर ऐसे गेम पब्लिश नहीं किए जा सकेंगे जो Games v1 एसडीके के साथ अभी-अभी इंटिग्रेट किए गए हैं. हमारा सुझाव है कि आप इसके बजाय, Games v2 SDK का इस्तेमाल करें.
गेम के v1 इंटिग्रेशन वाले मौजूदा टाइटल, कुछ सालों तक काम करते रहेंगे. हालांकि, हमारा सुझाव है कि आप जून 2025 से v2 पर माइग्रेट करें.
यह गाइड, Play की गेम सेवाओं के v1 एसडीके का इस्तेमाल करने के लिए है. एसडीके के नए वर्शन के बारे में जानकारी पाने के लिए, v2 का दस्तावेज़ देखें.

Google Play की गेम सेवाओं की मदद से, Android गेम बनाने में आपका स्वागत है!

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

इस ट्रेनिंग में, Android के लिए सैंपल गेम ऐप्लिकेशन इंस्टॉल करने का तरीका बताया गया है. साथ ही, इसमें Android गेम बनाने के लिए तुरंत शुरू करने का तरीका भी बताया गया है. Type-a-Number Challenge सैंपल ऐप्लिकेशन से पता चलता है कि उपलब्धियों और लीडरबोर्ड को अपने गेम में कैसे इंटिग्रेट किया जा सकता है.

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

अपने ऐप्लिकेशन को तैयार करने के लिए, यहां दिए गए सेक्शन में बताया गया तरीका अपनाएं.

ऐप्लिकेशन से जुड़ी ज़रूरी शर्तें

पक्का करें कि आपके ऐप्लिकेशन की बिल्ड फ़ाइल में इन वैल्यू का इस्तेमाल किया गया हो:

• minSdkVersion या उससे ज़्यादा19
• 28 या इससे ज़्यादा का compileSdkVersion

Google Play Console में गेम सेट अप करना

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

अपने ऐप्लिकेशन को कॉन्फ़िगर करना

अपने प्रोजेक्ट-लेवल की build.gradle फ़ाइल में, Google की Maven रिपॉज़िटरी और Maven Central रिपॉज़िटरी को अपने buildscript और allprojects, दोनों सेक्शन में शामिल करें:

  buildscript {
    repositories {
      google()
      mavenCentral()
    }
  }

  allprojects {
    repositories {
      google()
      mavenCentral()
    }
  }

Play की गेम सेवाओं के एसडीके के लिए, Google Play services की डिपेंडेंसी को अपने मॉड्यूल की Gradle बिल्ड फ़ाइल में जोड़ें. यह फ़ाइल आम तौर पर app/build.gradle होती है:

  dependencies {
    implementation 'com.google.android.gms:play-services-games:23.2.0'
  }

सैंपल ऐप्लिकेशन से जुड़ी गाइड

इस ट्रेनिंग में, Android के लिए सैंपल गेम ऐप्लिकेशन इंस्टॉल करने का तरीका बताया गया है. साथ ही, इसमें Android गेम बनाने के लिए तुरंत शुरू करने का तरीका भी बताया गया है. Type-a-Number Challenge सैंपल ऐप्लिकेशन से पता चलता है कि उपलब्धियों और लीडरबोर्ड को अपने गेम में कैसे इंटिग्रेट किया जा सकता है.

पहला चरण: सैंपल ऐप्लिकेशन डाउनलोड करना

इस डेवलपर गाइड के लिए, आपको टाइप-ए-नंबर चैलेंज का सैंपल Android ऐप्लिकेशन डाउनलोड करना होगा.

Android Studio में सैंपल ऐप्लिकेशन डाउनलोड और सेट अप करने के लिए:

1. सैंपल डाउनलोड करने वाले पेज से, Android के सैंपल डाउनलोड करें.
2. android-basic-samples प्रोजेक्ट इंपोर्ट करें. इस प्रोजेक्ट में TypeANumber और Android गेम के अन्य सैंपल शामिल हैं. Android Studio में ऐसा करने के लिए:
   1. फ़ाइल > प्रोजेक्ट इंपोर्ट करें पर क्लिक करें.
   2. उस डायरेक्ट्री पर जाएं जहां आपने डेवलपमेंट मशीन पर android-basic-samples डाउनलोड किया था. फ़ाइल android-basic-samples/build.gradle चुनें और ठीक है पर क्लिक करें.
3. TypeANumber मॉड्यूल में, AndroidManifest.xml खोलें और पैकेज का नाम com.google.example.games.tanc से बदलकर, अपना कोई दूसरा पैकेज का नाम डालें. नए पैकेज का नाम com.google, com.example या com.android से शुरू नहीं होना चाहिए.

दूसरा चरण: Google Play Console में गेम सेट अप करना

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

Google Play Console में सैंपल गेम सेट अप करने के लिए:

1. अपने वेब ब्राउज़र में Google Play Console खोलें और साइन इन करें. अगर आपने पहले कभी Google Play Console के लिए रजिस्टर नहीं किया है, तो आपको ऐसा करने के लिए कहा जाएगा.
2. Google Play Console में अपना गेम जोड़ने के लिए, इन निर्देशों का पालन करें.
   1. जब आपसे पूछा जाए कि क्या आपके ऐप्लिकेशन में Google API का इस्तेमाल किया जाता है, तो मैंने अब तक अपने गेम में किसी भी Google API का इस्तेमाल नहीं किया है को चुनें.
   2. डेवलपर गाइड के लिए, फ़ॉर्म में अपने गेम की जानकारी भरी जा सकती है. आसानी के लिए, डाउनलोड पेज पर दिए गए प्लेसहोल्डर आइकॉन और स्क्रीनशॉट का इस्तेमाल किया जा सकता है.
3. अपने Android ऐप्लिकेशन के लिए, OAuth 2.0 क्लाइंट आईडी जनरेट करने के लिए, इन निर्देशों का पालन करें.
   1. अपने Android ऐप्लिकेशन को लिंक करते समय, पक्का करें कि आपने वही पैकेज का नाम डाला हो जिसका इस्तेमाल आपने सैंपल पैकेज का नाम बदलते समय किया था.
   2. अगर आपके पास पहले से कोई कीस्टोर और साइन किया गया सर्टिफ़िकेट नहीं है, तो Android Studio में Generate Signed APK विज़र्ड का इस्तेमाल करके, नया कीस्टोर और साइन किया गया सर्टिफ़िकेट जनरेट किया जा सकता है. साइन किए गए APK को जनरेट करने वाले विज़र्ड को चलाने का तरीका जानने के लिए, Android Studio में अपने ऐप्लिकेशन को साइन करना लेख पढ़ें.
4. यहां दी गई जानकारी को बाद में इस्तेमाल करने के लिए सेव कर लें:
   1. आपका ऐप्लिकेशन आईडी: यह एक स्ट्रिंग है. इसमें सिर्फ़ अंक होते हैं. आम तौर पर, यह 12 या इससे ज़्यादा अंकों का होता है. यह आपके क्लाइंट आईडी की शुरुआत में होता है.
   2. आपका साइनिंग सर्टिफ़िकेट: ध्यान दें कि आपने एपीआई ऐक्सेस सेट अप करते समय किस सर्टिफ़िकेट का इस्तेमाल किया था. यह वही सर्टिफ़िकेट होना चाहिए जिसका SHA1 फ़िंगरप्रिंट आपने दिया था. टेस्टिंग या रिलीज़ करते समय, अपने ऐप्लिकेशन पर हस्ताक्षर करने के लिए आपको इसी सर्टिफ़िकेट का इस्तेमाल करना चाहिए.
5. टाइप-ए-नंबर चैलेंज के लिए उपलब्धियां कॉन्फ़िगर करें:
   1. Google Play Console में, उपलब्धियां टैब चुनें.
   2. उपलब्धियों के ये सैंपल जोड़ें:

      नाम	ब्यौरा	विशेष निर्देश
      प्राइम	ऐसा स्कोर पाएं जो अभाज्य संख्या हो.	कोई नहीं
      विनम्र	स्कोर 0 का अनुरोध करें.	कोई नहीं
      ज़्यादा होशियार मत बनो	किसी भी मोड में 9999 का स्कोर पाने का अनुरोध करें.	कोई नहीं
      OMG U R TEH UBER LEET!	1337 का स्कोर पाएं.	इसे छिपी हुई उपलब्धि के तौर पर सेट करें.
      बोरियत	गेम को 10 बार खेलें.	इसे इंक्रीमेंटल अचीवमेंट (चरणों में मिलने वाली उपलब्धि) बनाएं. इसे अनलॉक करने के लिए 10 चरण होने चाहिए.
      बहुत ज़्यादा बोरियत	गेम को 100 बार खेलें.	इसे इंक्रीमेंटल अचीवमेंट (चरणों में मिलने वाली उपलब्धि) बनाएं. इसे अनलॉक करने के लिए 100 चरण तय करें.

   3. आपने जो उपलब्धियां बनाई हैं उनके आईडी (अक्षरों और अंकों से बनी लंबी स्ट्रिंग) रिकॉर्ड करें.
   4. अपने गेम के हिसाब से उपलब्धियां कॉन्फ़िगर करें. ज़्यादा जानने के लिए, उपलब्धियों से जुड़े कॉन्सेप्ट और Android में उपलब्धियां लागू करने का तरीका लेख पढ़ें.
6. टाइप-ए-नंबर चैलेंज के लिए लीडरबोर्ड कॉन्फ़िगर करें:
   1. Google Play Console में, लीडरबोर्ड टैब को चुनें.
   2. दो सैंपल लीडरबोर्ड जोड़ें: एक का नाम “आसान हाई स्कोर” और दूसरे का नाम “मुश्किल हाई स्कोर” होना चाहिए. दोनों लीडरबोर्ड में, पूर्णांक स्कोर फ़ॉर्मैट का इस्तेमाल किया जाना चाहिए. इसमें दशमलव के बाद कोई अंक नहीं होना चाहिए. साथ ही, स्कोर को ज़्यादा से कम के क्रम में दिखाया जाना चाहिए.
   3. आपने जो भी लीडरबोर्ड बनाए हैं उनके आईडी (अक्षर और अंकों से बनी लंबी स्ट्रिंग) रिकॉर्ड करें.
   4. अपने गेम के लिए सही लीडरबोर्ड कॉन्फ़िगर करें. ज़्यादा जानने के लिए, लीडरबोर्ड के पीछे के सिद्धांत और Android में लीडरबोर्ड लागू करने का तरीका देखें.
7. अपने गेम के लिए टेस्ट खाते जोड़ें. यह चरण सिर्फ़ उन ऐप्लिकेशन के लिए ज़रूरी है जिन्हें अब तक Google Play Console में पब्लिश नहीं किया गया है. ऐप्लिकेशन पब्लिश होने से पहले, सिर्फ़ Google Play Console में लिस्ट किए गए टेस्ट खाते लॉग इन कर सकते हैं. हालांकि, ऐप्लिकेशन पब्लिश होने के बाद, सभी लोग लॉग इन कर सकते हैं.

चेतावनी: अगर आपने पब्लिश नहीं किए गए गेम के लिए, Play Games SDK टूल के कॉल किए और इसके लिए ऐसे खाते का इस्तेमाल किया जो टेस्ट खाते के तौर पर लिस्ट नहीं है, तो Google Play Games Services ऐसे काम करेगी जैसे गेम मौजूद ही नहीं है. साथ ही, आपको ConnectionResult.SIGN_IN_REQUIRED रिटर्न कोड मिलेगा. ConnectionResult.startResolutionForResult() लॉन्च करने की कोशिश करने पर, आपको GamesActivityResultCodes.RESULT_SIGN_IN_FAILED वापस मिल जाएगा.

तीसरा चरण: कोड में बदलाव करना

गेम चलाने के लिए, आपको अपने Android प्रोजेक्ट में ऐप्लिकेशन आईडी को संसाधन के तौर पर कॉन्फ़िगर करना होगा. आपको AndroidManifest.xml में गेम का मेटाडेटा भी जोड़ना होगा.

1. res/values/ids.xml खोलें और प्लेसहोल्डर आईडी बदलें. अगर आपको स्क्रैच से कोई Android गेम बनाना है, तो आपको यह फ़ाइल पहले बनानी होगी.
   1. app_id संसाधन में अपना ऐप्लिकेशन आईडी डालें.
   2. आपने पहले जो भी उपलब्धि आईडी बनाए थे उन्हें achievement_* रिसॉर्स में बताएं.
   3. आपने पहले जो लीडरबोर्ड आईडी बनाए थे उन्हें उनसे जुड़े leaderboard_* रिसोर्स में डालें.
2. AndroidManifest.xml खोलें और <manifest> एलिमेंट के package एट्रिब्यूट में पैकेज का नाम डालें. अगर आपको Android गेम शुरू से बनाना है, तो पक्का करें कि आपने <application> एलिमेंट में यह कोड भी जोड़ा हो:

   <meta-data android:name="com.google.android.gms.games.APP_ID"
       android:value="@string/app_id" />
   <meta-data android:name="com.google.android.gms.version"
      android:value="@integer/google_play_services_version"/>
   

चौथा चरण: अपने गेम को टेस्ट करना

यह पक्का करने के लिए कि Google Play की गेम सेवाएं आपके गेम में सही तरीके से काम कर रही हैं, Google Play पर ऐप्लिकेशन पब्लिश करने से पहले उसे टेस्ट करें.

ध्यान दें: हमारा सुझाव है कि आप किसी Android डिवाइस पर टेस्ट करें. हालांकि, अगर आपके पास कोई डिवाइस नहीं है, तो Android Emulator का इस्तेमाल करके टेस्ट किया जा सकता है. इसके लिए, Android 4.2.2 में जाकर, Google Play services वाली एम्युलेटर सिस्टम इमेज डाउनलोड करें. इसके लिए, SDK Manager पर जाएं.

अपने फ़िज़िकल टेस्ट डिवाइस पर गेम चलाने के लिए:

1. पुष्टि करें कि आपने उस टेस्ट खाते को सेट अप कर लिया है जिसका इस्तेमाल आपको ऐप्लिकेशन में लॉग इन करने के लिए करना है. इसके बारे में दूसरे चरण में बताया गया है.
2. APK एक्सपोर्ट करें और उसे उसी सर्टिफ़िकेट से साइन करें जिसका इस्तेमाल आपने Google Play Console में प्रोजेक्ट सेट अप करने के लिए किया था. Android Studio में हस्ताक्षरित APK एक्सपोर्ट करने के लिए, Build > Generate Signed APK पर क्लिक करें.
3. adb टूल का इस्तेमाल करके, साइन किए गए APK को अपने फ़िज़िकल टेस्ट डिवाइस पर इंस्टॉल करें. किसी ऐप्लिकेशन को इंस्टॉल करने का तरीका जानने के लिए, डिवाइस पर ऐप्लिकेशन चलाना लेख पढ़ें.

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