Android के लिए Play की गेम सेवाओं का इस्तेमाल शुरू करना

चेतावनी: यह गाइड, Play की गेम सेवाओं के वर्शन 1 SDK टूल के इस्तेमाल के लिए है. SDK टूल के नए वर्शन की जानकारी के लिए, Play की गेम सेवा के वर्शन 2 का दस्तावेज़ देखें.

Google Play गेम सेवाओं के साथ Android गेम डेवलपमेंट में आपका स्वागत है!

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

यह प्रशिक्षण आपको Android के लिए एक नमूना गेम ऐप्लिकेशन इंस्टॉल करने और जल्दी से अपना Android गेम बनाना शुरू करने में आपकी सहायता करेगा. टाइप-ए-नंबर चैलेंज ऐप्लिकेशन का इस्तेमाल करके यह दिखाया जाता है कि उपलब्धियों और लीडरबोर्ड को अपने गेम में कैसे जोड़ा जा सकता है.

वेब कंटेनर इंस्टॉल करने से पहले

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. नमूने के डाउनलोड वाले पेज से Android के नमूने डाउनलोड करें.
2. android-basic-samples प्रोजेक्ट इंपोर्ट करें. इस प्रोजेक्ट में TypeANumber और Android गेम के अन्य सैंपल शामिल हैं. Android Studio में ऐसा करने के लिए:
   1. फ़ाइल > प्रोजेक्ट इंपोर्ट करें पर क्लिक करें.
   2. उस डायरेक्ट्री को ब्राउज़ करें जहां से आपने अपनी डेवलपमेंट मशीन पर android-basic-samples डाउनलोड किया था. android-basic-samples/build.gradle फ़ाइल चुनें और OK पर क्लिक करें.
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 में जनरेट किया गया हस्ताक्षर किया गया APK विज़र्ड इस्तेमाल करने के लिए, इसका इस्तेमाल किया जा सकता है. साइन किया हुआ APK विज़र्ड को चलाने का तरीका जानने के लिए, Android Studio में अपने ऐप्लिकेशन को साइन करना लेख पढ़ें.
4. नीचे दी गई जानकारी को बाद के लिए रिकॉर्ड करें:
   1. आपका ऐप्लिकेशन आईडी: इस स्ट्रिंग में आपके Client-ID की शुरुआत में सिर्फ़ अंक (आम तौर पर 12 या उससे ज़्यादा) होते हैं.
   2. आपका साइनिंग सर्टिफ़िकेट: ध्यान दें कि अपना एपीआई ऐक्सेस (वह सर्टिफ़िकेट जिसका SHA1 फ़िंगरप्रिंट आपने दिया है) सेट अप करते समय आपने किस सर्टिफ़िकेट का इस्तेमाल किया था. अपने ऐप्लिकेशन की जांच करते समय या उसे रिलीज़ करते समय, आपको उसी सर्टिफ़िकेट का इस्तेमाल करना चाहिए.
5. टाइप-ए-नंबर चैलेंज के लिए उपलब्धियां कॉन्फ़िगर करें:
   1. Google Play Console में, उपलब्धियां टैब चुनें.
   2. नीचे दी गई उपलब्धियों के नमूने जोड़ें:

      नाम	कंपनी का ब्यौरा	खास निर्देश
      प्राइम	एक ऐसा स्कोर पाएं जो अभाज्य हो.	बिलकुल नहीं
      Humble	शून्य स्कोर का अनुरोध करें.	बिलकुल नहीं
      बच्चे खुद को शर्मिंदा मत करो,	किसी भी मोड में 9999 का स्कोर पाने का अनुरोध करें.	बिलकुल नहीं
      हे भगवान!	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 की गेम सेवाएं इस तरह से काम करेंगी.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 से उसकी जांच की जा सकती है. ऐसा करने के लिए, SDK Manager से Android 4.2.2 में, एम्युलेटर सिस्टम की इमेज डाउनलोड करें. इसमें Google Play services शामिल हैं.

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

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

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