تسجيل الدخول

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

السماح بالنوافذ المنبثقة في "خدمات ألعاب Play" للحصول على تجربة تسجيل دخول صحيحة

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

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

نطاقات OAuth وPGS

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

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

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

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

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

إتاحة طُرق متعددة لتسجيل الدخول

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

استرداد هوية اللاعب والتحقّق منها بشكل آمن لدمجها مع الخلفية

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

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

لمزيد من المعلومات، يُرجى الاطّلاع على الوصول بلا إنترنت ومستندات REST API.

تنفيذ العميل

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