مصادقة النظام الأساسي

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

بما أنّ حزمة SDK الخاصة بـ "خدمات ألعاب Play" تُجري تلقائيًا مصادقة المنصة عند تشغيل اللعبة، عليك دمج حزمة SDK للإصدار 2 من "خدمات ألعاب Play" مع لعبتك وتنفيذ عملية المصادقة المقترَحة، لكي تكون لعبتك جاهزة لتنفيذ إرشادات تجربة المستخدم Google Play Games Level Up وتلبية متطلباتها.

مفاهيم المصادقة

في الإصدار 2 من "خدمات ألعاب Play"، تم تقسيم مفهوم "تسجيل الدخول" إلى طبقتَين مختلفتَين: مصادقة المنصة والمصادقة داخل اللعبة.

مصادقة المنصة

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

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

الاسم التعريفي للّاعب

الاسم التعريفي للّاعب هو معرّف لحساب لاعب على "خدمات ألعاب Play". يمكن للّعبة استرداد الاسم التعريفي لأي لاعب يسجّل الدخول إلى اللعبة باستخدام مصادقة "خدمات ألعاب Play". يمكن لتكامل عميل اللعبة، تكامل خادم اللعبة، و خدمة الحفظ على السحابة الإلكترونية استخدام رقم التعريف للوصول بشكل آمن إلى بيانات اللاعب من "خدمات ألعاب Play".

يكون الاسم التعريفي للّاعب متطابقًا للمستخدم عند تشغيل اللعبة على أجهزة متعدّدة. ومع ذلك، لا يكون الاسم التعريفي متطابقًا دائمًا بين الألعاب المختلفة. لمزيد من المعلومات، يُرجى الاطّلاع على الجيل التالي من أرقام تعريف اللاعبين.

المصادقة داخل اللعبة

يمكنك إدارة الحساب داخل اللعبة، وهو نظام الهوية الذي يربط مستوى تقدّم اللاعب ومخزونه وعملته داخل اللعبة.

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

الاستمرارية من عدّة منصات باستخدام ميزة "تسجيل الدخول باستخدام حساب Google"

لمساعدة اللاعبين في نقل مستوى تقدّمهم على أجهزة Android وiOS والويب، استخدِم تسجيل الدخول باستخدام حساب Google كطريقة أساسية للمصادقة داخل اللعبة. يُرجى مراعاة ما يلي:

• زر "تسجيل الدخول باستخدام حساب Google": في الإصدار 1 من "خدمات ألعاب Play"، كان زر Google Play غالبًا ما يعالج تسجيل الدخول إلى المنصة واللعبة معًا. في الإصدار 2، هاتان عمليتان منفصلتان. نفِّذ زرًا عاديًا لتسجيل الدخول باستخدام حساب Google ليتمكّن اللاعبون من المصادقة والوصول إلى حساباتهم داخل اللعبة.
• حِزم SDK لتسجيل الدخول إلى Google:
  • استخدِم حِزم SDK العادية لتسجيل الدخول إلى Google على كلٍّ من Android وiOS لمصادقة اللاعبين في حساباتهم داخل اللعبة.
  • استخدِم Google Open ID كمعرّف أساسي لحساب اللاعب داخل اللعبة.
  • استخدِم رقم تعريف اللاعب في "خدمات ألعاب Play" للإبلاغ عن مستوى تقدّم اللاعب في ميزات "ألعاب Play"، مثل الإنجازات.

عملية الدمج المقترَحة

لدمج لعبتك مع "خدمات ألعاب Play"، اتّبِع الخطوات المقترَحة التالية:

التهيئة والمصادقة

هذه الخطوة مطلوبة لتهيئة لعبتك ومصادقتها:

نفِّذ مصادقة المنصة من خلال تهيئة حزمة SDK للإصدار 2 من "خدمات ألعاب Play" عند بدء التشغيل. لمزيد من المعلومات، يُرجى الاطّلاع على مصادقة المنصة لألعاب Android. هذه الخطوة مطلوبة للوصول إلى ميزات "خدمات ألعاب Play"، مثل الإنجازات ولوحات الصدارة.

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

إنشاء الملف الشخصي

يحتاج اللاعبون إلى ملف شخصي على "خدمات ألعاب Play" للتفاعل مع المنصة. قد لا يكون لدى بعض اللاعبين ملف شخصي على "خدمات ألعاب Play" عند بدء لعبتك. سيُطلب من هؤلاء اللاعبين إنشاء ملف شخصي.

تظهر تلقائيًا بشكلٍ تلقائي طلبات إنشاء الملف الشخصي عند تشغيل لعبة بدون ملف شخصي على "خدمات ألعاب Play".

المصادقة داخل اللعبة

بعد إجراء مصادقة المنصة بنجاح، على المطوّرين تنفيذ الخطوات التالية ليتمكّن اللاعبون من الوصول إلى حساباتهم داخل اللعبة، وذلك حسب حالة اللعبة الحالية:

1. إذا كانت هناك جلسة لعب نشطة على الجهاز، اسمح للاعب باستئناف جلسته الحالية.
2. إذا لم تكن هناك جلسة لعب نشطة:
   1. في حال سيناريو الاستعادة السلسة حيث يتم ربط آخر حساب داخل اللعبة تم تشغيله برقم تعريف اللاعب في "خدمات ألعاب Play"، انتقِل إلى استعادة الحساب المرتبط داخل اللعبة تلقائيًا.
   2. بخلاف ذلك، اعرض على اللاعب شاشة تسجيل الدخول أو إنشاء الحساب المحدّدة في تطبيقك. يمكن للاعبين بعد ذلك اختيار طريقة المصادقة المفضّلة لإنشاء حساب حالي داخل اللعبة أو تسجيل الدخول إليه.

نطاقات OAuth

تعتمد "خدمات ألعاب Play" على نظام OAuth للسماح للاعبين بمنح لعبتك إذن الوصول إلى حساباتهم. تتضمّن "خدمات ألعاب Play" نطاقًا فريدًا للألعاب (games-lite) وتعتمد على نطاق آخر (drive.appdata) إذا كانت لعبتك تستخدم ميزة "الألعاب المحفوظة". تمنح ميزة "الألعاب المحفوظة" إذن الوصول إلى حساب المستخدم على Google Drive، حيث يتم تخزين بيانات اللعبة.

عند استخدام حزمة SDK للإصدار 2 من "خدمات ألعاب Play"، يمكنك طلب نطاقات OAuth إضافية . إذا كنت بحاجة إلى نطاقات OAuth إضافية، ننصحك باستدعاء requestServerSideAccess. لمزيد من المعلومات، يُرجى الاطّلاع على الحصول على رمز التفويض على الخادم أو استرداد رموز التفويض على الخادم.

إرشادات تجربة المستخدم لعملية المصادقة المثالية

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

اللاعب الجديد

تنطبق هذه العملية على مستخدم يشغّل اللعبة للمرة الأولى على جهاز ليس لديه سجلّ لعب سابق للّعبة.

1. عند التشغيل، تتم تهيئة حزمة تطوير البرامج (SDK) الخاصة بـ "خدمات ألعاب Google Play" لمصادقة هوية المنصة للمستخدم (رقم تعريف اللاعب في "خدمات ألعاب Google Play").
2. بعد هذه المصافحة في الخلفية، تعرض اللعبة خيارات إنشاء حساب داخل اللعبة لـ اللاعب، على سبيل المثال، إنشاء حساب جديد، تسجيل الدخول باستخدام حساب Google، أو طرق تسجيل الدخول الأخرى إلى وسائل التواصل الاجتماعي.
3. بعد أن ينشئ اللاعب حسابًا داخل اللعبة أو يختاره، تربط اللعبة هذا الحساب بالمعرّف الأساسي الذي تم اختياره في نظام الخلفية.
4. تربط اللعبة أيضًا هذا الحساب داخل اللعبة الذي تم اختياره برقم تعريف اللاعب في "خدمات ألعاب Play"، ما يجعله آخر حساب داخل اللعبة تم تشغيله لاستعادته بسلاسة.

اللاعبون الذين لديهم جلسات نشطة

يصف هذا السيناريو اللاعبين الذين يشغّلون اللعبة على جهاز لديهم عليه جلسة نشطة. الهدف هو توفير تجربة دخول سلسة.

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

اللاعبون الذين يبدّلون الحسابات

تحدث هذه العملية عندما ينتقل لاعب لديه جلسة نشطة إلى إعدادات اللعبة لتبديل الحسابات. على سبيل المثال، تسجيل الخروج من حساب رئيسي لاستخدام حساب بديل.

1. يسجّل اللاعب الخروج من الحساب الحالي داخل اللعبة، ولكن يظل اتصال منصة "خدمات ألعاب Play" نشطًا.
2. عندما يسجّل اللاعب الدخول باستخدام حساب مختلف داخل اللعبة، تربط اللعبة هذا الحساب الجديد برقم تعريف اللاعب الحالي في "خدمات ألعاب Play" كآخر حساب داخل اللعبة تم تشغيله للاستعادة بسلاسة فقط.

الاستعادة السلسة للاعبين المكرّري الزيارة

ينطبق هذا السيناريو عندما يشغّل لاعب اللعبة بعد فترة غير نشطة أو بعد إعادة تثبيتها أو على جهاز جديد تمامًا. يُنصح اللعبة بتنفيذ ميزة الاستعادة السلسة.

1. عند التشغيل، تُجري "خدمات ألعاب Play" عملية مصادقة للمستخدم وتزوّد اللعبة برقم تعريف اللاعب في "خدمات ألعاب Play".
2. تتحقّق اللعبة من نظام الخلفية (أو رمز مميّز لتذكّر بيانات اللعبة الذي تم استرداده إذا كنت تستخدم Recall API) لمعرفة ما إذا كان آخر حساب داخل اللعبة تم تشغيله مرتبطًا برقم تعريف "خدمات ألعاب Play" هذا.
3. إذا تم العثور على رابط، تستعيد اللعبة تلقائيًا مستوى تقدّم اللاعب وتسجّل دخوله، ما يؤدي إلى تخطّي شاشة تسجيل الدخول اليدوي بالكامل.
4. بخلاف ذلك، تعرض اللعبة شاشة تسجيل الدخول للاعب.
   1. يختار اللاعب بعد ذلك طريقة تسجيل الدخول ويسجّل الدخول إلى حساب داخل اللعبة.
   2. تربط اللعبة بعد ذلك هذا الحساب داخل اللعبة برقم تعريف اللاعب في "خدمات ألعاب Play" كآخر حساب داخل اللعبة تم تشغيله للاستعادة بسلاسة.

وضع الضيف

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