بدء استخدام "خدمات ألعاب Play" لأجهزة Android

بعد إيقاف واجهة برمجة التطبيقات تسجيل الدخول باستخدام Google نهائيًا، سنزيل الإصدار v1 من حزمة تطوير البرامج (SDK) للألعاب في عام 2026. بعد فبراير 2025، لن يكون بإمكانك نشر الألعاب التي تم دمجها حديثًا مع الإصدار v1 من حزمة SDK للألعاب على Google Play. ننصحك باستخدام الإصدار v2 من حزمة SDK للألعاب بدلاً من ذلك.
مع أنّ التطبيقات الحالية التي تتضمّن عمليات الدمج السابقة للإصدار 1 من "خدمات ألعاب Google Play" ستستمر في العمل لعدّة سنوات، ننصحك بنقل البيانات إلى الإصدار 2 بدءًا من يونيو 2025.
هذا الدليل مخصّص لاستخدام الإصدار 1 من حزمة تطوير البرامج (SDK) الخاصة بـ "خدمات ألعاب Play". للحصول على معلومات حول أحدث إصدار من حزمة SDK، يُرجى الاطّلاع على مستندات الإصدار 2.

مرحبًا بك في عالم تطوير ألعاب Android باستخدام "خدمات ألعاب Google Play"

توفّر حزمة تطوير البرامج (SDK) الخاصة بـ "ألعاب Play" خدمات "ألعاب Google Play" المتوافقة مع عدّة منصات، ما يتيح لك دمج ميزات الألعاب الرائجة بسهولة، مثل الإنجازات وقوائم الصدارة والألعاب المحفوظة، في ألعابك على الأجهزة اللوحية والأجهزة الجوّالة.

سيرشدك هذا التدريب إلى كيفية تثبيت تطبيق لعبة تجريبي على Android والبدء بسرعة في إنشاء لعبة Android خاصة بك. يوضّح تطبيق Type-a-Number Challenge النموذجي كيفية دمج الإنجازات وقوائم الصدارة في لعبتك.

قبل البدء

لإعداد تطبيقك، أكمِل الخطوات الواردة في الأقسام التالية.

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

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

• ‫minSdkVersion من 19 أو أعلى
• ‫compileSdkVersion من 28 أو أعلى

إعداد لعبتك في 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()
    }
  }

أضِف مصدر الاعتمادية لخدمات Google Play الخاصة بحزمة تطوير البرامج (SDK) لألعاب Play إلى ملف الإصدار Gradle الخاص بالوحدة، والذي يكون عادةً app/build.gradle:

  dependencies {
    implementation 'com.google.android.gms:play-services-games:23.2.0'
  }

دليل نموذج التطبيق

سيرشدك هذا التدريب إلى كيفية تثبيت نموذج لتطبيق لعبة على Android والبدء بسرعة في إنشاء لعبة Android خاصة بك. يوضّح تطبيق Type-a-Number Challenge النموذجي كيفية دمج الإنجازات وقوائم الصدارة في لعبتك.

الخطوة 1: تنزيل تطبيق العيّنة

لاستخدام دليل المطوّر هذا، عليك تنزيل نموذج تطبيق Android الخاص بتحدّي "اكتب رقمًا".

لتنزيل تطبيق العيّنة وإعداده في Android Studio، اتّبِع الخطوات التالية:

1. يمكنك تنزيل نماذج Android من صفحة تنزيل النماذج.
2. استورِد مشروع android-basic-samples. يتضمّن هذا المشروع TypeANumber وعيّنات أخرى من ألعاب Android. لإجراء ذلك في "استوديو Android"، اتّبِع الخطوات التالية:
   1. انقر على ملف (File) > استيراد مشروع (Import Project).
   2. انتقِل إلى الدليل الذي نزّلت فيه android-basic-samples على جهاز التطوير. اختَر الملف android-basic-samples/build.gradle وانقر على حسنًا.
3. في الوحدة TypeANumber، افتح AndroidManifest.xml وغيِّر اسم الحزمة من com.google.example.games.tanc إلى اسم حزمة مختلف من اختيارك. يجب ألا يبدأ اسم الحزمة الجديد بـ com.google أو com.example أو com.android.

الخطوة 2: إعداد اللعبة في Google Play Console

من خلال Google Play Console، يمكنك إدارة "خدمات ألعاب Google Play" للعبتك، وضبط البيانات الوصفية اللازمة لتفويض لعبتك والمصادقة عليها.

لإعداد اللعبة النموذجية في Google Play Console، اتّبِع الخطوات التالية:

1. انتقِل بمتصفّح الويب إلى Google Play Console وسجِّل الدخول. إذا لم يسبق لك التسجيل في Google Play Console، سيُطلب منك إجراء ذلك.
2. اتّبِع التعليمات التالية من أجل إضافة لعبتك إلى Google Play Console.
   1. عند سؤالك عمّا إذا كنت تستخدم Google APIs في تطبيقك، اختَر لا أستخدم أيًا من Google APIs في لعبتي حتى الآن.
   2. لأغراض دليل المطوّرين هذا، يمكنك ملء النموذج بتفاصيل لعبتك. لتسهيل الأمر عليك، يمكنك استخدام رموز العناصر النائبة ولقطات الشاشة المتوفّرة في صفحة عمليات التنزيل.
3. اتّبِع هذه التعليمات من أجل إنشاء معرّف عميل OAuth 2.0 لتطبيق Android.
   1. عند ربط تطبيق Android، احرص على تحديد اسم الحزمة الذي استخدمته سابقًا عند إعادة تسمية حزمة العيّنة.
   2. يمكنك استخدام "معالج إنشاء حِزمة APK الموقَّعة" في "استوديو Android" لإنشاء ملف تخزين مفاتيح وشهادة موقَّعة جديدَين إذا لم يكن لديك أي منهما. للتعرّف على كيفية تشغيل "معالج إنشاء حِزم APK الموقَّعة"، راجِع مقالة توقيع تطبيقك في "استوديو Android".
4. يُرجى تسجيل المعلومات التالية للرجوع إليها لاحقًا:
   1. معرّف التطبيق: هو سلسلة تتألف من أرقام فقط (عادةً 12 رقمًا أو أكثر)، في بداية معرّف العميل.
   2. شهادة التوقيع: سجِّل الشهادة التي استخدمتها عند إعداد إذن الوصول إلى واجهة برمجة التطبيقات (الشهادة التي قدّمت ملفها المرجعي SHA1). عليك استخدام الشهادة نفسها لتوقيع تطبيقك عند اختباره أو إصداره.
5. ضبط الإنجازات في لعبة "كتابة الأرقام":
   1. انقر على علامة التبويب الإنجازات في Google Play Console.
   2. أضِف الإنجازات النموذجية التالية:

      الاسم	الوصف	تعليمات خاصة
      رئيسي	الحصول على نتيجة تمثّل عددًا أوليًا	ما من شبكة
      متواضع	طلب الحصول على النتيجة 0	ما من شبكة
      لا تتفاخر يا فتى	طلب الحصول على نتيجة 9999 في أي من الوضعَين	ما من شبكة
      OMG U R TEH UBER LEET!	الحصول على النتيجة 1337	اجعل هذا الإنجاز مخفيًا.
      ملل	العب اللعبة 10 مرات.	اجعل هذا الإنجاز تدريجيًا مع 10 خطوات لإكماله.
      ملل شديد	العب اللعبة 100 مرة.	اجعل هذا الإنجاز تدريجيًا مع 100 خطوة لفتحه.

   3. سجِّل المعرّفات (سلاسل أبجدية رقمية طويلة) لكل إنجاز أنشأته.
   4. إعداد الإنجازات المناسبة للعبتك لمزيد من المعلومات، اطّلِع على المفاهيم الأساسية للإنجازات وكيفية تنفيذ الإنجازات في Android.
6. اضبط لوحات الصدارة في لعبة "كتابة الأرقام":
   1. اختَر علامة التبويب قوائم الصدارة في Google Play Console.
   2. أضِف لوحتَي صدارة نموذجيتَين: إحداهما باسم "أعلى النتائج السهلة" والأخرى باسم "أعلى النتائج الصعبة". يجب أن تستخدم كلتا لوحتَي الصدارة تنسيق نتائج عدد صحيح مع عدم استخدام أي منازل عشرية، وأن يكون نوع الترتيب الأكبر هو الأفضل.
   3. سجِّل المعرّفات (سلاسل أبجدية رقمية طويلة) لكلّ قائمة صدارة أنشأتها.
   4. إعداد لوحات صدارة مناسبة للعبتك لمزيد من المعلومات، اطّلِع على المفاهيم الأساسية لقوائم الصدارة وكيفية تنفيذ قوائم الصدارة في Android.
7. إضافة حسابات اختبار للعبتك هذه الخطوة مطلوبة فقط للتطبيقات التي لم يتم نشرها بعد في Google Play Console. قبل نشر التطبيق، لا يمكن تسجيل الدخول إلا باستخدام حسابات الاختبار المُدرَجة في Google Play Console. ومع ذلك، بعد نشر التطبيق، يمكن للجميع تسجيل الدخول.

الخطوة 3: تعديل الرمز

لتشغيل اللعبة، عليك إعداد معرّف التطبيق كمصدر في مشروع Android. عليك أيضًا إضافة البيانات الوصفية للألعاب في AndroidManifest.xml.

1. افتح res/values/ids.xml واستبدِل أرقام التعريف الخاصة بالعناصر النائبة. إذا كنت بصدد إنشاء لعبة Android من البداية، عليك إنشاء هذا الملف أولاً.
   1. حدِّد رقم تعريف تطبيقك في المورد app_id.
   2. حدِّد كل معرّف إنجاز أنشأته سابقًا في المورد achievement_* ذي الصلة.
   3. حدِّد رقم تعريف كل قائمة صدارة أنشأتها سابقًا في العنصر leaderboard_* المناسب.
2. افتح AndroidManifest.xml وأدخِل اسم الحزمة في السمة package للعنصر <manifest>. إذا كنت بصدد إنشاء لعبة 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"/>
   

الخطوة 4: اختبار لعبتك

لضمان عمل "خدمات ألعاب Google Play" بشكل صحيح في لعبتك، اختبِر التطبيق قبل نشره على Google Play.

لتشغيل لعبتك على جهاز الاختبار الفعلي، اتّبِع الخطوات التالية:

1. تأكَّد من إعداد الحساب التجريبي الذي تستخدمه لتسجيل الدخول إلى التطبيق (كما هو موضّح في الخطوة 2).
2. صدِّر ملف APK ووقِّعه باستخدام الشهادة نفسها التي استخدمتها لإعداد المشروع في Google Play Console. لتصدير حزمة APK موقَّعة في &quot;استوديو Android&quot;، انقر على إنشاء (Build) > إنشاء حزمة APK موقَّعة (Generate Signed APK).
3. ثبِّت حِزمة APK الموقَّعة على جهاز الاختبار الفعلي باستخدام أداة adb. لمعرفة كيفية تثبيت تطبيق، يُرجى الاطّلاع على التشغيل على جهاز.