بعد إيقاف Google Sign-In API نهائيًا، سنزيل الإصدار v1 من حزمة تطوير البرامج (SDK) الخاصة بـ "خدمات ألعاب Play". في عام 2026. بعد فبراير 2025، لن يكون بإمكانك نشر الألعاب التي تتكامل مع الإصدار v2 من حزمة SDK الخاصة بـ "خدمات ألعاب Play". ننصحك باستخدام الإصدار v2 حزمة SDK الخاصة بـ "خدمات ألعاب Play". بدلاً من ذلك.
مع أنّ التطبيقات الحالية التي تتكامل مع الإصدار v1 من حزمة SDK الخاصة بـ "خدمات ألعاب Play" ستستمر في العمل لعدّة سنوات، ننصحك
بالانتقال إلى الإصدار v2
بدءًا من يونيو 2025.
هذا الدليل مخصّص لاستخدام الإصدار v1 من حزمة SDK الخاصة بـ "خدمات ألعاب Play". للحصول على معلومات حول أحدث إصدار من حزمة SDK، يمكنك الاطّلاع على مستندات الإصدار 2.
توفّر لك ميزة تسجيل الدخول في "خدمات ألعاب Play" هوية اللاعب في الألعاب، وهي هوية خاصة بالألعاب على مستوى المنصة للاعبين على Android. تساعد هذه الهوية في بناء علاقة بين لعبتك واللاعب. ويفضّل اللاعبون استخدام هذه الهوية لتسجيل الدخول بدلاً من الأنظمة المركزية البديلة.
بالإضافة إلى ذلك، يمنحك تسجيل الدخول معرّفًا قويًا وثابتًا يمكنك استخدامه كمفتاح لنظام حفظ البيانات على السحابة الإلكترونية. تُعدّ ميزة "الحفظ على السحابة الإلكترونية" مهمة جدًا، فهي تتيح للاعبين تنفيذ ما يلي:
- المتابعة من حيث توقّفوا في حال تغيير الجهاز أو إعادة ضبطه
- تشغيل اللعبة على أجهزة متعددة (مثلاً، على هاتف آخر أو جهاز Chromebook)
- إلغاء تثبيت اللعبة وإعادة تثبيتها لاحقًا
يمكنك استخدام هوية "خدمات ألعاب Play" كمفتاح لحلّ التخزين السحابي الخاص بك، أو يمكنك استخدام خدمة "الألعاب المحفوظة" المجانية.
تتيح "خدمات ألعاب Play" (PGS) تسجيل الدخول تلقائيًا، وهي طريقة سلسة لتسجيل دخول اللاعبين، بالإضافة إلى تسجيل الدخول يدويًا، وهي عملية بنقرة واحدة. يوضّح هذا المستند طرق تسجيل الدخول المختلفة هذه.
مسار تسجيل الدخول المقترَح
لتسجيل دخول اللاعبين إلى لعبتك بنجاح، اتّبِع خطوات تسجيل الدخول التالية:
- أثناء تسلسل بدء تشغيل لعبتك، جرِّب تسجيل الدخول التلقائي لتسجيل دخول اللاعب تلقائيًا.
- إذا لم تنجح ميزة "تسجيل الدخول تلقائيًا" وكان جهاز المستخدم متصلاً بالإنترنت، جرِّب تسجيل الدخول يدويًا.
- في حال رفض تسجيل الدخول يدويًا، تذكَّر اختيار المستخدم ولا تعرض خيار تسجيل الدخول يدويًا مرة أخرى، ولكن استمر في محاولة تسجيل الدخول تلقائيًا عند بدء التشغيل.
بالإضافة إلى ذلك، يجب التأكّد من أنّ المستخدمين يمكنهم تسجيل الدخول إلى لعبتك باستخدام حسابهم على "خدمات ألعاب Play" من خلال زر مخصّص يسهل العثور عليه.
تسجيل الدخول تلقائيًا
تتيح ميزة "تسجيل الدخول التلقائي" للمستخدمين تسجيل الدخول إلى لعبتك بدون أي عوائق، فهي تلقائية. إذا طلبت لعبتك من المستخدم تسجيل الدخول وكان خيار تسجيل الدخول التلقائي مفعَّلاً (في تطبيق "ألعاب Google Play")، ستتلقّى بيانات اعتماد هوية المستخدم على "خدمات ألعاب Play" وسيظهر للمستخدم تجربة تسجيل الدخول إلى "خدمات ألعاب Play".
تسجيل الدخول التلقائي هو إعداد يمكن للمستخدمين التحكّم فيه. يمكن للمستخدمين اختيار تسجيل الدخول تلقائيًا إلى جميع الألعاب أو أن يُطلب منهم تسجيل الدخول في كل مرة.
تسجيل الدخول يدويًا
إذا لم يتم تسجيل دخول المستخدم إلى اللعبة تلقائيًا، يمكنك أن تطلب منه تسجيل الدخول يدويًا. يمكن للمستخدمين تسجيل الدخول بنقرة واحدة من مربّع حوار يظهر في أعلى لعبتك.
السماح بالنوافذ المنبثقة في "خدمات ألعاب Play" للحصول على تجربة تسجيل دخول صحيحة
عند استخدام "خدمات ألعاب Google"، يجب أن يعرف المستخدمون أنّهم سجّلوا الدخول. ويتم ذلك من خلال عرض تجربة تسجيل الدخول إلى "خدمات ألعاب Google Play".
لعرض تجربة تسجيل الدخول، استدعِ طريقة
setViewForPopups()
التابعة لفئة GamesClient أثناء بدء تشغيل اللعبة. وهذا أمر بالغ الأهمية
لتقديم تجربة المستخدم الصحيحة.
نطاقات OAuth وPGS
تعتمد "خدمات ألعاب Play" على نظام OAuth للسماح للمستخدمين بمنح لعبتك إذن الوصول إلى حساباتهم. نطاقات OAuth هي أذونات يمكنك طلبها بصفتك مطوِّرًا. وفي حال منحها، تتيح هذه الأذونات للعبتك استدعاء واجهات برمجة تطبيقات معيّنة نيابةً عن المستخدم، كما تمنحك إذن الوصول إلى أجزاء معيّنة من حسابه على Google.
تتضمّن "خدمات ألعاب 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.