بررسی اجمالی مهاجرت

ارسال بازخورد

Google Play Games Services، games v1 SDK متکی به Google Sign-In برای Android است که منسوخ شده است و در سال 2025 از سرویس Google Play Auth SDK ( com.google.android.gms:play-services-auth ) حذف خواهد شد. بازی های جدید برنامه‌ها می‌توانند تا سال 2025 از بازی‌های نسخه 1 استفاده کنند. حذف ورود به سیستم Google مشکلات وابستگی را برای برنامه‌های بازی‌های موجود معرفی می‌کند. انتقال برنامه‌های بازی‌های موجود از بازی‌های v1 SDK به بازی‌های v2 SDK مشکلات وابستگی را که با حذف ورود به سیستم Google معرفی شده است، حل می‌کند.

این سند به شما کمک می کند تا تعاملات بین برنامه بازی و SDK های مختلف را درک کنید. این سند همچنین ویژگی‌های برنامه را با ویژگی‌های بازی‌های Play Games Services v1 و Games v2 SDK مقایسه می‌کند.

تعاملات SDK

نمودارها تعامل بین یک برنامه بازی در Android، Google Mobile Services (GMS) Core، Play Games Services و سرور بازی های شخص ثالث (3P) را نشان می دهد. این نشان می دهد که چگونه برنامه از خدمات Google برای احراز هویت و ویژگی های بازی استفاده می کند، در حالی که با یک سیستم شخص ثالث جداگانه نیز تعامل دارد.

بازی های نسخه 2 (جاری)

تعامل بین یک برنامه بازی در Android، GMS Core، خدمات بازی‌های Play و سرور بازی شخص ثالث (3P). (برای بزرگنمایی کلیک کنید).

بازی‌های نسخه 1 (میراث)

تعامل بین یک برنامه بازی در Android، GMS Core، خدمات بازی‌های Play، و سرور بازی‌های شخص ثالث (3P). (برای بزرگنمایی کلیک کنید).

در زیر مروری کوتاه بر کامپوننت ها و SDK ها آورده شده است:

• نرم افزار بازی.
  • این نشان دهنده برنامه بازی کاربر است که روی یک دستگاه مجهز به اندروید اجرا می شود.
  • این شامل دو جزء اصلی است:
    • بازی‌های نسخه ۱ یا بازی‌های نسخه ۲ SDK. SDK سمت سرویس گیرنده که مسئول تعامل با خدمات بازی‌های Play است.
    • Auth SDK. Google Play Services Auth SDK مسئول رسیدگی به جریان‌های احراز هویت و مجوز کاربر در بازی‌های نسخه ۱ است.
  • هر دو SDK با استفاده از AIDL (زبان تعریف رابط اندروید) ارتباط برقرار می کنند که نشان دهنده یک الگوی ارتباطی بین فرآیندها یا خدمات مختلف است.
• GMS Core به خدمات Google Play نیز گفته می شود.
  • این لایه اختصاصی گوگل در اندروید است.
  • برنامه بازی از دو ماژول GMS Core استفاده می کند:
    • ماژول بازی ویژگی های خاص بازی مانند تابلوهای امتیازات، دستاوردها و مدیریت وضعیت بازی را ارائه می دهد.
    • ماژول احراز هویت عملیات احراز هویت و مجوز کاربر را مدیریت می کند.
  • بازی‌ها و Auth SDK در برنامه بازی‌ها با ماژول‌های مربوطه با استفاده از رابط‌های AIDL ارتباط برقرار می‌کنند که نشان‌دهنده ارتباط بین فرآیندی (IPC) است.

• دروازه خدمات بازی های Play.
  • یک دروازه منطقی که ارتباط بین GMS Core و سرور Play Games Services را واسطه می کند.
  • درخواست های API، تبدیل داده ها و احراز هویت برای ارتباط سرور را مدیریت می کند.
• سرور خدمات بازی های Play.
  • نمایانگر خدمات باطنی «خدمات بازی‌های Play» است که مسئول ذخیره داده‌های بازی، مدیریت حساب‌های کاربر، و تسهیل ویژگی‌های چندنفره هستند.
• دروازه بازی های شخص ثالث.
  • اگر برنامه بازی شما به عنوان یک برنامه شخص ثالث (3P) واجد شرایط باشد، کتابخانه سرویس گیرنده از طریق سرورهای بازی های شخص ثالث با سرورهای خدمات بازی های Play ارتباط برقرار می کند.
  • به این معنی است که برنامه همچنین می تواند با ارائه دهنده خدمات دیگری احراز هویت کند.
• سرور بازی های شخص ثالث.
  • نشان دهنده یک سرور خارجی اختیاری است که برنامه بازی می تواند با آن تعامل داشته باشد، احتمالاً برای ویژگی های سفارشی یا مدیریت داده.
  • ارتباط با برنامه از طریق دروازه بازی های شخص ثالث انجام می شود.

مقایسه ویژگی ها

این جدول یک مقایسه ویژگی بین بازی‌های v1 و games v2 SDK به شما ارائه می‌دهد:

ویژگی	بازی ها v1 SDK	بازی ها v2 SDK
احراز هویت	ادغام با play-services-auth مورد نیاز است.	ساده و کارآمد؛ بدون play-services-auth مجوز.
مجوز	کد اضافی برای موفقیت، شکست و تلاش های مجدد.	توسط SDK مدیریت می شود
رمز دسترسی به سرور	می‌تواند دامنه‌های OAuth 2.0 اضافی را با GoogleSigninClient درخواست کند. کد اضافی برای رسیدگی به خطا در هنگام ورود به سیستم.	دامنه های اضافی مجاز نیست. کد اضافی با شکست موفقیت آمیز پاسخ تماس با serverAuthcode.
فرآیند ورود به سیستم	از GoogleSigninClient استفاده می کند. کد اضافی برای مدیریت کد دیگ بخار برای ورود خودکار و رسیدگی به خطا.	از GamesSignInClient استفاده می کند. SDK کد دیگ بخار، ورود خودکار به سیستم و مدیریت خطا را کنترل می کند.
پاپ آپ خوش آمدید	کد اضافی مورد نیاز است توسعه دهندگان می توانند مکان و زمان بندی آن را کنترل کنند.	بدون نیاز به کد اضافی رابط کاربری ثابت در همه بازی های پیکربندی شده PGS V2. .
وابستگی ها	به play-services-auth نیاز دارد.	بدون وابستگی جداگانه به play-services-auth .
خروج از سیستم	از GoogleSignInClient.signOut استفاده می کند.	API خروج از سیستم پشتیبانی نمی شود.
چندین حساب خدمات بازی‌های Play و تنظیمات هر بازی	انتخاب و مدیریت حساب در دسترس نیست.	برای هر بازی، می‌توانید حساب خدمات بازی‌های Play خود را مدیریت کنید. این به شما امکان می دهد انتخاب کنید که هر بازی از کدام حساب استفاده می کند.