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

تتمثّل الخطوة الأولى في دمج لعبتك مع "خدمات ألعاب 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 Play الفورية". وهذا يعني أنّه لن يتم إجراء أي تغيير على مسارات اللعبة الحالية التي تتيح للاعبين التبديل بين حساباتهم على "ألعاب Google الفورية". عندما يبدّل اللاعبون الحسابات، يظلّون مصادقًا عليهم في منصة "ألعاب Play" من خلال "خدمات ألعاب Google Play"، وتستمر في إرسال بياناتهم المتعلقة بالإنجازات وميزات "خدمات ألعاب Google 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".

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

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

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

ننصحك بعرض طلب إنشاء الملف الشخصي خلال اللحظات المقترَحة التالية:

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

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

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

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

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

نطاقات OAuth

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

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

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

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

لاعب جديد

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

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

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

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

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

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

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

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

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

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

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

وضع الضيف

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