تسجيل الدخول

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

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

  • يمكنك المتابعة من حيث توقّف عن تغيير الجهاز أو إعادة ضبطه.
  • تشغيل اللعبة على أجهزة متعددة (على هاتف آخر أو على جهاز Chromebook مثلاً)
  • إلغاء تثبيت اللعبة وإعادة تثبيتها لاحقًا

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

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

الخطوات المقترَحة لتسجيل الدخول

لتسجيل دخول اللاعبين بنجاح إلى لعبتك، استخدم خطوات تسجيل الدخول التالية:

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

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

تسجيل الدخول التلقائي

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

تسجيل الدخول التلقائي هو إعداد يمكن للمستخدمين التحكُّم فيه. ويمكن للمستخدمين اختيار تسجيل الدخول تلقائيًا إلى جميع الألعاب أو سؤالهم في كل مرة.

تسجيل الدخول التلقائي

تسجيل الدخول اليدوي

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

تسجيل الدخول اليدوي

السماح بعرض نوافذ PGS المنبثقة لتجربة تسجيل الدخول الصحيحة

عند استخدام "خدمات ألعاب Play"، يجب أن يعرف المستخدمون أنهم قد سجّلوا الدخول. ويتم ذلك من خلال عرض تجربة تسجيل الدخول إلى PGS.

لإظهار تجربة تسجيل الدخول، يمكنك استدعاء طريقة setViewForPopups() للصف GamesClient أثناء بدء تشغيل اللعبة. وهذا أمر مهم لتمكين تجربة المستخدم الصحيحة.

نطاقات OAuth وPGS

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

تمتلك PGS نطاقًا فريدًا للألعاب (games-lite) وتعتمد على نطاق آخر (drive.app_data) إذا كانت لعبتك تستخدم ميزة الألعاب المحفوظة. تتيح ميزة الألعاب المحفوظة الدخول إلى حساب Google Drive للمستخدم، وهو المكان الذي يتم فيه تخزين بيانات اللعبة.

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

وتتمثل أفضل الممارسات في استخدام طلبات النطاقات المتزايدة. يجب أن تطلب لعبتك نطاقات PGS فقط أولاً في الطلب الأول، وأن تطلب نطاقات أخرى بشكل منفصل في لحظة أكثر صلة.

يتم منح الدخول عبر بروتوكول OAuth باستخدام شاشة مختلفة لكل نطاق. ويسمح ذلك للمستخدمين بتحديد النطاقات التي يمكن الوصول إليها بطريقة أكثر دقة. من خلال استخدام تسجيل الدخول التلقائي باستخدام نطاقات PGS فقط، لن يضطر المستخدمون إلى التفاعل مع أي مطالبات من OAuth، ما يحدّ من معوقات تسجيل الدخول.

دعم طرق الدخول المتعدد

تقدم PGS هوية ألعاب الفيديو للاعبين على Android، ولكن ليس من الضروري أن تكون الهوية الوحيدة المتصلة بمستخدميك. يمكنك تسجيل دخول اللاعبين باستخدام PGS ومعرّف الشبكة الاجتماعية ونظام المعرّف داخل اللعبة الخاص بك، كل ذلك في الوقت نفسه. ويوفّر كل نظام قيمة فريدة لك ولللاعبين، ويمكن للجميع العمل معًا لتقديم تجربة رائعة للاعبين على Android.

استرداد هوية المشغّل بأمان والتحقّق من تكاملها

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

بالإضافة إلى ذلك، بالنسبة إلى بعض الألعاب واللاعبين السابقين، قد لا يكون رقم تعريف اللاعب الذي تعرضه حزمة Android SDK للاعب هو الرقم التعريفي نفسه الذي يراه اللاعبون الآخرون عند مشاهدة ذلك اللاعب في اللعبة نفسها - ويكون هذا الأمر ذا صلة تحديدًا عند استخدام قائمة الأصدقاء. ومع ذلك، فإن قيمة player_id التي يتم عرضها في واجهة برمجة تطبيقات REST تكون دائمًا متسقة وتتطابق دائمًا مع المعرّف الذي يظهر للاعبين الآخرين.

لمزيد من المعلومات، يمكنك الاطّلاع على مستندات الوصول بلا إنترنت ووثائق واجهة برمجة تطبيقات REST.

تنفيذ العميل

لمعرفة كيفية تنفيذ دعم تسجيل الدخول على Android، راجع تسجيل الدخول في ألعاب Android.