بدء استخدام "خدمات ألعاب Play" لنظام التشغيل Android

تنبيه: هذا الدليل مخصَّص لاستخدام حزمة تطوير البرامج (SDK) للإصدار 1 من "خدمات ألعاب Play". بالنسبة للحصول على معلومات حول أحدث حزمة SDK، يُرجى الاطّلاع على مستندات الإصدار 2 من "خدمة ألعاب Play".

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

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

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

قبل البدء

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

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

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

• درجة minSdkVersion من 19 بمستوى أعلى
• compileSdkVersion بقيمة 28 أو أعلى

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

أداة Google 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

أداة 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" لتنفيذ ما يلي: إنشاء ملف تخزين مفاتيح جديد وشهادة موقعة إذا لم يكن لديك واحدة بالفعل. للتعرّف على كيفية تشغيل معالج إنشاء Signed APK، راجع توقيع تطبيقك في "استوديو Android":
4. احرص على تسجيل المعلومات التالية لاستخدامها في وقت لاحق:
   1. رقم تعريف التطبيق: هذه سلسلة. يتكون فقط من أرقام (عادةً 12 رقمًا أو أكثر)، في بداية معرِّف العميل الخاص بك.
   2. شهادة التوقيع: سجِّل الشهادة التي استخدمتها عند الإعداد وصولك إلى واجهة برمجة التطبيقات (الشهادة التي قدمت ملف SHA1 المرجعي إليها). إِنْتَ يجب استخدام الشهادة نفسها لتوقيع تطبيقك عند اختبار التطبيق.
5. قم بتهيئة الإنجازات لتحدي النوع رقم:
   1. اختَر علامة التبويب الإنجازات في Google Play Console.
   2. أضِف نماذج الإنجازات التالية:

      الاسم	الوصف	تعليمات خاصة
      رئيسي	احصل على نتيجة في صورة عدد أوليّ.	بدون قفل
      Humble	اطلب النتيجة 0.	بدون قفل
      لا تكن مغرورًا يا طفلي	اطلب النتيجة 9999 في أي من الوضعين.	بدون قفل
      يا للعجب!	احصل على النتيجة 1337.	جعل هذا إنجازًا مخفيًا
      ملل	لعب اللعبة 10 مرات.	اجعل هذا إنجازًا متزايدًا من خلال 10 خطوات لفتحه.
      ملل حقيقي	لعب اللعبة 100 مرة.	يمكنك تحقيق إنجاز إضافي من خلال 100 خطوة يمكنك الاستفادة منها.

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

تحذير: إذا حاولت إجراء طلبات للحصول على حزمة تطوير البرامج (SDK) الخاصة بـ "ألعاب Play" من خلال استخدام إذا لم يتم إدراج حساب تجريبي كحساب تجريبي، فإن "خدمات ألعاب Google Play" فإذا لم تكن اللعبة موجودة، فستستعيد ConnectionResult.SIGN_IN_REQUIRED رمز الإرجاع. إذا حاولت فتح ConnectionResult.startResolutionForResult()، ستعود GamesActivityResultCodes.RESULT_SIGN_IN_FAILED

الخطوة 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.

ملاحظة: ننصحك باختبار التطبيق على جهاز Android فعلي. ومع ذلك، إذا إذا لم يكن لديك جهاز فعلي، فيمكنك إجراء الاختبار استنادًا إلى محاكي Android ولإجراء ذلك، عليك تنزيل نسخة من نظام المحاكي تتضمن خدمات Google Play، ضمن Android 4.2.2، من أداة إدارة حِزم تطوير البرامج (SDK):

لتشغيل لعبتك على جهاز الاختبار البدني:

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

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