الخطوة الأولى لدمج لعبتك مع "خدمات ألعاب Google Play" هي تنفيذ ميزة "المصادقة على النظام الأساسي". هذا الإجراء مطلوب للوصول إلى جميع الميزات الأخرى، مثل الإنجازات وقوائم الصدارة والأحداث.
بما أنّ حزمة تطوير البرامج (SDK) الخاصة بـ "خدمات ألعاب Play" تُجري مصادقة النظام الأساسي تلقائيًا عند إطلاق اللعبة، عليك دمج حزمة تطوير البرامج (SDK) الخاصة بالإصدار الثاني من "خدمات ألعاب Google Play" مع لعبتك وتنفيذ عملية المصادقة المقترَحة، حتى تكون لعبتك جاهزة لتنفيذ إرشادات تجربة المستخدم في برنامج Google Play Games Level Up واستيفائها.
مفاهيم المصادقة
في الإصدار 2 من خدمات ألعاب Play، ينقسم مفهوم "تسجيل الدخول" إلى طبقتين مختلفتين: المصادقة على النظام الأساسي والمصادقة داخل اللعبة.
مصادقة النظام الأساسي
توفّر "خدمات ألعاب Google Play" طبقة تفاعُل مع المنصة. وتدير هذه الخدمة علاقة اللاعب بمنظومة "ألعاب Google Play" المتكاملة باستخدام الملف الشخصي للاعب، وذلك للوصول إلى ميزات مثل الإنجازات وقوائم الصدارة والمهام. تتوفّر في مصادقة النظام الأساسي الخصائص الرئيسية التالية:
- المصادقة الصامتة والتلقائية: تتم المصادقة تلقائيًا في الخلفية عند تشغيل اللعبة. لا تتطلّب "خدمات ألعاب Play" زر تسجيل الدخول يدويًا.
- رقم تعريف اللاعب: بعد إجراء مصادقة ناجحة على المنصة، توفّر "خدمات ألعاب Play" رقم تعريف لاعب ثابتًا. ويكون رقم التعريف هذا متسقًا على جميع الأجهزة للعبة نفسها. استخدِم رقم التعريف هذا بشكل أساسي لتتبُّع ميزات المنصة، مثل مستوى تقدّم الإنجازات.
- الفصل: يجب عدم استخدام خدمات ألعاب Play كنظام الهوية الأساسي للعبة لإدارة حساب اللاعب داخل اللعبة (IGA) أو مستوى تقدّمه في اللعبة أو مستودعه. تُعدّ "خدمات ألعاب Play" معرّفًا ثابتًا للمنصة.
الاسم التعريفي للّاعب
معرّف اللاعب هو معرّف لحساب لاعب على "خدمات ألعاب Play". يمكن للعبتك استرداد رقم تعريف أي لاعب يسجّل الدخول إلى لعبتك باستخدام مصادقة "خدمات ألعاب Play". يمكن لكل من عملية دمج برنامج تشغيل اللعبة وعملية دمج خادم اللعبة وخدمة الحفظ في السحابة الإلكترونية استخدام رقم التعريف للوصول بأمان إلى بيانات اللاعبين من "خدمات ألعاب Play".
ويظل رقم تعريف اللاعب هو نفسه عندما يلعب المستخدم لعبتك على أجهزة متعددة. ومع ذلك، لا يكون دائمًا متسقًا بين الألعاب. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة الجيل التالي من أرقام تعريف اللاعبين.
المصادقة داخل اللعبة
أنت تدير الحساب داخل اللعبة (IGA)، وهو نظام الهوية الذي يربط مستوى تقدّم اللاعب والمستودع والعملة داخل لعبتك.
- الهوية الأساسية: يمكنك استخدام الواجهة الخلفية الخاصة بك أو ميزة "تسجيل الدخول باستخدام حساب Google" أو غيرها من مقدّمي الخدمات كطريقة أساسية لتسجيل الدخول.
- الاستقلالية: يمكن للاعبين تسجيل الدخول إلى "خدمات ألعاب Play" (هوية المنصة) لتحقيق الإنجازات أثناء تسجيل الدخول إلى أي حساب IGA محدّد (على سبيل المثال، حساب ضيف أو حساب محدّد في SiWG).
- إدارة حسابات متعددة داخل اللعبة: تتعامل "خدمات ألعاب Play" مع المصادقة على النظام الأساسي فقط. تدير لعبتك المصادقة الأساسية للاعبين في حساباتهم داخل اللعبة. هذا يعني أنّه لن يتم إجراء أي تغيير على المسارات الحالية في لعبتك لتبديل اللاعبين بين حساباتهم داخل اللعبة. عندما يبدّل اللاعبون حساباتهم، تظل مصادقتهم على منصة "ألعاب Google Play" سارية من خلال "خدمات ألعاب Google Play"، وتستمر في إرسال بياناتهم المتعلقة بالإنجازات وميزات "خدمات ألعاب Google Play" الأخرى إلى رقم تعريف اللاعب الثابت.
مواصلة اللعب من عدّة منصات باستخدام ميزة "تسجيل الدخول باستخدام حساب Google"
لمساعدة اللاعبين في نقل مستوى تقدّمهم في اللعبة على أجهزة Android وiOS والويب، استخدِم ميزة تسجيل الدخول باستخدام حساب Google كطريقة أساسية للمصادقة داخل اللعبة. ضَع في اعتبارك ما يلي:
- زر "تسجيل الدخول باستخدام حساب Google": في الإصدار الأول من "خدمات ألعاب Google Play"، غالبًا ما كان زر Google Play يتولّى تسجيل الدخول إلى كل من المنصة واللعبة. في الإصدار الثاني، تكون هذه العمليات منفصلة. يمكنك إضافة زر تسجيل الدخول باستخدام حساب Google العادي ليتمكّن اللاعبون من المصادقة والوصول إلى حساباتهم على IGA.
- حِزم تطوير البرامج (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".
على الرغم من أنّه يمكن للمستخدمين تسجيل الدخول باستخدام أي موفِّر هوية، يجب عرض طلب إنشاء ملف شخصي لتشجيعهم على المصادقة باستخدام مصادقة منصة "ألعاب Google Play". يمكنك عرض هذا الطلب حسب الحاجة، ولكن تأكَّد من ظهوره قبل أن يحقّق المستخدمون تقدّمًا كبيرًا في ميزات مثل الإنجازات وقوائم الصدارة.
ننصحك بعرض طلب إنشاء الملف الشخصي في الأوقات التالية:
- بعد إكمال برنامج تعليمي
- أثناء لحظة مكافأة (على سبيل المثال، الفوز بمباراة أو جمع عنصر نادر أو تحقيق إنجاز مهم)
- عند بدء جلسة ثانية
لمزيد من المعلومات، يُرجى الاطّلاع على مقالتَي منع إنشاء الملفات الشخصية تلقائيًا (Java) ومنع إنشاء الملفات الشخصية تلقائيًا (Unity).
المصادقة داخل اللعبة
بعد تنفيذ مصادقة النظام الأساسي بنجاح، على المطوّرين اتّباع الخطوات التالية ليتمكّن اللاعبون من الوصول إلى حساباتهم داخل اللعبة، وذلك حسب حالة اللعبة الحالية:
- إذا كانت هناك جلسة لعب نشطة على الجهاز، اسمح للاعب باستئناف جلسته الحالية.
- في حال عدم توفّر جلسة لعب نشطة:
- في حال الاستعادة السلسة لآخر لعبة تم لعبها داخل التطبيق ومرتبطة بمعرّف اللاعب في "خدمات ألعاب Google Play"، يجب المتابعة لاستعادة اللعبة المرتبطة داخل التطبيق تلقائيًا.
- وإذا لم يكن الأمر كذلك، اعرض على اللاعب شاشة تسجيل الدخول أو إنشاء الحساب المخصّصة لتطبيقك. يمكن للاعبين بعد ذلك اختيار طريقة المصادقة المفضّلة لديهم لإنشاء حساب IGA أو تسجيل الدخول إلى حساب حالي.
نطاقات OAuth
تعتمد "خدمات ألعاب Play" على
نظام OAuth
للسماح للاعبين بمنح لعبتك إذن الوصول إلى حساباتهم. تتضمّن "خدمات ألعاب Play" نطاقًا فريدًا للألعاب (games-lite) وتعتمد على نطاق آخر (drive.appdata) إذا كانت لعبتك تستخدم ميزة "حفظ التقدم في الألعاب". تتيح ميزة "حفظ التقدم في الألعاب" الوصول إلى حساب المستخدم على Google Drive، حيث يتم تخزين بيانات اللعبة.
عند استخدام الإصدار 2 من حزمة تطوير البرامج (SDK) لخدمات ألعاب Play، يمكنك طلب نطاقات OAuth إضافية.
إذا كنت بحاجة إلى نطاقات OAuth إضافية، ننصحك باستدعاء requestServerSideAccess.
لمزيد من المعلومات، يُرجى الاطّلاع على كيفية الحصول على رمز مصادقة الخادم أو استرداد رموز مصادقة الخادم.
إرشادات تجربة المستخدم لتدفق المصادقة المثالي
توضّح الإرشادات التالية عملية المصادقة المقترَحة مع دمج الإصدار الثاني من "خدمات ألعاب Google Play". وتغطي سيناريوهات للمستخدمين الجدد والحاليين والمستخدمين المكرري الزيارة ووضع الضيف.
لاعب جديد
ينطبق هذا الإجراء على المستخدم الذي يشغّل اللعبة لأول مرة على جهاز ليس له سجلّ لعب سابق مع اللعبة.
- عند تشغيل اللعبة، تتم تهيئة حزمة تطوير البرامج (SDK) لخدمات ألعاب Google Play من أجل مصادقة هوية المستخدم على المنصة (رقم تعريف اللاعب في خدمات ألعاب Google Play).
- بعد هذه المصافحة في الخلفية، تعرض اللعبة خيارات إنشاء حساب IGA للاعب، مثل إنشاء حساب جديد أو تسجيل الدخول باستخدام حساب Google أو طرق تسجيل الدخول الأخرى عبر وسائل التواصل الاجتماعي.
- بعد أن ينشئ اللاعب حساب IGA أو يختاره، تربط اللعبة هذا الحساب بالمعرّف الأساسي الذي تم اختياره في الخلفية.
- تربط اللعبة أيضًا حساب IGA هذا بمعرّف اللاعب في "خدمات ألعاب Google Play"، وتصنّفه على أنّه آخر حساب IGA تم استخدامه للعب من أجل استعادة البيانات بسلاسة.
اللاعبون الذين لديهم جلسات نشطة
يصف هذا السيناريو اللاعبين الذين يشغّلون اللعبة على جهاز لديهم جلسة نشطة عليه. الهدف هو توفير تجربة دخول سلسة.
- عندما يشغّل اللاعب التطبيق، تتم مصادقة "خدمات ألعاب Google Play" تلقائيًا في الخلفية، ما يوفّر لك رقم تعريف اللاعب لتتبُّع مستوى تقدّمه في الإنجازات وميزات "ألعاب Google Play" الأخرى.
- في الوقت نفسه، يتجاوز التطبيق شاشات تسجيل الدخول، حيثما ينطبق ذلك، ويسجّل دخول اللاعب على الفور إلى جلسة IGA النشطة أو آخر جلسة IGA تم تشغيلها والمرتبطة بمعرّف اللاعب، حتى يتمكّن من استئناف اللعب على الفور.
اللاعبون الذين يبدّلون الحسابات
يحدث هذا التدفق عندما ينتقل لاعب لديه جلسة نشطة إلى إعدادات اللعبة لتبديل الحسابات. على سبيل المثال، تسجيل الخروج من حساب رئيسي لاستخدام حساب بديل.
- يسجّل اللاعب خروجه من حساب IGA الحالي، ولكن يظل الاتصال بمنصة "خدمات ألعاب Google Play" نشطًا.
- عندما يسجّل اللاعب الدخول باستخدام حساب IGA مختلف، تربط اللعبة هذا الحساب الجديد برقم تعريف اللاعب الحالي على "خدمات ألعاب Google Play" باعتباره آخر حساب IGA تم استخدامه في اللعب فقط لضمان استعادة البيانات بسلاسة.
استعادة سلسة للّاعبين المكرّري الزيارة
ينطبق هذا السيناريو عندما يشغّل اللاعب اللعبة بعد فترة من عدم النشاط أو بعد إعادة تثبيتها أو على جهاز جديد تمامًا. ننصح بتنفيذ ميزة الاستعادة السلسة في اللعبة.
- عند تشغيل اللعبة، تصادق "خدمات ألعاب Google Play" على المستخدم وتوفّر معرّف اللاعب في "خدمات ألعاب Google Play" للّعبة.
- تتحقّق اللعبة من الخلفية (أو الرمز المميّز المستردّ في حال استخدام واجهة برمجة التطبيقات Recall) لمعرفة ما إذا كان حساب IGA الذي تم اللعب به مؤخرًا مرتبطًا برقم تعريف "خدمات ألعاب Google Play" هذا.
- إذا تم العثور على رابط، تستعيد اللعبة تلقائيًا مستوى تقدّم اللاعب وتسجّل دخوله، متخطيةً شاشة تسجيل الدخول اليدوي بالكامل.
- وإلا، ستعرض اللعبة شاشة تسجيل الدخول للاعب.
- بعد ذلك، يختار اللاعب طريقة تسجيل الدخول ويسجّل الدخول إلى حساب IGA
- بعد ذلك، تربط اللعبة حساب IGA هذا برقم تعريف اللاعب على "خدمات ألعاب Google Play" باعتباره آخر حساب IGA تم استخدامه للعب من أجل استعادة البيانات بسلاسة.
وضع الضيف
يمكن للاعبين تشغيل لعبتك واللعب باستخدام حساب ضيف محلي. تستمر خدمات ألعاب Play في مصادقة اللاعب في الخلفية. إذا اختار اللاعب حفظ مستوى التقدّم، ستحوّل اللعبة جلسة الضيف إلى حساب IGA دائم وتربطه برقم تعريف اللاعب. لمزيد من المعلومات حول حلّ التعارض، يُرجى الاطّلاع على حساب الضيف.
اختبار لعبتك
تأكَّد من أنّ لعبتك تعمل على النحو المطلوب من خلال اختبارها. تعتمد الاختبارات التي تجريها على ميزات لعبتك.
في ما يلي قائمة بالاختبارات الشائعة التي يمكن إجراؤها.
تسجيل الدخول بنجاح:
تعمل ميزة "تسجيل الدخول تلقائيًا". يجب أن يكون المستخدم مسجِّلاً الدخول إلى "خدمات ألعاب Play" عند تشغيل اللعبة.
ستظهر النافذة المنبثقة الترحيبية.
نموذج لنافذة ترحيب منبثقة (انقر للتكبير). يتم عرض الرسائل المسجّلة الناجحة. نفِّذ الأمر التالي في الوحدة الطرفية:
adb logcat | grep com.google.android.
تظهر رسالة مسجّلة ناجحة في المثال التالي:
[
$PlaylogGamesSignInAction$SignInPerformerSource@e1cdecc number=1 name=GAMES_SERVICE_BROKER>], returning true for shouldShowWelcomePopup. [CONTEXT service_id=1 ]
ضمان اتساق مكوّنات واجهة المستخدم:
تظهر النوافذ المنبثقة وقوائم الصدارة والإنجازات بشكل صحيح ومتّسق على مختلف أحجام الشاشات واتجاهاتها في واجهة مستخدم "خدمات ألعاب Play".
لا يظهر خيار تسجيل الخروج في واجهة مستخدم "خدمات ألعاب Play".
تأكَّد من إمكانية استرداد معرّف اللاعب بنجاح، ومن أنّ إمكانات جهة الخادم تعمل على النحو المتوقّع، إن أمكن.
إذا كانت اللعبة تستخدم المصادقة من جهة الخادم، عليك اختبار عملية
requestServerSideAccessبدقة. تأكَّد من أنّ الخادم يتلقّى رمز المصادقة ويمكنه استبداله برمز دخول. اختبِر سيناريوهات النجاح والفشل في ما يتعلّق بأخطاء الشبكة وسيناريوهاتclient IDغير الصالحة.
إذا كانت لعبتك تستخدم أيًا من الميزات التالية، فاختبِرها للتأكّد من أنّها تعمل كما كانت قبل نقل البيانات:
- قوائم الصدارة: يمكنك إرسال النتائج والاطّلاع على قوائم الصدارة. تحقَّق من صحة الترتيب وعرض أسماء اللاعبين ونتائجهم.
- الإنجازات: يمكنك إتاحة الإنجازات والتحقّق من تسجيلها وعرضها بشكل صحيح في واجهة مستخدم "ألعاب Google Play".
- حفظ التقدم في الألعاب: إذا كانت اللعبة تستخدم ميزة حفظ التقدم في الألعاب، تأكَّد من أنّ حفظ مستوى التقدّم في اللعبة وتحميله يعملان بشكل سلس. هذا أمر بالغ الأهمية لاختباره عبر أجهزة متعددة وبعد تحديثات التطبيق.