تعتمد حزمة تطوير البرامج (SDK) للإصدار الأول من "خدمات ألعاب Google Play" على خدمة "تسجيل الدخول باستخدام Google" على Android، وهي خدمة تم إيقافها نهائيًا وستتم إزالتها من حزمة تطوير البرامج (SDK) الخاصة بخدمة المصادقة في "خدمات Google Play" (com.google.android.gms:play-services-auth) في عام 2025.
يمكن لتطبيقات الألعاب الجديدة استخدام الإصدار 1 من حزمة تطوير البرامج (SDK) للألعاب حتى عام 2025. تؤدي إزالة خدمة "تسجيل الدخول باستخدام Google" إلى حدوث مشاكل في التبعية لتطبيقات الألعاب الحالية. يؤدي نقل تطبيقات الألعاب الحالية من الإصدار v1 من حزمة تطوير البرامج (SDK) للألعاب إلى الإصدار v2 من حزمة تطوير البرامج (SDK) للألعاب إلى حلّ المشاكل المتعلّقة بالاعتمادية التي نتجت عن إزالة Google Sign-In.
يساعدك هذا المستند في فهم التفاعلات بين تطبيق الألعاب ومجموعات SDK المختلفة. يتضمّن هذا المستند أيضًا مقارنة بين ميزات التطبيق وميزات الإصدار 1 والإصدار 2 من حزمة تطوير البرامج (SDK) الخاصة بـ "خدمات ألعاب Play".
تفاعلات حزمة تطوير البرامج (SDK)
توضّح المخططات التفاعلات بين تطبيق ألعاب على Android وخدمات Google للأجهزة الجوّالة (GMS) الأساسية و"خدمات ألعاب Play" وخادم ألعاب تابع لجهة خارجية. ويوضّح كيف يستخدم التطبيق خدمات Google للمصادقة وميزات الألعاب، وكيف يتفاعل أيضًا مع نظام منفصل تابع لجهة خارجية.
الإصدار الثاني من "خدمات ألعاب Play" (الحالي)
الإصدار الثاني من "خدمات ألعاب Play" (الحالي)
في ما يلي نظرة عامة موجزة على المكوّنات وحِزم تطوير البرامج (SDK):
- تطبيق الألعاب
- يمثّل هذا المعرّف تطبيق الألعاب الخاص بالمستخدم الذي يعمل على جهاز Android.
- يحتوي على مكوّنَين أساسيَّين:
- الإصدار 1 أو الإصدار 2 من حزمة تطوير البرامج (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" من خلال خوادم ألعاب الجهات الخارجية.
- يشير ذلك إلى أنّ التطبيق يمكنه أيضًا المصادقة باستخدام مقدّم خدمة مختلف.
- خادم ألعاب تابع لجهة خارجية:
- يمثّل هذا النوع خادمًا خارجيًا اختياريًا يمكن لتطبيق الألعاب التفاعل معه، ومن المحتمل أن يكون ذلك لتوفير ميزات مخصّصة أو إدارة البيانات.
- يتم التواصل مع التطبيق من خلال بوابة الألعاب التابعة لجهات خارجية.
مقارنة الميزات
يوضّح الجدول التالي مقارنة بين ميزات الإصدار 1 والإصدار 2 من حِزم تطوير البرامج (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" على الأجهزة الجوّالة. |