إعداد الإصدار 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

لتحديد رقم تعريف مشروع "خدمات ألعاب 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>

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

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

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

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

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

إعداد الإصدار 2 من Native C أو C++ تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.