تعتمد حزمة تطوير البرامج (SDK) للإصدار الأول من "خدمات ألعاب Google Play" على خدمة "تسجيل الدخول باستخدام Google" على Android التي تم إيقافها نهائيًا وسيتم إزالتها من حزمة تطوير البرامج (SDK) الخاصة بخدمة المصادقة في "خدمات Google Play" (com.google.android.gms:play-services-auth) في عام 2025.
يمكن لتطبيقات الألعاب الجديدة استخدام الإصدار 1 من حزمة تطوير البرامج (SDK) للألعاب حتى عام 2025. تؤدي إزالة خدمة "تسجيل الدخول باستخدام Google" إلى حدوث مشاكل في التبعية بالنسبة إلى تطبيقات الألعاب الحالية. يؤدي نقل التطبيقات الحالية للألعاب من الإصدار 1 من حزمة تطوير البرامج (SDK) للألعاب إلى الإصدار 2 من حزمة تطوير البرامج (SDK) للألعاب إلى حلّ مشاكل التبعية التي نتجت عن إزالة خدمة "تسجيل الدخول باستخدام Google".
يساعدك هذا المستند في فهم التفاعلات بين تطبيق الألعاب ومجموعات SDK المختلفة. يتضمّن هذا المستند أيضًا مقارنة بين ميزات التطبيق وميزات الإصدار v1 والإصدار v2 من حزمة تطوير البرامج (SDK) الخاصة بـ "خدمات ألعاب Play".
تفاعلات حزمة تطوير البرامج (SDK)
توضّح المخططات التفاعلات بين تطبيق ألعاب على Android وخدمات Google للأجهزة الجوّالة (GMS) الأساسية و"خدمات ألعاب Play" وخادم ألعاب تابع لجهة خارجية. وتوضّح كيف يستخدم التطبيق خدمات Google للمصادقة وميزات الألعاب، وكيف يتفاعل أيضًا مع نظام منفصل تابع لجهة خارجية.
الإصدار الثاني من "خدمات ألعاب Play" (الحالي)
الإصدار الثاني من "خدمات ألعاب Play" (الحالي)
في ما يلي نظرة عامة موجزة على المكوّنات وحِزم تطوير البرامج (SDK):
- تطبيق الألعاب
- يمثّل هذا المعرّف تطبيق الألعاب الخاص بالمستخدم الذي يعمل على جهاز Android.
- يحتوي على مكوّنَين أساسيَّين:
- الإصدار الأول أو الثاني من حزمة تطوير البرامج (SDK) الخاصة بـ "خدمات ألعاب Play" حزمة تطوير البرامج (SDK) من جهة العميل المسؤولة عن التفاعل مع "خدمات ألعاب Play"
- حزمة تطوير البرامج (SDK) للمصادقة: تتولّى حزمة تطوير البرامج (SDK) الخاصة بالمصادقة ضِمن "خدمات Google Play" مهمة معالجة عمليات المصادقة والتفويض في الإصدار 1 من "خدمات ألعاب Google".
- تتواصل حِزمتَا SDK باستخدام لغة تعريف واجهة Android (AIDL)، ما يشير إلى نمط تواصل بين عمليات أو خدمات مختلفة.
- يُطلق على "خدمات Google للأجهزة الجوّالة" الأساسية أيضًا اسم "خدمات Google Play".
- هذه هي الطبقة الخاصة بشركة Google على Android.
- يستخدم تطبيق الألعاب وحدتَين من "خدمات Google للأجهزة الجوّالة" الأساسية:
- يوفّر وحدة الألعاب ميزات خاصة بالألعاب، مثل قوائم الصدارة والإنجازات وإدارة حالة اللعبة.
- وحدة المصادقة: تعالج عمليات مصادقة المستخدمين ومنحهم الأذونات.
- تتواصل حِزم تطوير البرامج (SDK) الخاصة بالألعاب والمصادقة في تطبيق الألعاب مع الوحدات النمطية المعنية باستخدام واجهات AIDL، ما يشير إلى التواصل بين العمليات (IPC).
- بوابة "خدمات ألعاب Play"
- بوابة منطقية تتوسّط عملية التواصل بين GMS Core وخادم "خدمات ألعاب Play"
- تتعامل مع طلبات واجهة برمجة التطبيقات وتحويل البيانات والمصادقة على مستوى عملية التواصل مع الخادم.
- خادم "خدمات ألعاب Play":
- تمثّل هذه الفئة خدمات الخلفية في "خدمات ألعاب Play" المسؤولة عن تخزين بيانات الألعاب وإدارة حسابات المستخدمين وتسهيل ميزات اللعب المتعدد.
- بوابة ألعاب تابعة لجهات خارجية:
- إذا كان تطبيق الألعاب مؤهلاً كأحد تطبيقات الجهات الخارجية، يتواصل برنامج المكتبة مع خوادم "خدمات ألعاب Play" من خلال خوادم الألعاب التابعة للجهات الخارجية.
- يشير ذلك إلى أنّ التطبيق يمكنه أيضًا المصادقة باستخدام مقدّم خدمة مختلف.
- خادم ألعاب تابع لجهة خارجية:
- يمثّل هذا العنصر خادمًا خارجيًا اختياريًا يمكن لتطبيق الألعاب التفاعل معه، ومن المحتمل أن يكون ذلك لتوفير ميزات مخصّصة أو إدارة البيانات.
- يتم التواصل مع التطبيق من خلال بوابة الألعاب التابعة لجهات خارجية.
مقارنة الميزات
يوضّح الجدول التالي مقارنة بين ميزات الإصدار v1 والإصدار v2 من حزمة تطوير البرامج (SDK) للألعاب:
الميزة |
حزمة تطوير البرامج (SDK) للإصدار الأول من "خدمات ألعاب Play" |
حزمة تطوير البرامج (SDK) لإصدار الثاني من "خدمات ألعاب Play" |
|---|---|---|
المصادقة |
يجب الدمج مع play-services-auth. |
مبسّطة وسلسة، ولا تتطلّب play-services-auth
أي إجراءات إضافية. |
التفويض |
رمز إضافي للنجاحات والأخطاء وعمليات إعادة المحاولة |
تتم إدارتها من خلال حزمة تطوير البرامج (SDK) |
رمز الدخول المميز للخادم |
يمكن طلب نطاقات إضافية في OAuth 2.0 باستخدام GoogleSigninClient.رمز إضافي للتعامل مع الأخطاء أثناء المصادقة. |
يمكنه طلب ثلاثة نطاقات أساسية لهوية OAuth 2.0 باستخدام GamesSignInClient عند طلب الوصول من جهة الخادم إلى واجهات برمجة التطبيقات على الويب في "خدمات ألعاب Play".لمزيد من المعلومات، يُرجى الاطّلاع على الوصول إلى "خدمات ألعاب Play" من جهة الخادم و استرداد رموز المصادقة من جهة الخادم. |
عملية تسجيل الدخول |
يستخدم GoogleSigninClient.رمز إضافي للتعامل مع الرمز النموذجي للمصادقة التلقائية والتعامل مع الأخطاء. |
يستخدم GamesSignInClient.تتعامل حزمة تطوير البرامج (SDK) مع الرموز النموذجية والمصادقة التلقائية ومعالجة الأخطاء. |
النافذة المنبثقة "مرحبًا" |
يجب إدخال رمز إضافي. يمكن للمطوّرين التحكّم في موضعها وتوقيتها. |
لا يلزم استخدام أي رمز إضافي. واجهة مستخدم متسقة في جميع الألعاب التي تم إعدادها باستخدام الإصدار v2 من حزمة SDK للألعاب |
التبعيات |
يتطلّب play-services-auth |
تتولّى وحدة "الألعاب" عملية منح الأذونات والمصادقة. لست بحاجة إلى إضافة أي عناصر تابعة إضافية. |
| تسجيل الخروج |
يستخدم GoogleSignInClient.signOut. |
لا تتوافق واجهة برمجة التطبيقات الخاصة بتسجيل الخروج. |
حسابات متعدّدة على "خدمات ألعاب Play" وإعدادات خاصة بكل لعبة |
يمكن إدارة الحساب داخل لعبتك. |
يمكن للمستخدمين تغيير ملفهم الشخصي في "خدمات ألعاب Play" من إعدادات الجهاز الجوّال. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة كيفية التبديل بين الملفات الشخصية في "ألعاب Play" على الأجهزة الجوّالة. |