تعتمد حزمة تطوير البرامج (SDK) للإصدار 1 من "خدمات ألعاب 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 للمصادقة وميزات الألعاب، وكيف يتفاعل أيضًا مع نظام منفصل تابع لجهة خارجية.
games v2 (الحالية)
الإصدار 1 من الألعاب (قديم)
في ما يلي نظرة عامة موجزة على المكوّنات وحِزم تطوير البرامج (SDK):
- تطبيق الألعاب
- يمثّل هذا الحقل تطبيق الألعاب الخاص بالمستخدم الذي يعمل على جهاز Android.
- يحتوي على مكوّنَين أساسيَّين:
- الإصدار 1 أو الإصدار 2 من حزمة تطوير البرامج (SDK) للألعاب حزمة تطوير البرامج (SDK) من جهة العميل المسؤولة عن التفاعل مع "خدمات ألعاب Play"
- حزمة تطوير البرامج (SDK) للمصادقة: تتولّى حزمة تطوير البرامج (SDK) الخاصة بالمصادقة ضِمن "خدمات Google Play" مهمة معالجة عمليات المصادقة والتفويض في الإصدار 1 من "ألعاب Google".
- تتواصل حِزم تطوير البرامج (SDK) باستخدام لغة تعريف واجهة Android (AIDL)، ما يشير إلى نمط تواصل بين عمليات أو خدمات مختلفة.
- يُطلق على "خدمات Google للأجهزة الجوّالة" الأساسية أيضًا اسم "خدمات Google Play".
- هذه هي الطبقة الخاصة بشركة Google على Android.
- يستخدم تطبيق الألعاب وحدتَين من "خدمات Google للأجهزة الجوّالة" الأساسية:
- يوفّر وحدة الألعاب ميزات خاصة بالألعاب، مثل لوحات الصدارة والإنجازات وإدارة حالة اللعبة.
- وحدة المصادقة: تعالج عمليات مصادقة المستخدمين ومنحهم الأذونات.
- تتواصل حِزم تطوير البرامج (SDK) الخاصة بالألعاب والمصادقة في تطبيق الألعاب مع الوحدات النمطية المقابلة باستخدام واجهات AIDL، ما يشير إلى التواصل بين العمليات (IPC).
- بوابة "خدمات ألعاب Play"
- بوابة منطقية تتوسّط عملية التواصل بين "خدمات Google الأساسية" وخادم "خدمات ألعاب Play"
- يتعامل مع طلبات واجهة برمجة التطبيقات وتحويل البيانات والمصادقة على مستوى عملية التواصل مع الخادم.
- خادم "خدمات ألعاب Play":
- تمثّل هذه الفئة خدمات الخلفية في "خدمات ألعاب Play" المسؤولة عن تخزين بيانات الألعاب وإدارة حسابات المستخدمين وتسهيل ميزات اللعب المتعدد.
- بوابة ألعاب تابعة لجهات خارجية:
- إذا كان تطبيق الألعاب مؤهلاً كأحد تطبيقات الجهات الخارجية، يتواصل برنامج المكتبة مع خوادم "خدمات ألعاب Play" من خلال خوادم ألعاب الجهات الخارجية.
- يشير ذلك إلى أنّ التطبيق يمكنه أيضًا المصادقة باستخدام مقدّم خدمة مختلف.
- خادم ألعاب تابع لجهة خارجية:
- يمثّل هذا العنصر خادمًا خارجيًا اختياريًا يمكن لتطبيق الألعاب التفاعل معه، ومن المحتمل أن يكون ذلك لتوفير ميزات مخصّصة أو إدارة البيانات.
- يتم التواصل مع التطبيق من خلال بوابة الألعاب التابعة لجهات خارجية.
مقارنة الميزات
يوضّح الجدول التالي مقارنة بين ميزات الإصدار v1 والإصدار v2 من حزمة تطوير البرامج (SDK) للألعاب:
الميزة |
الإصدار 1 من حزمة تطوير البرامج (SDK) للألعاب |
حزمة تطوير البرامج (SDK) لإصدار 2 من "ألعاب Google 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" على الأجهزة الجوّالة. |