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

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

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

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

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

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

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

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

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

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

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

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

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

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

استمرار تجربة اللعب على أجهزة مختلفة باستخدام ميزة "اللعب أثناء التنقّل"

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

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

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

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

الإعداد والمصادقة

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

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

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

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

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

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

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

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

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

نطاقات OAuth

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

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

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

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

لاعب جديد

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

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

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

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

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

تبديل اللاعبين للحسابات

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

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

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

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

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

وضع الضيف

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