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

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

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

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

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

في ما يلي نظرة عامة موجزة على المكوّنات وحِزم تطوير البرامج (SDK):

• تطبيق الألعاب:
  • يمثّل هذا التطبيق تطبيق الألعاب الخاص بالمستخدم الذي يتم تشغيله على جهاز يعمل بنظام التشغيل Android.
  • يحتوي على مكوّنين أساسيين:
    • الإصدار الأول أو الثاني من حزمة SDK الخاصة بـ "خدمات ألعاب Play": حزمة SDK من جهة العميل المسؤولة عن التفاعل مع "خدمات ألعاب Play"
    • حزمة تطوير البرامج (SDK) للمصادقة: تتولّى حزمة تطوير البرامج (SDK) الخاصة بالمصادقة ضِمن "خدمات Google Play" مهمة معالجة عمليات المصادقة والتفويض في الإصدار 1 من "خدمات ألعاب Google".
  • تتواصل حِزمتا SDK باستخدام AIDL (لغة تعريف واجهة نظام Android)، ما يشير إلى نمط تواصل بين عمليات أو خدمات مختلفة.
• GMS Core، المعروفة أيضًا باسم "خدمات Google Play":
  • هذه هي الطبقة المملوكة لشركة Google على Android.
  • يستخدم تطبيق الألعاب وحدتَين من GMS Core:
    • وحدة الألعاب: توفّر ميزات خاصة بالألعاب، مثل لوحات الصدارة والإنجازات وإدارة حالة اللعبة.
    • وحدة المصادقة: تتعامل مع عمليات مصادقة المستخدم وتفويضه.
  • تتواصل حِزمتا SDK للألعاب والمصادقة في تطبيق الألعاب مع الوحدتَين المقابلتَين باستخدام واجهات AIDL، ما يشير إلى التواصل بين العمليات (IPC).

• بوابة "خدمات ألعاب Play":
  • بوابة منطقية تتوسّط عملية التواصل بين GMS Core وخادم "خدمات ألعاب Play"
  • تتعامل مع طلبات واجهة برمجة التطبيقات وتحويل البيانات والمصادقة على مستوى عملية التواصل مع الخادم.
• خادم "خدمات ألعاب Play":
  • يمثّل هذا الخادم الخدمات الخلفية لـ "خدمات ألعاب Play" المسؤولة عن تخزين بيانات الألعاب وإدارة حسابات المستخدمين وتسهيل ميزات الألعاب المتعدّدة اللاعبين.
• بوابة ألعاب تابعة لجهة خارجية:
  • إذا كان تطبيق الألعاب مؤهلاً ليكون تطبيقًا تابعًا لجهة خارجية (3P)، تتواصل مكتبة العميل مع خوادم "خدمات ألعاب Play" من خلال خوادم الألعاب التابعة لجهة خارجية.
  • يشير ذلك إلى أنّه يمكن للتطبيق أيضًا المصادقة باستخدام مقدّم خدمة مختلف.
• خادم ألعاب تابع لجهة خارجية:
  • يمثّل هذا الخادم خادمًا خارجيًا اختياريًا يمكن لتطبيق الألعاب التفاعل معه، ومن المحتمل أن يكون ذلك للميزات المخصّصة أو إدارة البيانات.
  • يتم التواصل مع التطبيق من خلال بوابة الألعاب التابعة لجهة خارجية.

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

يقدّم لك هذا الجدول مقارنة بين ميزات الإصدارين الأول والثاني من حزمة SDK الخاصة بـ "خدمات ألعاب 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 مع رمز النص النموذجي والمصادقة التلقائية والتعامل مع الأخطاء.
النافذة المنبثقة للترحيب	يجب إضافة رمز إضافي. يمكن للمطوّرين التحكّم في موضعها وتوقيتها.	لا يلزم إضافة أي رمز إضافي. واجهة مستخدم متّسقة في جميع الألعاب التي تم إعدادها باستخدام الإصدار الثاني من حزمة SDK الخاصة بـ "خدمات ألعاب Play"
التبعيات	يجب استخدام play-services-auth.	تتولّى وحدة الألعاب عمليات التفويض والمصادقة. لست بحاجة إلى إضافة أي تبعيات إضافية.
تسجيل الخروج	يتم استخدام GoogleSignInClient.signOut.	واجهة برمجة تطبيقات تسجيل الخروج غير متاحة.
حسابات متعدّدة على "خدمات ألعاب Play" وإعدادات لكل لعبة	يمكن إدارة الحسابات داخل اللعبة.	يمكن للمستخدمين تغيير الملف الشخصي على "خدمات ألعاب Play" في إعدادات الجهاز الجوّال. لمزيد من المعلومات، يُرجى الاطّلاع على كيفية تبديل الملفات الشخصية على "ألعاب Play" على الأجهزة الجوّالة.