v2 Native C या C++ को सेट अप करना

इस दस्तावेज़ की मदद से, v2 Native C या C++ के लिए अपना C++ प्रोजेक्ट सेट अप किया जा सकता है. साथ ही, पुष्टि करने की सेवा की पुष्टि की जा सकती है.

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

आपको Google Play Console में Play की गेम सेवाएं सेट अप करनी होंगी.

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

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

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

अपना गेम प्रोजेक्ट सेट अप करना

अपने गेम प्रोजेक्ट को सेट अप करने के लिए, यह तरीका अपनाएं.

build.gradle फ़ाइल अपडेट करना

ऐप्लिकेशन-लेवल की build.gradle फ़ाइल में, यह तरीका अपनाएं:

  • पक्का करें कि प्रीफ़ैब बनाने की सुविधा चालू हो.

  • v2 Native SDK (बीटा) के लिए डिपेंडेंसी जोड़ें:

    • com.google.android.gms:play-services-games-v2-native-c:21.0.0-beta1

यहां एक उदाहरण दिया गया है:

  android {
    ...
    buildFeatures {
      prefab true
    }
    ...
  }
  dependencies {
    ...
    implementation "com.google.android.gms:play-services-games-v2-native-c:21.0.0-beta1"
  }

CMakeLists.txt फ़ाइल अपडेट करना

अपनी CMakeLists.txt फ़ाइल में, यह कोड जोड़ें:

  find_package(com.google.android.gms.games.v2.c REQUIRED CONFIG)

  // link games_static for -DANDROID_STL=c++_static or default
  // link games_shared for -DANDROID_STL=c++_shared
  target_link_libraries(
    app PUBLIC com.google.android.gms.games.v2.c::games_static)

AndroidManifest.xml को अपडेट करना

  1. अपनी AndroidManifest.xml फ़ाइल में Play Games Services प्रोजेक्ट आईडी तय करने के लिए, यह लाइनें जोड़ें:

    <manifest>
      <application>
        <meta-data android:name="com.google.android.gms.games.APP_ID"
                   android:value="@string/game_services_project_id"/>
      </application>
    </manifest>
    
  2. अपने प्रोजेक्ट आईडी के लिए, स्ट्रिंग रिसॉर्स बनाएं. इससे आपके गेम को बिल्ड टाइम में आईडी ऐक्सेस करने की अनुमति मिलती है. संसाधन बनाने के लिए, project_root/app/src/main/res/values/games-ids.xml फ़ाइल बनाएं और इसमें यह जानकारी जोड़ें:

    <?xml version="1.0" encoding="utf-8"?>
    <resources>
        <string name="game_services_project_id"
                translatable="false">add your Project ID here</string>
    </resources>
    
  3. अपना गेम बनाएं और उसे टेस्ट करें. अगर साइन इन हो जाता है, तो गेम लॉन्च करने पर, आपको साइन इन करने का प्रॉम्प्ट दिखेगा या साइन इन हो जाने का बैनर दिखेगा.

साइन-इन करने का प्रॉम्प्ट फिर से लॉन्च करना

अगर कोई खिलाड़ी, गेम लॉन्च होने पर अपने-आप दिखने वाले Play Games Services के साइन-इन प्रॉम्प्ट को अस्वीकार करता है, तो हो सकता है कि वह गेम सेशन के दौरान अपना फ़ैसला बदल ले. जब तक किसी भी खिलाड़ी की पुष्टि नहीं हो जाती, तब तक PgsGamesSignInClient_signIn को कॉल करके, साइन-इन करने का अनुरोध फिर से लॉन्च किया जा सकता है.

गेम सर्वर को अनुमति देना

जब कोई खिलाड़ी Play की गेम सेवाओं के लिए पुष्टि कर लेता है, तो आपका गेम क्लाइंट, सर्वर ऑथराइज़ेशन कोड का अनुरोध कर सकता है. आपका बैकएंड गेम सर्वर, इस कोड का इस्तेमाल करके Play की गेम सेवाओं के साथ सुरक्षित तरीके से कम्यूनिकेट कर सकता है. इससे आपका गेम सर्वर, पुष्टि किए गए खिलाड़ी के लिए डेटा को वापस पा सकता है, उसे अपडेट कर सकता है, और सेव कर सकता है. PgsGamesSignInClient_requestServerSideAccess फ़ंक्शन को कॉल करके, सर्वर ऑथराइज़ेशन कोड को वापस पाया जा सकता है.

ज़्यादा जानकारी के लिए, सर्वर ऐक्सेस करने की गाइड देखें.