بدء استخدام "خدمات ألعاب 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":

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