يتناول هذا المستند كيفية استخدام Google Play Console لإعداد خدمات ألعاب Google Play لألعاب Android. توفر لك Google Play Console مكانًا مركزيًا لإدارة خدمات الألعاب وإعداد البيانات الوصفية لترخيص لعبتك ومصادقتها.
لإضافة لعبتك إلى Google Play Console، يُرجى اتّباع الخطوات العامة التالية:
- أنشِئ مشروع لعبة للعبتك وحدِّد تفاصيل مثل اسم اللعبة ووصفها.
- أنشئ بيانات الاعتماد اللازمة واربطها لتفويض لعبتك بخدمات ألعاب Google Play.
يتم تناول هذه الخطوات بمزيد من التفاصيل في الأقسام أدناه.
الخطوة 1. تسجيل الدخول إلى Google Play Console
لتسجيل الدخول، يُرجى الانتقال إلى Google Play Console. إذا لم يسبق لك التسجيل في Google Play Console، سيُطلب منك إجراء ذلك.
الخطوة 2. إضافة لعبتك إلى Google Play Console
لإضافة لعبتك، يُرجى اتّباع الخطوات التالية:
- أنشِئ لعبة في Play Console إذا لم يسبق لك إنشاؤها. يمكنك الاطّلاع هنا على مزيد من التفاصيل.
- انتقِل إلى نمو > خدمات ألعاب Play > الإعداد والإدارة > الإعداد.
حدِّد مشروع "خدمات ألعاب Play" الذي تريد استخدامه، ويمكنك إمّا إنشاء مشروع من البداية أو استخدام مشروع حالي.
إنشاء مشروع جديد لخدمات "ألعاب Play": لإنشاء مشروع خدمة ألعاب Play، يجب توفُّر مشروع على السحابة الإلكترونية.
إذا كان لديك مشروع على السحابة الإلكترونية تم إنشاؤه لهذه اللعبة، اختَر مشروعك على السحابة الإلكترونية من القائمة المنسدلة واختَر Use (استخدام).
وإذا لم تكن مؤهلاً، يمكنك اختيار إنشاء مشروع جديد على السحابة الإلكترونية واتّباع التعليمات لإنشاء مشروع جديد على السحابة الإلكترونية لهذه اللعبة. بعد ذلك، عليك اختيار إعادة تحميل المشاريع على السحابة الإلكترونية واختيار المشروع الجديد على السحابة الإلكترونية من القائمة المنسدلة والنقر على استخدام.
استخدام مشروع حالي لخدمات "ألعاب Play": إذا أردت إنشاء لعبة جديدة في Play Console لتغيير اسم الحزمة الحالية، أو إذا كانت لديك إصدارات مجانية ومدفوعة من لعبتك بأسماء حِزم مختلفة، يمكنك استخدام هذا الخيار. اختَر مشروع "خدمات ألعاب Play" ثم انقر على استخدام.
يتم إنشاء مشروع لعبة في "خدمات ألعاب Play" وإنشاء إدخال مناسب لك في Google Cloud Console.
في قسم الخصائص، يمكنك تحديد تعديل الخصائص وإضافة أصول الوصف والفئة والرسومات للعبتك.
- لا يلزم سوى الاسم المعروض للاختبار. يجب ملء الحقول الأخرى قبل أن تتمكن من نشر لعبتك.
- يجب أن يتطابق الاسم المعروض ووصف اللعبة مع الاسم الذي أعددته في بطاقة بيانات لعبتك على "متجر 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.
إذا كنت قد أكملت إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth، انقر على تم. يتم تحديث Google Play Console تلقائيًا، وإذا تمت التهيئة بنجاح، ستتمكن من إنشاء بيانات اعتماد:
ب- إنشاء بيانات اعتماد
للسماح للعبتك بالاتصال بخدمات ألعاب Google Play، يجب إنشاء بيانات اعتماد بمعرِّف عميل OAuth2 معتمد.
في قسم بيانات الاعتماد، انقر على إضافة بيانات الاعتماد.
في المعالج، اختَر ما إذا كنت تريد إنشاء بيانات اعتماد Android (إذا كان خادم اللعبة الخاص بك سيصادق على المستخدم وستستخدم واجهات برمجة تطبيقات "خدمات ألعاب Play") أو بيانات اعتماد خادم اللعبة (إذا كان خادم اللعبة سيستخدم واجهات برمجة تطبيقات "خدمات ألعاب Play"). اتبع التعليمات الخاصة بنوع بيانات الاعتماد المطلوب.
Android
إعداد تفاصيل بيانات الاعتماد
تأكَّد من أنّ الاسم في حقل الاسم يتطابق مع اسم لعبتك. اختَر ما إذا كنت تريد تفعيل إعداد مكافحة القرصنة.
إعداد التفويض
بعد ذلك، اختَر معرّف عميل OAuth لاستخدامه في مشروع اللعبة هذا. إذا كان لديك معرِّفات عملاء OAuth2، يمكنك اختيار واحد. ومع ذلك، ستقوم عادةً بإنشاء حساب جديد. انقر على إنشاء عميل OAuth. يؤدي ذلك إلى فتح مربّع حوار يتضمّن روابط لمواضع معيّنة وتعليمات لإنشاء معرّف عميل OAuth في Google Cloud Platform.
- اختَر Android كنوع التطبيق.
- أدخِل اسم اللعبة في حقل الاسم.
- أدخِل اسم حزمة تطبيق Android في حقل اسم الحزمة.
افتح وحدة طرفية وشغِّل أداة Keytool للحصول على الملفات المرجعية لشهادة SHA1 للإصدار وتصحيح الأخطاء.
للحصول على الملف المرجعي لشهادة الإصدار، شغِّل الأمر التالي:
keytool -list -keystore <path-to-production-keystore> -vللحصول على الملف المرجعي لشهادة تصحيح الأخطاء، شغِّل الأمر التالي:
keytool -list -keystore <path-to-debug-keystore> -vتطلب منك أداة إدارة المفاتيح إدخال كلمة مرور لملف تخزين المفاتيح. كلمة المرور التلقائية لملف تخزين مفاتيح تصحيح الأخطاء هي
android. تطبع أداة المفاتيح بعد ذلك بصمة الإصبع على الطرف.الصق الملف المرجعي لشهادة SHA1 في حقل توقيع الملف المرجعي للشهادة (SHA1).
انقر على إنشاء.
للحصول على مزيد من المعلومات حول بروتوكول OAuth 2.0 على Android، يمكنك الاطّلاع على المصادقة على خدمات OAuth2.
بعد النقر على تمّ في مربّع الحوار، ستتم إعادة تحميل معرِّفات العملاء المتاحة. اختَر بيانات الاعتماد التي أنشأتها من القائمة المنسدلة ثم انقر على حفظ التغييرات. يؤدي هذا الإجراء إلى إنشاء بيانات الاعتماد كمسودة، ما يتيح لك المصادقة على "خدمات ألعاب Play" في لعبتك.
قد تحتاج إلى إنشاء بيانات اعتماد: إحداهما بالبصمة الرقمية لشهادة الإصدار، والأخرى باسم الملف المرجعي لشهادة تصحيح الأخطاء. تأكد من استخدام نفس اسم الحزمة لكليهما. يسمح هذا الإجراء لـ "خدمات ألعاب Google Play" بالتعرّف على المكالمات من حِزم APK المرتبطة التي تم توقيعها باستخدام أي من الشهادتَين. لمزيد من المعلومات حول توقيع الشهادة لنظام التشغيل Android، اطّلع على مقالة توقيع تطبيقك.
خادم اللعبة
إعداد تفاصيل بيانات الاعتماد
تأكَّد من أنّ الاسم في حقل الاسم يتطابق مع اسم لعبتك.
إعداد التفويض
بعد ذلك، اختَر معرّف عميل OAuth لاستخدامه في مشروع اللعبة هذا. إذا كان لديك معرِّفات عملاء OAuth2، يمكنك اختيار واحد. ومع ذلك، ستقوم عادةً بإنشاء حساب جديد. انقر على إنشاء عميل OAuth. يؤدي ذلك إلى فتح مربّع حوار يتضمّن روابط لمواضع معيّنة وتعليمات لإنشاء معرّف عميل OAuth في Google Cloud Platform.
- اختَر تطبيق الويب كنوع التطبيق.
- أدخِل اسم اللعبة في حقل الاسم.
- انقر على إنشاء.
للحصول على مزيد من المعلومات حول بروتوكول 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، ضمِّنها كمشروع مكتبة، وليس كمشروع 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" التي تم ضبطها بشكلٍ صحيح.
بعد إكمال مهام الإعداد الأولية الموضحة أعلاه، يمكنك المتابعة لضبط ميزات لعبتك، مثل لوحات الصدارة والإنجازات. لمزيد من المعلومات، يُرجى الاطّلاع على تفعيل الميزات.