إعداد خدمات ألعاب Google Play

يتناول هذا المستند كيفية استخدام Google Play Console لإعداد خدمات ألعاب Google Play للعبة Android. توفر Google Play Console مكانًا مركزيًا لإدارة خدمات الألعاب وتهيئة البيانات الوصفية لتفويض لعبتك ومصادقتها.

لإضافة لعبتك إلى Google Play Console، اتّبِع الخطوات العامة التالية:

• أنشئ مشروعًا للعبتك وحدّد تفاصيلها مثل اسم اللعبة ووصفها.
• أنشئ بيانات الاعتماد اللازمة واربطها لتفويض لعبتك ومصادقتها على خدمات ألعاب Google Play.

يتم تناول هذه الخطوات بمزيد من التفصيل في الأقسام أدناه.

الخطوة الأولى: تسجيل الدخول إلى Google Play Console

لتسجيل الدخول، انتقل إلى Google Play Console. إذا لم يسبق لك التسجيل في Google Play Console، سيُطلب منك ذلك.

الخطوة الثانية: إضافة لعبتك إلى Google Play Console

لإضافة لعبتك، اتبع الخطوات التالية:

1. يمكنك إنشاء لعبة في Play Console إذا لم يسبق لك إنشاؤها. اطّلع على هنا لمزيد من التفاصيل.
2. انتقل إلى زيادة > خدمات ألعاب Play > الإعداد والإدارة > الضبط.

3. حدِّد ما إذا كانت لعبتك تستخدم Google APIs (مثل Firebase). إن تحديد الخيار الصحيح مهم للغاية.

   • إذا كانت هذه اللعبة من إنشائك، أو لم يسبق لك إعداد Google APIs لها، فاختر لا، اللعبة لا تستخدم Google APIs. أدخل اسم اللعبة ثم انقر على إنشاء.
   • إذا كنت قد أعددت لعبة أو أكثر من واجهات برمجة تطبيقات Google في حسابك، فاختر نعم، لعبتي تستخدم Google APIs بالفعل. ستظهر لك قائمة بالمشاريع من Google Cloud Console، والتي تم إدراج مطوّر برامج لها. اختَر مشروعك من القائمة، ثم انقر على Use (استخدام).
   • إذا كنت تريد استخدام مشروع حالي في خدمات ألعاب Play، فاختر استخدام مشروع حالي في خدمات ألعاب Play. سترى قائمة بمشاريع خدمات ألعاب Play الحالية لحسابك. اختَر مشروع اللعبة الصحيح من القائمة، ثم انقر على استخدام. وهذا ليس اختيارًا نموذجيًا، ولكن يمكنك القيام بذلك إذا كنت تنشئ لعبة جديدة في Play Console لتغيير اسم الحزمة، أو إذا كان لديك إصدارات مجانية ومدفوعة من لعبتك بأسماء حِزم مختلفة.

4. يتم إنشاء مشروع لعبة "خدمات ألعاب Play"، ويتم إنشاء إدخال مقابل لك في Google Cloud Console.

5. في قسم الخصائص، يمكنك تحديد تعديل الخصائص وإضافة الوصف والفئة وأصول الرسومات للعبتك.

   • ويكون الاسم المعروض فقط مطلوبًا للاختبار. يجب ملء الحقول الأخرى قبل نشر اللعبة.
   • يجب أن يتطابق الاسم المعروض للعبتك ووصفها مع ما أعددته لبطاقة بيانات لعبتك على متجر Play.
   • للحصول على إرشادات حول إنشاء أصول الرسومات، راجع دليل Google Play لمطوري البرامج وإرشادات الصور المميزة في Google Play.

الخطوة 3: إنشاء معرِّف عميل OAuth 2.0

يجب أن يتوفر للعبتك معرِّف عميل OAuth 2.0 حتى تتم مصادقتها وتفويضها لاستدعاء خدمات ألعاب Google Play. لإعداد بيانات اعتماد لخدمات "ألعاب Play" المرتبطة بمعرف العميل ولعبتك، استخدِم Google Cloud Platform لإنشاء معرِّف العميل. بعد ذلك، استخدم Google Play Console لإضافة بيانات اعتماد مع ربط معرِّف العميل باللعبة.

للحصول على تعليمات أكثر تفصيلاً، اطلع على الخطوات التالية:

أ. ضبط شاشة موافقة OAuth

في حالة عدم تهيئة شاشة موافقة OAuth حتى الآن، فسيعرض قسم بيانات الاعتماد رسالة تطالبك بالتهيئة.

انقر على تهيئة. يؤدي ذلك إلى فتح مربّع حوار يتضمّن تعليمات إضافية ورابطًا لموضع معيّن يؤدي إلى Google Cloud Platform.

ملاحظة: تأكّد من توفّر شاشة الموافقة لجميع المستخدمين الذين تتوفّر لهم اللعبة. يجب أن تتضمن القائمة النهائية للنطاقات games وgames_lite وdrive.appdata، ولن يتطلب أي من هذه النطاقات إثبات ملكية التطبيق. وننصح بنشر شاشة الموافقة على الفور. إذا لم يكن ذلك ممكنًا، يمكنك إتاحة شاشة الموافقة للمختبِرين للسماح لهم بتسجيل الدخول إلى اللعبة.

إذا كنت قد أكملت إعداد شاشة موافقة OAuth، انقر على تم. يتم تحديث Google Play Console تلقائيًا، وإذا نجحت التهيئة، فستتمكن من إنشاء بيانات اعتماد:

ب. إنشاء بيانات اعتماد

لتفويض لعبتك بالاتصال بخدمات ألعاب Google Play، يجب إنشاء بيانات اعتماد باستخدام معرِّف عميل OAuth2 معتمد.

في قسم بيانات الاعتماد، انقر على إضافة بيانات اعتماد.

في المعالج، اختَر ما إذا كنت تريد إنشاء بيانات اعتماد Android (إذا كانت حزمة APK للعبة ستصادق على المستخدم وتستخدم واجهات برمجة تطبيقات PGS) أو بيانات اعتماد خادم ألعاب (إذا كان خادم اللعبة سيستخدم واجهات برمجة تطبيقات PGS). اتبع التعليمات الخاصة بنوع الاعتماد الذي تريده.

Android

إعداد تفاصيل بيانات الاعتماد

تأكد من تطابق الاسم في حقل الاسم مع اسم لعبتك. اختر ما إذا كنت تريد تفعيل مكافحة القرصنة.

إعداد التفويض

بعد ذلك، اختر معرِّف عميل OAuth لاستخدامه في مشروع اللعبة هذا. إذا كان لديك معرّفات عميل OAuth2، يمكنك اختيار أحدها. ومع ذلك، يمكنك عادةً إنشاء حساب جديد. انقر على إنشاء عميل OAuth. يؤدي ذلك إلى فتح مربّع حوار يتضمّن روابط تعليمات تفصيلية وتعليمات لإنشاء معرّف عميل OAuth في Google Cloud Platform.

1. حدد Android كنوع التطبيق.
2. أدخل اسم اللعبة في حقل الاسم.
3. أدخل اسم الحزمة في تطبيق Android في حقل اسم الحزمة.

4. افتح نافذة طرفية وشغِّل أداة الأداة المساعدة للحصول على بصمات الأصابع SHA1 للإصدار وشهادات تصحيح الأخطاء.

   للحصول على الملف المرجعي لشهادة الإصدار، شغّل الأمر التالي:

   keytool -list -keystore <path-to-production-keystore> -v

   للحصول على الملف المرجعي لشهادة تصحيح الأخطاء، شغِّل الأمر التالي:

   keytool -list -keystore <path-to-debug-keystore> -v

   ملاحظة: على نظام التشغيل Windows، يقع ملف تخزين المفاتيح لتصحيح الأخطاء على C:\Users\<USERNAME>\.android\debug.keystore. في نظام التشغيل Mac أو Linux، يقع موقع تصحيح الأخطاء عادةً في ~/.android/debug.keystore.

5. تطلب منك الأداة المساعدة Keytool إدخال كلمة مرور لملف تخزين المفاتيح. كلمة المرور التلقائية لملف تخزين المفاتيح لتصحيح الأخطاء هي android. ومن ثم تطبع أداة المفاتيح بصمة الإصبع إلى الوحدة الطرفية.

6. ألصق الملف المرجعي لشهادة SHA1 في الحقل الملف المرجعي لشهادة التوقيع (SHA1).

7. انقر على إنشاء.

لمزيد من المعلومات حول OAuth 2.0 على Android، راجع المصادقة مع خدمات OAuth2.

تحذير: تأكد من تسجيل اسم الحزمة وشهادة التوقيع التي هيأتها في هذه الخطوة. وسيؤدي استخدام شهادة أو اسم حزمة مختلفين في تطبيقك إلى إخفاقات في المصادقة.

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

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

خادم اللعبة

إعداد تفاصيل بيانات الاعتماد

تأكد من تطابق الاسم في حقل الاسم مع اسم لعبتك.

إعداد التفويض

بعد ذلك، اختر معرِّف عميل OAuth لاستخدامه في مشروع اللعبة هذا. إذا كان لديك معرّفات عميل OAuth2، يمكنك اختيار أحدها. ومع ذلك، يمكنك عادةً إنشاء حساب جديد. انقر على إنشاء عميل OAuth. يؤدي ذلك إلى فتح مربّع حوار يتضمّن روابط تعليمات تفصيلية وتعليمات لإنشاء معرّف عميل OAuth في Google Cloud Platform.

1. حدد تطبيق الويب كنوع التطبيق.
2. أدخل اسم اللعبة في حقل الاسم.
3. انقر على إنشاء.

لمزيد من المعلومات حول OAuth 2.0 على Android، راجع المصادقة مع خدمات OAuth2.

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

تجنب مشاكل الإعداد الشائعة

لتجنب أخطاء الإعداد الشائعة، تأكد من اتباع هذه التوصيات عند إعداد لعبتك لاستخدام خدمات ألعاب Google Play.

1- إعداد لعبتك باستخدام Google Play Console

إذا أنشأت معرِّف عميل Oauth 2.0 لتطبيقك في Google Cloud Console، لن تكون خدمات ألعاب Google Play على علم بالربط بين إنجازات اللعبة ولوحات الصدارة ومعرف العميل. لإنشاء هذا الربط، عليك إنشاء بيانات اعتماد باستخدام معرِّف عميل Oauth 2.0 كما هو موضَّح في إنشاء بيانات اعتماد.

2- استخدام معرّف التطبيق الصحيح في Android

رقم تعريف التطبيق هو مورد سلسلة مطلوب عليك الرجوع إليه في بيان Android. تتكون سلسلة رقم تعريف التطبيق من الأرقام (عادةً 12 أو أكثر) في بداية معرِّف العميل الذي تقدمه Google Play Console. يمكن العثور على رقم تعريف التطبيق في أعلى صفحة الضبط ويتم تصنيفه باعتباره رقم تعريف المشروع أسفل اسم لعبتك.

3. توقيع ملف APK باستخدام الشهادة الصحيحة

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

4. عند تطوير نظام التشغيل Android، يمكنك تضمين "حزمة تطوير البرامج (SDK) لألعاب Play" كمشروع مكتبة، وليس كمكتبة JAR مستقلة.

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

5. تسجيل الدخول باستخدام حساب مختبِر أثناء التطوير

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

6. نشر شاشة طلب الموافقة في Google Cloud Platform

قبل نشر التطبيق في Google Play Console، عليك نشر شاشة طلب الموافقة في Google Cloud Platform. بدون هذه الخطوة، لن يتمكّن الجمهور من استخدام أي من ميزات "خدمات ألعاب Play".

7. عند إصدار اللعبة، يجب نشر إعدادات "خدمات ألعاب Play" أولاً قبل نشرها.

قد ينشر مطوّرو البرامج تطبيقاتهم عن طريق الخطأ بدون نشر إعدادات خدمات "ألعاب Google Play" المقابلة لتطبيقهم، ما قد يؤدي إلى مواجهة اللاعبين الذين يسجّلون الدخول باستخدام حسابات غير مختبِرين أخطاء لأنّ التطبيق لا يمكنه الرجوع إلى إعدادات اللعبة الصحيحة. عند إصدار لعبتك، لا تنس نشر إعدادات اللعبة أولاً باستخدام خيار نشر اللعبة على Google Play Console. لمعرفة كيفية نشر التغييرات، اطلع على نشر تغييرات الألعاب.

للحصول على نصائح إضافية، يُرجى الرجوع إلى:

• دليل تحرّي الخلل في Android وإصلاحه - وثائق مطوّري البرامج التي توضح كيفية تحرّي المشكلات وإصلاحها أثناء تطوير ألعاب Android.

الخطوات التالية

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

بعد إكمال مهام الإعداد الأولية الموضحة أعلاه، يمكنك المتابعة لتهيئة ميزات لعبتك، مثل لوحات الصدارة والإنجازات. لمعرفة المزيد، راجع تمكين الميزات.