إعداد الإصدار 2 من Native C أو C++

يساعدك هذا المستند في إعداد مشروع C++ لاستخدام الإصدار 2 من Native C أو C++ والتحقّق من خدمة المصادقة.

قبل البدء

يجب إعداد "خدمات ألعاب Play" في Google Play Console.

المتطلبات الأساسية للتطبيق

تأكَّد من أنّ ملف إنشاء تطبيقك يستخدم القيم التالية:

  • ‫minSdkVersion من 19 أو أكثر
  • ‫compileSdkVersion من 28 أو أكثر

إعداد مشروع لعبتك

أكمِل الخطوات التالية لإعداد مشروع لعبتك.

تعديل ملف build.gradle

في ملف build.gradle على مستوى التطبيق، اتّبِع الخطوات التالية:

  • تأكَّد من تفعيل ميزة إنشاء عناصر جاهزة.

  • أضِف التبعية لحزمة الإصدار 2 من حزمة تطوير البرامج (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. لتحديد رقم تعريف مشروع "خدمات ألعاب Play" في ملف AndroidManifest.xml، أضِف الأسطر التالية:

    <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. إنشاء لعبتك واختبارها في حال نجاح عملية الربط، سيظهر لك عند تشغيل اللعبة إما طلب تسجيل دخول أو بانر يشير إلى إتمام عملية تسجيل الدخول بنجاح.

إعادة تشغيل طلب تسجيل الدخول

إذا رفض أحد اللاعبين طلب تسجيل الدخول الأوّلي إلى &quot;خدمات ألعاب Play&quot; الذي يظهر تلقائيًا عند تشغيل لعبتك، يمكنه تغيير رأيه أثناء جلسة اللعب. ويمكنك إعادة عرض طلب تسجيل الدخول من خلال استدعاء PgsGamesSignInClient_signIn طالما لم تتم مصادقة هوية أي لاعب.

تفويض خادم اللعبة

بعد أن ينجح اللاعب في إثبات ملكية حسابه على &quotخدمات ألعاب Play&quot، يمكن لبرنامج تشغيل اللعبة إرسال طلب للحصول على رمز تفويض الخادم الذي يمكن لخادم الخلفية للعبة استخدامه للتواصل بشكل آمن مع &quotخدمات ألعاب Play&quot. يتيح ذلك لخادم اللعبة استرداد بيانات اللاعب الذي أثبت ملكية حسابه وتعديلها وتخزينها. ويمكنك استرداد رمز تفويض الخادم من خلال استدعاء الدالة PgsGamesSignInClient_requestServerSideAccess.

لمزيد من المعلومات، يمكنك الاطّلاع على دليل الوصول إلى الخادم.