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

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

इस डेवलपर गाइड में, Android पर Google Play की गेम सेवाओं के एपीआई का इस्तेमाल करने वाले C++ गेम को कंपाइल और चलाने का तरीका बताया गया है. शुरू करने से पहले, यहां दी गई ज़रूरी शर्तों को डाउनलोड और कॉन्फ़िगर करें:

इस डेवलपर गाइड में, Android नेटिव डेवलपमेंट किट (एनडीके) का इस्तेमाल किया गया है. अगर आपको NDK के बारे में जानकारी नहीं है, तो आगे बढ़ने से पहले NDK के दस्तावेज़ और सैंपल देखें.

पहला चरण: अपना एनवायरमेंट सेट अप करना

  1. Android SDK और Android NDK डाउनलोड करें. इसके बाद, उन्हें अपने कंप्यूटर पर एक्सट्रैक्ट करें. अपने एनवायरमेंट में, SDK_ROOT को Android SDK फ़ोल्डर की जगह पर और NDK_ROOT को Android NDK फ़ोल्डर की जगह पर सेट करें.
  2. C++ के सैंपल गेम डाउनलोड करें. इस डेवलपर गाइड में, आपके कंप्यूटर पर मौजूद सैंपल की जगह को SAMPLES_DIR के तौर पर दिखाया गया है.
  3. Google Play की गेम सेवाओं के C++ SDK टूल को डाउनलोड करें. एसडीके को अपने डेवलपमेंट मशीन पर एक्सट्रैक्ट करें. अपने एनवायरमेंट में, NDK_MODULE_PATH वैरिएबल को gpg-cpp-sdk डायरेक्ट्री के ऊपर मौजूद डायरेक्ट्री पर सेट करें. आपके पास यह डायरेक्ट्री स्ट्रक्चर होना चाहिए: 
    NDK_MODULE_PATH/
gpg-cpp-sdk/
  4. Eclipse खोलें. अगर आपने पहले से ऐसा नहीं किया है, तो Eclipse को बताएं कि आपने NDK कहां इंस्टॉल किया है. इसके लिए, Preferences > Android > NDK पर क्लिक करें.

  5. Google Play services लाइब्रेरी प्रोजेक्ट को अपने Eclipse वर्कस्पेस में इंपोर्ट करें.

    1. Eclipse में, File > Import > Android > Existing Android Code into Workspace पर क्लिक करें.
    2. SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib चुनें. यहां SDK_ROOT आपके Android SDK की जगह है.
    3. पूरा करें पर क्लिक करें.

  6. कम से कम सुविधाओं वाले सैंपल प्रोजेक्ट को अपने Eclipse वर्कस्पेस में इंपोर्ट करें.

    1. Eclipse में, File > Import > Android > Existing Android Code into Workspace पर क्लिक करें.
    2. SAMPLES_DIR/samples-android/minimalist को चुनें.
    3. पूरा करें पर क्लिक करें.

  7. MinimalistActivity प्रोजेक्ट पर राइट क्लिक करें और Properties पर क्लिक करें. Android में, नीचे की ओर स्क्रोल करके लाइब्रेरी सेक्शन पर जाएं. इसके बाद, पक्का करें कि google-play-services_lib प्रोजेक्ट को सही तरीके से रेफ़रंस किया गया हो. अगर ऐसा नहीं होता है, तो रेफ़रंस हटाएं और उसे अपने वर्कस्पेस से फिर से जोड़ें.

Eclipse, आपके प्रोजेक्ट के Java और Android सोर्स को अपने-आप कंपाइल कर देगा. हालांकि, jni फ़ोल्डर में मौजूद नेटिव कोड को अलग से कंपाइल करना होगा. इसे मैन्युअल तरीके से करने के लिए, jni फ़ोल्डर पर जाएं और ndk-build चलाएं. jni फ़ोल्डर में कोई भी बदलाव करने के बाद, ऐसा करना न भूलें.

अब आपका प्रोजेक्ट कंपाइल हो जाना चाहिए. हालांकि, यह अभी काम नहीं करेगा. आपको सबसे पहले Google Play Console में जाकर, अपने गेम को कॉन्फ़िगर करना होगा.

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

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

  1. Google Play की गेम सेवाओं को सेट अप करना में बताए गए तरीके का इस्तेमाल करके, अपने गेम के लिए एंट्री बनाएं.
  2. AndroidManifest.xml में, <manifest> टैग के package एट्रिब्यूट की वैल्यू को उस पैकेज के नाम पर सेट करें जिसे आपने Google Play Console सेट अप करते समय चुना था. इस बदलाव के बाद, आपको पूरे प्रोजेक्ट में कुछ रेफ़रंस ठीक करने पड़ सकते हैं. खास तौर पर, जनरेट की गई R क्लास के रेफ़रंस.
  3. res/values/ids.xml खोलें और वहां अपना ऐप्लिकेशन आईडी डालें. ध्यान दें कि ऐप्लिकेशन आईडी और क्लाइंट आईडी एक जैसा नहीं होता. यह Google Play Console के गेम की जानकारी पेज पर, आपके गेम के नाम के बगल में मौजूद नंबर होता है.

तीसरा चरण: सैंपल चलाना

सेंपल चलाने के लिए, आपको Google Play services इंस्टॉल किया हुआ कोई Android डिवाइस या Emulator चाहिए:

  1. नेटिव कोड को कंपाइल करने के लिए, ndk-build चलाएं.
  2. Eclipse में, Run > Run As > Android Application पर क्लिक करें और अपने डिवाइस पर सैंपल चलाएं.
  3. सेंपल खुलने पर, स्क्रीन पर कहीं भी टैप करें. आपको Google Play Games का लोगो दिखेगा. अगर आपने ऐप्लिकेशन को सही तरीके से कॉन्फ़िगर किया है, तो आपको साइन इन करने के लिए कहा जाएगा.

ज़रूरी नहीं: Eclipse की मदद से अपने-आप बनाना

यहां बताया गया है कि ndk-build फ़ोल्डर में मौजूद फ़ाइलों में बदलाव करने पर, ndk-build को अपने-आप चलाने के लिए Eclipse को कैसे कॉन्फ़िगर करें.jni

  1. MinimalistActivity प्रोजेक्ट पर राइट क्लिक करें और Properties पर क्लिक करें. प्रॉपर्टी विंडो में जाकर, बिल्डर पैनल चुनें.
  2. नया बिल्डर जोड़ने के लिए, नया पर क्लिक करें. इसके बाद, प्रोग्राम चुनें और ठीक है पर क्लिक करें.
  3. नाम फ़ील्ड में, 'NDK Builder' डालें.
  4. जगह की जानकारी में जाकर, फ़ाइल सिस्टम ब्राउज़ करें पर क्लिक करें. इसके बाद, NDK_ROOT डायरेक्ट्री पर जाएं और ndk-build कमांड चुनें.
  5. वर्किंग डायरेक्ट्री में जाकर, वर्कस्पेस ब्राउज़ करें पर क्लिक करें. इसके बाद, MinimalistActivity प्रोजेक्ट फ़ोल्डर चुनें.
  6. रीफ़्रेश करें टैब पर क्लिक करें. पक्का करें कि प्रोसेस पूरी होने पर संसाधनों को रीफ़्रेश करें बॉक्स पर सही का निशान लगा हो.
  7. चुनिंदा संसाधन रेडियो बटन को चुनें. इसके बाद, संसाधन तय करें पर क्लिक करें. इसके बाद दिखने वाले डायलॉग बॉक्स में, MinimalActivity में जाकर jni फ़ोल्डर चुनें.
  8. बिल्डर बनाने की प्रोसेस पूरी करने के लिए, लागू करें और फिर ठीक है पर क्लिक करें.

अब जब भी jni फ़ोल्डर में मौजूद किसी फ़ाइल में बदलाव किया जाएगा, तब Eclipse ndk-build को चलाएगा और Eclipse Console पर आउटपुट प्रिंट करेगा.