بعد إيقاف واجهة برمجة التطبيقات
Google Sign-In API
نهائيًا، سنزيل حزمة تطوير البرامج (SDK) لألعاب الإصدار 1 في عام 2026. بعد شباط (فبراير) 2025، لن تتمكّن من نشر
العناوين التي تم دمجها حديثًا مع حزمة تطوير البرامج (SDK) لإصدار 1 من "ألعاب Google Play" على Google Play. ننصحك باستخدام
حزمة تطوير البرامج (SDK) لإصدار 2 من "ألعاب Google Play" بدلاً من ذلك.
على الرغم من أنّ العناوين الحالية التي تم دمجها مع الإصدار 1 من الألعاب السابقة ستظل تعمل لعدة
سنوات، ننصحك بنقل بياناتها إلى الإصدار 2
اعتبارًا من حزيران (يونيو) 2025.
يتناول هذا الدليل استخدام حزمة تطوير البرامج (SDK) لإصدار 1 من "خدمات ألعاب Play". للحصول على معلومات
عن أحدث إصدار من حزمة SDK، يُرجى الاطّلاع على
مستندات الإصدار 2.
يمنحك تسجيل الدخول إلى "خدمات ألعاب Play" هوية اللاعب في الألعاب، وهي هوية خاصة بالألعاب على مستوى النظام الأساسي للاعبين على Android. تساعد هذه الهوية في بناء علاقة بين لعبتك واللاعب. ويميل اللاعبون إلى استخدام هذه الهوية لتسجيل الدخول أكثر من استخدام الأنظمة المركزية البديلة.
بالإضافة إلى ذلك، يمنحك تسجيل الدخول معرّفًا قويًا ومتسقًا يمكنك استخدامه كمفتاح لنظام تخزين في السحابة الإلكترونية. تُعد ميزة "الحفظ في السحابة الإلكترونية" قيّمة للغاية، إذ تتيح للاعبين تنفيذ ما يلي:
- مواصلة العمل من حيث توقفوا في حال تغيير جهازهم أو إعادة ضبطه
- تشغيل اللعبة على أجهزة متعددة (على سبيل المثال، على هاتف آخر أو جهاز Chromebook)
- إلغاء تثبيت اللعبة ثم إعادة تثبيتها لاحقًا
يمكنك استخدام هوية "خدمات ألعاب Play" كمفتاح لحلّ ميزة "حفظ التقدم في السحابة الإلكترونية"، أو يمكنك استخدام خدمة "حفظ التقدم في الألعاب" المجانية.
تتيح "خدمات ألعاب Play" ميزة تسجيل الدخول التلقائي، وهي طريقة سلسة لتسجيل دخول اللاعبين، بالإضافة إلى ميزة تسجيل الدخول اليدوي التي تتم بنقرة واحدة. يصف هذا المستند هذه الطرق المختلفة لتسجيل الدخول.
مسار تسجيل الدخول المقترَح
لتسجيل اللاعبين بنجاح في لعبتك، استخدِم خطوات تسجيل الدخول التالية:
- أثناء تسلسل بدء تشغيل لعبتك، جرِّب تسجيل الدخول التلقائي لتسجيل دخول اللاعب تلقائيًا.
- إذا لم تنجح ميزة "تسجيل الدخول تلقائيًا" وكان جهاز المستخدم متصلاً بالإنترنت، جرِّب تسجيل الدخول يدويًا.
- في حال رفض تسجيل الدخول اليدوي، يجب تذكُّر اختيار المستخدم وعدم عرض تسجيل الدخول اليدوي مرة أخرى، ولكن يجب مواصلة محاولة تسجيل الدخول التلقائي عند بدء التشغيل.
بالإضافة إلى ذلك، يجب التأكّد من أنّه بإمكان المستخدمين تسجيل الدخول إلى لعبتك باستخدام حسابهم على "خدمات ألعاب Play" من خلال زر مخصّص يسهل العثور عليه.
تسجيل الدخول تلقائيًا
تتيح ميزة "تسجيل الدخول تلقائيًا" للمستخدمين تسجيل الدخول إلى لعبتك بدون أي مشاكل، لأنّها تتم تلقائيًا. إذا كانت لعبتك تطلب من المستخدم تسجيل الدخول وكان إعداد تسجيل الدخول التلقائي مفعّلاً (في تطبيق "ألعاب Play")، ستتلقّى بيانات اعتماد هوية المستخدم في "خدمات ألعاب Play" وسيظهر للمستخدم تجربة تسجيل الدخول باستخدام "خدمات ألعاب Play".
إنّ تسجيل الدخول التلقائي هو إعداد يمكن للمستخدمين التحكّم فيه. يمكن للمستخدمين اختيار تسجيل الدخول تلقائيًا إلى كل الألعاب أو أن يُطلب منهم تسجيل الدخول في كل مرة.
تسجيل الدخول يدويًا
إذا لم يسجّل المستخدم الدخول إلى اللعبة تلقائيًا، يمكنك أن تطلب منه تسجيل الدخول يدويًا. يمكن للمستخدمين تسجيل الدخول بنقرة واحدة من مربّع حوار يظهر في أعلى اللعبة.
السماح بالنوافذ المنبثقة في "خدمات ألعاب Play" للحصول على تجربة تسجيل دخول صحيحة
عند استخدام ميزة "الوصول بدون كلمة مرور"، يجب أن يعرف المستخدمون أنّهم مسجّلون الدخول. ويتم ذلك من خلال عرض تجربة تسجيل الدخول في PGS.
لعرض تجربة تسجيل الدخول، استخدِم الأسلوب
setViewForPopups()
في فئة GamesClient أثناء بدء تشغيل اللعبة. وهذا أمر مهم لتوفير
تجربة المستخدم الصحيحة.
نطاقات OAuth وPGS
تعتمد "خدمات ألعاب Play" على نظام OAuth للسماح للمستخدمين بمنح لعبتك إذن الوصول إلى حساباتهم. نطاقات OAuth هي أذونات يمكن أن تطلبها بصفتك مطوّرًا. في حال منحها، تسمح هذه الأذونات لتطبيقك بالاتصال بواجهات برمجة تطبيقات معيّنة نيابةً عن المستخدم، كما تمنح أنت إذن الوصول إلى أجزاء معيّنة من حسابه على Google.
تمتلك "خدمات ألعاب Play" نطاقًا فريدًا للألعاب (games-lite) وتعتمد على نطاق آخر
(drive.appdata) إذا كانت لعبتك تستخدم ميزة "الألعاب المحفوظة". توفّر ميزة "الألعاب المحفوظة"
إمكانية الوصول إلى حساب المستخدم على Google Drive، وهو المكان الذي يتم فيه تخزين بيانات
اللعبة.
يمكن أن تطلب لعبتك أي نطاق تحتاجه لتوفير تجربة رائعة للمستخدمين. يمكن للعبة طلب جميع النطاقات التي تحتاجها في حِزمة واحدة، ما يحدّ من عدد طلبات الوصول إلى حساب Google. ومع ذلك، فإنّ لهذا الأسلوب عيبًا كبيرًا. إذا طلبت أكثر من النطاقات الخاصة بميزة "الإعلانات الصورية"، لا يمكن أن تنجح ميزة "تسجيل الدخول تلقائيًا". إنّ تسجيل الدخول التلقائي هو أفضل طريقة لتسجيل دخول اللاعبين إلى لعبتك.
أفضل الممارسات هي استخدام طلبات النطاق المتزايد. يجب أن تطلب لعبتك أولاً نطاقات PGS فقط في الطلب الأول، ثم تطلب نطاقات أخرى بشكل منفصل في وقت أكثر ملاءمةً.
يتم منح إذن الوصول عبر OAuth باستخدام شاشة مختلفة لكل نطاق. يتيح ذلك للمستخدمين تحديد النطاقات التي يريدون منح إذن الوصول إليها بشكل دقيق. باستخدام تسجيل الدخول التلقائي باستخدام نطاقات PGS فقط، لن يحتاج المستخدمون إلى التفاعل مع أي طلبات OAuth، ما يقلل من الصعوبات المرتبطة بتسجيل الدخول.
إتاحة طُرق متعددة لتسجيل الدخول
توفّر "خدمات ألعاب Play" هوية ألعاب للاعبين على Android، ولكن ليس من الضروري أن تكون الهوية الوحيدة المرتبطة بالمستخدمين. يمكنك تسجيل دخول اللاعبين باستخدام "خدمات ألعاب Play" و رقم تعريف على شبكة اجتماعية ونظام التعريف الخاص بك داخل اللعبة في الوقت نفسه. يقدّم كل نظام قيمة فريدة لك وللّاعبين، ويمكن أن تعمل جميع الأنظمة معًا لتوفير تجربة رائعة للاعبين على Android.
استرداد هوية اللاعب وإثباتها بأمان لدمج الخلفية
يمكنك طلب رمز مصادقة الخادم لتتمكّن خوادمك من التواصل مباشرةً مع خوادم "خدمات ألعاب Play" من خلال واجهة برمجة التطبيقات REST API باستخدام الإذن الخاص باللاعب الذي سجّل الدخول. يتيح ذلك الوصول المباشر إلى رقم تعريف اللاعب وملفه الشخصي ومعلومات أخرى (مثل قائمة الأصدقاء، إذا كان ذلك مصرحًا به). إذا كنت تخزِّن أي أرقام تعريف للاعبين أو أرقام تعريف أصدقاء أو بيانات ذات صلة أخرى في الخلفية، يجب استخدام هذه المحاولة لإزالة إمكانية التلاعب بهذه الحقول من جانب الجهاز.
بالإضافة إلى ذلك، بالنسبة إلى بعض الألعاب واللاعبين الأقدم، قد لا يكون رقم تعريف اللاعب الذي تعرضه حزمة تطوير البرامج (SDK) لنظام التشغيل
Android هو رقم التعريف نفسه الذي يظهر للّاعبين الآخرين عند
عرض هذا اللاعب في اللعبة نفسها، ويُرجى العِلم أنّ هذا الأمر ينطبق بشكل خاص عند استخدام
قائمة الأصدقاء. ومع ذلك، فإنّ القيمة player_id التي يتم عرضها ضمن واجهة برمجة التطبيقات REST API
تكون متسقة دائمًا، وهي دائمًا المعرّف الذي يظهر للّاعبين الآخرين.
لمزيد من المعلومات، يُرجى الاطّلاع على الوصول بلا إنترنت ومستندات واجهة برمجة التطبيقات REST.
تنفيذ العميل
للتعرّف على كيفية توفير ميزة تسجيل الدخول على أجهزة Android، يُرجى الاطّلاع على مقالة تسجيل الدخول في ألعاب Android.