نظرة عامة على نقل البيانات

تعتمد حزمة تطوير البرامج (SDK) للإصدار الأول من "خدمات ألعاب Google Play" على خدمة "تسجيل الدخول باستخدام حساب Google" على Android، وهي خدمة تم إيقافها نهائيًا وستتم إزالتها من حزمة تطوير البرامج (SDK) الخاصة بخدمة المصادقة في "خدمات Google Play" (com.google.android.gms:play-services-auth) في عام 2025. يمكن لتطبيقات الألعاب الجديدة استخدام الإصدار 1 من حزمة تطوير البرامج (SDK) للألعاب حتى عام 2025. تؤدي إزالة خدمة "تسجيل الدخول باستخدام حساب Google" إلى حدوث مشاكل في التبعية بالنسبة إلى تطبيقات الألعاب الحالية. يؤدي نقل تطبيقات الألعاب الحالية من الإصدار 1 من حزمة تطوير البرامج (SDK) الخاصة بـ "خدمات ألعاب Play" إلى الإصدار 2 من حزمة تطوير البرامج (SDK) الخاصة بـ "خدمات ألعاب Play" إلى حلّ المشاكل المتعلّقة بالاعتمادية التي نتجت عن إزالة تسجيل الدخول باستخدام حساب Google.

يساعدك هذا المستند في فهم التفاعلات بين تطبيق الألعاب ومجموعات SDK المختلفة. يتضمّن هذا المستند أيضًا مقارنة بين ميزات التطبيق وميزات الإصدار 1 والإصدار 2 من حزمة تطوير البرامج (SDK) الخاصة بـ "خدمات ألعاب Play".

تفاعلات حزمة تطوير البرامج (SDK)

توضّح المخططات التفاعلات بين تطبيق ألعاب على Android وخدمات Google للأجهزة الجوّالة (GMS) الأساسية و"خدمات ألعاب Play" وخادم ألعاب تابع لجهة خارجية. ويوضّح كيف يستخدم التطبيق خدمات Google للمصادقة وميزات الألعاب، وكيف يتفاعل أيضًا مع نظام منفصل تابع لجهة خارجية.

في ما يلي نظرة عامة موجزة على المكوّنات وحِزم تطوير البرامج (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":
  • بوابة منطقية تتوسّط عملية التواصل بين GMS Core وخادم "خدمات ألعاب Play".
  • تتعامل مع طلبات واجهة برمجة التطبيقات وتحويل البيانات والمصادقة على مستوى عملية التواصل مع الخادم.
• خادم "خدمات ألعاب Play":
  • تمثّل هذه الفئة خدمات الخلفية في "خدمات ألعاب Play" المسؤولة عن تخزين بيانات الألعاب وإدارة حسابات المستخدمين وتسهيل ميزات اللعب المتعدد.
• بوابة ألعاب تابعة لجهات خارجية:
  • إذا كان تطبيق الألعاب مؤهلاً كأحد تطبيقات الجهات الخارجية، يتواصل برنامج مكتبة العميل مع خوادم "خدمات ألعاب Play" من خلال خوادم ألعاب الجهات الخارجية.
  • يشير ذلك إلى أنّ التطبيق يمكنه أيضًا المصادقة باستخدام مقدّم خدمة مختلف.
• خادم ألعاب تابع لجهة خارجية:
  • يمثّل هذا النوع خادمًا خارجيًا اختياريًا يمكن لتطبيق الألعاب التفاعل معه، ومن المحتمل أن يكون ذلك لتوفير ميزات مخصّصة أو إدارة البيانات.
  • يتم التواصل مع التطبيق من خلال بوابة الألعاب التابعة لجهات خارجية.

مقارنة الميزات

يوضّح الجدول التالي مقارنة بين ميزات حزمتَي تطوير البرامج (SDK) للإصدار 1 والإصدار 2 من "خدمات ألعاب Play":

الميزة	حزمة تطوير البرامج (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" على الأجهزة الجوّالة.