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

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

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

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

قبل البدء

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

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

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

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

إعداد لعبتك في Google Play Console

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

ضبط إعدادات تطبيقك

في ملف build.gradle على مستوى المشروع، أدرِج مستودع Maven من Google ومستودع 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 خاصة بك. يوضّح نموذج تطبيق "تحدّي كتابة رقم" كيفية دمج الإنجازات وقوائم الصدارة في لعبتك.

الخطوة 1: تنزيل نموذج التطبيق

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

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

1. نزِّل نماذج Android من صفحة تنزيل النماذج.
2. استورِد مشروع android-basic-samples. يتضمّن هذا المشروع TypeANumber ومواد عرض أخرى لألعاب Android. اتّبِع الخطوات التالية في "استوديو Android":
   1. انقر على ملف > استيراد مشروع.
   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

يمكنك من خلال 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 Studio.
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. أضِف نموذجَين من قوائم الصدارة: أحدهما بعنوان "أعلى النتائج السهلة" والآخر بعنوان "أعلى النتائج الصعبة". يجب أن تستخدم كلتا قائمتَي الصدارة تنسيق النتيجة الصحيحة باستخدام 0 أماكن عشرية، ونوع ترتيب كلما كان أكبر كان أفضل.
   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 موقَّعة في "استوديو Android"، انقر على إنشاء > إنشاء حزمة APK موقَّعة.
3. ثبِّت حزمة APK الموقَّعة على جهاز الاختبار باستخدام أداة adb. لمعرفة كيفية تثبيت تطبيق، يُرجى الاطّلاع على مقالة التشغيل على جهاز.