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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

مطالبات إنشاء الملف الشخصي التي يتم تشغيلها تلقائيًا

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

إيقاف مطالبات إنشاء الملف الشخصي التي يتم تشغيلها تلقائيًا

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

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

ننصحك بتشغيل مطالبة الملف الشخصي في اللحظات التالية:

• بعد إكمال برنامج تعليمي
• أثناء لحظة مكافأة (مثل الفوز بمباراة أو جمع عنصر نادر أو تحقيق إنجاز)
• عند تشغيل جلسة ثانية

لمزيد من المعلومات، يُرجى الاطّلاع على مقالتَي منع إنشاء الملف الشخصي الذي يتم تشغيله تلقائيًا (Java) ومنع إنشاء الملف الشخصي الذي يتم تشغيله تلقائيًا (Unity).

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

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

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. تربط اللعبة أيضًا حساب اللاعب داخل اللعبة الذي تم اختياره برقم تعريف اللاعب في خدمات ألعاب Google Play، ما يجعله حساب اللاعب داخل اللعبة الذي تم تشغيله آخر مرة لاستعادته بسلاسة.

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

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

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

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

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

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

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

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

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

وضع الضيف

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