يمكنك استخدام "خدمات ألعاب Google Play" لتسجيل دخول اللاعبين إلى لعبة Android
تم إنشاؤها على Firebase وUnity. لاستخدام ميزة تسجيل الدخول إلى "خدمات ألعاب Google Play" من خلال Firebase، عليك أولاً تسجيل دخول اللاعب إلى "ألعاب Google Play" وطلب رمز مصادقة OAuth 2.0 عند إجراء ذلك. بعد ذلك، عليك تمرير رمز المصادقة إلى PlayGamesAuthProvider لإنشاء بيانات اعتماد Firebase التي يمكنك استخدامها للمصادقة من خلال Firebase.
قبل البدء
إعداد مشروع Unity
أضِف ملف إعداد Firebase وحزمة تطوير البرامج (SDK) لـ Firebase Unity إلى مشروع Unity الخاص بك كما هو موضّح في إضافة Firebase إلى مشروع Unity. اتّبِع التعليمات الخاصة بأجهزة Android.
تأكَّد من استيراد
FirebaseAuth.unitypackage.في Unity Editor، ضمن إعدادات الإصدار > إعدادات المشغّل > إعدادات أخرى، اضبط اسم حزمة Android للعبتك.
بعد ذلك، ضمن إعدادات الإصدار > إعدادات المشغّل > إعدادات النشر، اختَر أو أنشئ ملف تخزين مفاتيح ومفتاحًا، وسيتم استخدامهما لتوقيع حزمة Android. يجب توقيع حزمة APK لكي يعمل تسجيل الدخول إلى "ألعاب Google Play"، وينطبق هذا الشرط ليس فقط على النشر، ولكن أيضًا أثناء تطوير لعبتك.
إعداد مشروع Firebase
في وحدة تحكّم Firebase، انتقِل إلى مشروع Firebase الذي سجّلت فيه مشروع Unity.
حدِّد الملف المرجعي لشهادة SHA-1 الخاصة بلعبتك.
في وحدة تحكّم Firebase، انتقِل إلى
الإعدادات > علامة التبويب "الإعدادات العامة".انتقِل للأسفل إلى بطاقة تطبيقاتك، واختَر تطبيق Android، ثم أضِف الملف المرجعي لشهادة SHA-1 في حقل الملفات المرجعية لشهادة SHA.
يمكنك الحصول على الملف المرجعي لشهادة SHA-1 لمفتاحك باستخدام الأمر
keytool:keytool -exportcert -list -v \ -alias YOUR-KEY-NAME -keystore PATH-TO-KEYSTOREبدلاً من ذلك، يمكنك الحصول على تجزئة SHA لشهادة التوقيع باستخدام الأمر gradle
signingReport:gradlew signingReport
يُرجى الاطّلاع على مصادقة العميل لمعرفة التفاصيل حول كيفية الحصول على الملف المرجعي لشهادة SHA الخاصة بتطبيقك.
يجب توقيع حزمة APK باستخدام هذا المفتاح، بما في ذلك أثناء عملية التطوير.
فعِّل Google Play Games كموفّر لتسجيل الدخول:
في وحدة تحكّم Firebase، انتقِل إلى الأمان > المصادقة.
أنشِئ معرِّف العميل وسر العميل لخادم الويب الخاص بمشروعك واحصل عليهما:
في علامة التبويب طريقة تسجيل الدخول، فعِّل مزوّد خدمة تسجيل الدخول من Google.
انسخ معرِّف العميل وسرّه الخاصَّين بخادم الويب من مزوّد خدمة تسجيل الدخول من Google.
في علامة التبويب طريقة تسجيل الدخول، فعِّل موفّر خدمة تسجيل الدخول Play Games، وحدِّد معرّف العميل والرمز السري للعميل الخاصَين بخادم الويب لمشروعك، واللذين حصلت عليهما في الخطوة الأخيرة.
ضبط Play Games services باستخدام معلومات تطبيق Firebase
في وحدة تحكّم Google Play، افتح تطبيق Google Play أو أنشِئ تطبيقًا.
في قسم النمو، انقر على Play Games services > الإعداد والإدارة > الإعدادات.
انقر على نعم، تستخدم لعبتي واجهات Google APIs حاليًا، واختَر مشروع Firebase من القائمة، ثم انقر على استخدام.
في صفحة إعدادات Play Games services، انقر على إضافة بيانات الاعتماد.
- اختَر نوع خادم اللعبة.
- في حقل عميل OAuth، اختَر معرّف عميل الويب الخاص بمشروعك. تأكَّد من أنّ هذا هو معرّف العميل نفسه الذي حدّدته عند تفعيل تسجيل الدخول إلى Play Games.
- احفظ التغييرات.
في صفحة إعدادات Play Games services، انقر على إضافة بيانات الاعتماد مرة أخرى.
- اختَر نوع Android.
- في حقل عميل OAuth، اختَر معرّف عميل Android لمشروعك. (إذا لم يظهر لك معرِّف عميل Android، تأكَّد من ضبط بصمة إصبع SHA-1 للعبتك في وحدة تحكّم Firebase).
- احفظ التغييرات.
في صفحات الأحداث والإنجازات وقوائم الصدارة، أنشئ أي Play Games موارد تريد استخدامها مع لعبتك (إذا كنت لا تريد استخدام أي منها على الفور، يمكنك إنشاء إدخال عنصر نائب). بعد ذلك، في أيّ من صفحات الأحداث أو الإنجازات أو قوائم الصدارة، انقر على الحصول على الموارد وانسخ مقتطف موارد Android في مكان مناسب. ستحتاج إلى المقتطف لإعداد المكوّن الإضافي Google Play Games services.
يبدو مقتطف الموارد مثل المثال التالي:
<?xml version="1.0" encoding="utf-8"?> <!-- Google Play game services IDs. Save this file as res/values/games-ids.xml in your project. --> <resources> <!-- app_id --> <string name="app_id" translatable="false">123456789000</string> <!-- package_name --> <string name="package_name" translatable="false">com.example.game</string> <!-- event Wiped Raid --> <string name="event_wiped_raid" translatable="false">CgkIpKjv1a4PEAIYBA</string> </resources>في صفحة المختبِرون، أضِف عناوين البريد الإلكتروني لأي مستخدمين يحتاجون إلى تسجيل الدخول إلى لعبتك قبل إصدارها على Play Store.
دمج ميزة تسجيل الدخول إلى "ألعاب Google Play" في لعبتك
نزِّل أحدث إصدار من المكوّن الإضافي لـ "ألعاب Play" في Unity واستخرِجه.
استورِد حزمة Unity الخاصة بالمكوّن الإضافي إلى مشروع Unity. يمكنك العثور على حزمة Unity في دليل
current-buildضمن أرشيف الإصدار.إعداد المكوّن الإضافي لـ "ألعاب Google Play":
- انقر على Window (النافذة) > Google Play Games (ألعاب Google Play) > Setup (الإعداد) > Android Setup (إعداد Android) لفتح شاشة Android Configuration (إعدادات Android).
- ألصِق مقتطف موارد Android الذي حصلت عليه من Play Console في حقل تعريف الموارد.
- الصِق معرّف عميل خادم الويب الذي قدّمته عند تفعيل تسجيل الدخول إلى "ألعاب Play" في وحدة تحكّم Firebase، في حقل معرّف العميل.
- انقر على إعداد.
في لعبتك، اضبط عميل "ألعاب Google Play" مع تفعيل الإعداد
RequestServerAuthCode:using GooglePlayGames; using GooglePlayGames.BasicApi; using UnityEngine.SocialPlatforms; using System.Threading.Tasks; PlayGamesClientConfiguration config = new PlayGamesClientConfiguration.Builder() .RequestServerAuthCode(false /* Don't force refresh */) .Build(); PlayGamesPlatform.InitializeInstance(config); PlayGamesPlatform.Activate();بعد ذلك، عندما يختار اللاعب تسجيل الدخول باستخدام "ألعاب Play"، يمكنك استدعاء
Social.localUser.Authenticate():Social.localUser.Authenticate((bool success) => { // handle success or failure });
المصادقة باستخدام Firebase
بعد إضافة ميزة تسجيل الدخول إلى "ألعاب Play" في لعبتك، يمكنك استخدام رمز المصادقة من "خدمات ألعاب Play" للمصادقة باستخدام Firebase.
بعد تسجيل اللاعب الدخول بنجاح باستخدام "ألعاب Google Play"، يمكنك الحصول على رمز مصادقة لحساب اللاعب في معالج متابعة تسجيل الدخول:
Social.localUser.Authenticate((bool success) => { if (success) { authCode = PlayGamesPlatform.Instance.GetServerAuthCode(); } });بعد ذلك، استبدِل رمز المصادقة من "خدمات ألعاب Google Play" ببيانات اعتماد Firebase، واستخدِم بيانات اعتماد Firebase لمصادقة اللاعب:
Firebase.Auth.FirebaseAuth auth = Firebase.Auth.FirebaseAuth.DefaultInstance; Firebase.Auth.Credential credential = Firebase.Auth.PlayGamesAuthProvider.GetCredential(authCode); auth.SignInAndRetrieveDataWithCredentialAsync(credential).ContinueWith(task => { if (task.IsCanceled) { Debug.LogError("SignInAndRetrieveDataWithCredentialAsync was canceled."); return; } if (task.IsFaulted) { Debug.LogError("SignInAndRetrieveDataWithCredentialAsync encountered an error: " + task.Exception); return; } Firebase.Auth.AuthResult result = task.Result; Debug.LogFormat("User signed in successfully: {0} ({1})", result.User.DisplayName, result.User.UserId); });
الخطوات التالية
بعد أن يسجّل المستخدم الدخول لأول مرة، يتم إنشاء حساب مستخدم جديد وربطه بمعرّف "ألعاب Google Play". يتم تخزين هذا الحساب الجديد كجزء من مشروعك على Firebase، ويمكن استخدامه لتحديد هوية المستخدم في كل تطبيق في مشروعك.
في لعبتك، يمكنك الحصول على معرّف Firebase UID الخاص بالمستخدم من
كائن Firebase.Auth.FirebaseUser:
Firebase.Auth.FirebaseUser user = auth.CurrentUser;
if (user != null && user.IsValid()) {
string playerName = user.DisplayName;
// The user's Id, unique to the Firebase project.
// Do NOT use this value to authenticate with your backend server, if you
// have one; use User.TokenAsync() instead.
string uid = user.UserId;
}
في "قاعدة بيانات Firebase في الوقت الفعلي" و"قواعد أمان Cloud Storage"، يمكنك الحصول على
رقم تعريف المستخدم الفريد للمستخدم الذي سجّل الدخول من المتغيّر auth، واستخدامه
للتحكّم في البيانات التي يمكن للمستخدم الوصول إليها.
للحصول على معلومات لاعب في "ألعاب Google Play" أو للوصول إلى خدمات "ألعاب Google Play"، استخدِم واجهات برمجة التطبيقات التي يوفّرها المكوّن الإضافي لخدمة "ألعاب Google Play".
لتسجيل خروج مستخدم، يمكنك استدعاء SignOut():
auth.SignOut();