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

Google Play Games Services की मदद से Android गेम डेवलप करने के लिए आपका स्वागत है!

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

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

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

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

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

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

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

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

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

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

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

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

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

Play Games SDK के लिए, Google Play services की डिपेंडेंसी को अपने मॉड्यूल की Gradle बिल्ड फ़ाइल में जोड़ें. आम तौर पर, यह 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 चुनें और ठीक है पर क्लिक करें.
3. TypeANumber मॉड्यूल में, AndroidManifest.xml खोलें और पैकेज के नाम को com.google.example.games.tanc से बदलकर, अपने पैकेज का कोई दूसरा नाम डालें. पैकेज का नया नाम, com.google, com.example या com.android से शुरू नहीं होना चाहिए.

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

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

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. आपका ऐप्लिकेशन आईडी: यह एक स्ट्रिंग होती है, जिसमें सिर्फ़ अंक होते हैं. आम तौर पर, यह 12 या उससे ज़्यादा अंकों की होती है. यह आपके क्लाइंट आईडी की शुरुआत में होती है.
   2. आपका साइनिंग सर्टिफ़िकेट: ध्यान दें कि आपने एपीआई का ऐक्सेस सेट अप करते समय किस सर्टिफ़िकेट का इस्तेमाल किया था. यह वह सर्टिफ़िकेट होता है जिसका SHA1 फ़िंगरप्रिंट आपने दिया था. ऐप्लिकेशन को टेस्ट करते समय या उसे रिलीज़ करते समय, आपको उसी सर्टिफ़िकेट का इस्तेमाल करके ऐप्लिकेशन पर हस्ताक्षर करना चाहिए.
5. टाइप-ए-नंबर चैलेंज के लिए उपलब्धियां कॉन्फ़िगर करना:
   1. Google Play Console में, उपलब्धियां टैब चुनें.
   2. उपलब्धियों के ये सैंपल जोड़ें:

      नाम	ब्यौरा	विशेष निर्देश
      प्राइम	अभाज्य संख्या वाला स्कोर पाएं.	कोई नहीं
      Humble	0 का स्कोर पाने का अनुरोध करें.	कोई नहीं
      घमंड न करें, बच्चे	दोनों मोड में 9999 का स्कोर पाने का अनुरोध करें.	कोई नहीं
      वाह! तुम तो बहुत शानदार हो!	आपको 1337 का स्कोर मिलता है.	इसे छिपी हुई उपलब्धि बनाएं.
      बोरियत	गेम को 10 बार खेलें.	इसे इंक्रीमेंटल उपलब्धि बनाएं, जिसे अनलॉक करने के लिए 10 चरण पूरे करने होंगे.
      बहुत ही बोर हो रहा है	गेम को 100 बार खेलें.	इसे इंक्रीमेंटल उपलब्धि बनाएं, जिसे अनलॉक करने के लिए 100 चरण पूरे करने होंगे.

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

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

गेम चलाने के लिए, आपको अपने 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 Games Services ठीक से काम कर रही हैं, उसे Google Play पर पब्लिश करने से पहले ऐप्लिकेशन की जांच करें.

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

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