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

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.1.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 की गेम सेवाओं को मैनेज किया जाता है. साथ ही, अपने गेम की अनुमति देने और उसकी पुष्टि करने के लिए, मेटाडेटा को कॉन्फ़िगर किया जाता है.

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 स्कोर के लिए 0 का अनुरोध करें. कोई नहीं
      अब शर्मिंदा न करें, बच्चे किसी भी मोड में 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 में सूची में शामिल, जांच वाले खातों से लॉग इन किया जा सकता है. हालांकि, ऐप्लिकेशन के पब्लिश होने के बाद, सभी को लॉग इन करने की अनुमति होती है.
वापस मिल जाएगा.

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

गेम चलाने के लिए, आपको अपने 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 4.2.2 में Google Play services की मदद से बनी एम्युलेटर सिस्टम इमेज को डाउनलोड करें

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

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