يمكنك استخدام "خدمات ألعاب Google Play" لتسجيل دخول اللاعبين إلى لعبة Android
تم إنشاؤها على Firebase. لاستخدام ميزة تسجيل الدخول إلى "خدمات ألعاب Google Play" من خلال Firebase،
عليك أولاً تسجيل دخول اللاعب باستخدام "خدمات ألعاب Google Play" وطلب رمز مصادقة
OAuth 2.0 عند إجراء ذلك. بعد ذلك، عليك تمرير رمز المصادقة إلى PlayGamesAuthProvider
لإنشاء بيانات اعتماد Firebase التي يمكنك استخدامها للمصادقة من خلال Firebase.
قبل البدء
لاستخدام ميزة تسجيل الدخول إلى Google Play Games services مع Firebase، أكمِل الخطوات التالية:
إعداد مشروع Android
أضِف Firebase إلى مشروع Android الخاص بك، في حال لم يسبق لك إجراء ذلك.
في ملف Gradle للوحدة (على مستوى التطبيق) (عادةً
<project>/<app-module>/build.gradle.ktsأو<project>/<app-module>/build.gradle)، أضِف الاعتمادية لمكتبة Firebase Authentication لنظام التشغيل Android. ننصح باستخدام Firebase Android BoM للتحكّم في إصدارات المكتبة.أيضًا، كجزء من إعداد Firebase Authentication، عليك إضافة حزمة تطوير البرامج (SDK) لخدمات Google Play إلى تطبيقك.
dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:35.2.0")) // Add the dependency for the Firebase Authentication library // When using the BoM, you don't specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-auth")
// Also add the dependency for the Google Play services library and specify its version implementation("com.google.android.gms:play-services-auth:22.0.0") }باستخدام Firebase Android BoM، سيستخدم تطبيقك دائمًا إصدارات متوافقة من مكتبات Firebase لنظام التشغيل Android.
(بديل) إضافة تبعيات مكتبة Firebase بدون استخدام BoM
إذا اخترت عدم استخدام Firebase BoM، عليك تحديد كل إصدار من مكتبة Firebase في سطر التبعية الخاص به.
يُرجى العِلم أنّه في حال استخدام مكتبات Firebase متعددة في تطبيقك، ننصحك بشدة باستخدام BoM لإدارة إصدارات المكتبات، ما يضمن توافق جميع الإصدارات.
dependencies { // Add the dependency for the Firebase Authentication library // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-auth:25.0.0")
// Also add the dependency for the Google Play services library and specify its version implementation("com.google.android.gms:play-services-auth:22.0.0") }
إعداد مشروع Firebase
في وحدة تحكّم Firebase، انتقِل إلى الأمان > المصادقة.
في علامة التبويب الإعدادات، اضبط الملف المرجعي لشهادة SHA-1 للعبتك.
يمكنك الحصول على تجزئة SHA لشهادة التوقيع باستخدام الأمر
signingReportفي gradle:./gradlew signingReport
تفعيل "ألعاب Google Play" كموفّر خدمة تسجيل الدخول:
ابحث عن معرّف عميل خادم الويب وسر العميل لمشروعك. يحدّد معرّف العميل لخادم الويب مشروع Firebase الخاص بك لخوادم مصادقة Google Play.
للعثور على هذه القيم:
- افتح مشروع Firebase في صفحة بيانات الاعتماد في وحدة تحكّم Google APIs.
- في قسم معرّفات عملاء OAuth 2.0، افتح صفحة تفاصيل عميل الويب (تم إنشاؤه تلقائيًا بواسطة خدمة Google). تعرض هذه الصفحة معرّف العميل والرمز السرّي لخادم الويب.
في وحدة تحكّم Firebase، انتقِل إلى الأمان > المصادقة.
في علامة التبويب طريقة تسجيل الدخول (Sign-in method)، فعِّل مزوّد خدمة تسجيل الدخول إلى ألعاب Play. عليك تحديد معرّف العميل وسر العميل لخادم الويب الخاص بمشروعك، واللذين حصلت عليهما من وحدة تحكّم Google Cloud.
ضبط 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 Store.
دمج ميزة تسجيل الدخول إلى "ألعاب Google Play" في لعبتك
أولاً، عليك دمج ميزة تسجيل الدخول إلى "ألعاب Play" في تطبيقك. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تسجيل الدخول إلى ألعاب Android.
في عملية الدمج، عند إنشاء عنصر GoogleSignInOptions، استخدِم إعدادات DEFAULT_GAMES_SIGN_IN واستدعِ requestServerAuthCode:
Kotlin
val gso = GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN) .requestServerAuthCode(getString(R.string.default_web_client_id)) .build()
Java
GoogleSignInOptions gso = new GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN) .requestServerAuthCode(getString(R.string.default_web_client_id)) .build();
يجب تمرير معرّف عميل خادم الويب إلى الإجراء requestServerAuthCode.
هذا هو رقم التعريف الذي قدّمته عند تفعيل ميزة تسجيل الدخول إلى "ألعاب Google Play" في وحدة تحكّم Firebase.
المصادقة باستخدام Firebase
بعد إضافة ميزة تسجيل الدخول إلى "ألعاب Google Play" في تطبيقك، عليك إعداد Firebase لاستخدام بيانات اعتماد حساب Google التي تحصل عليها عندما يسجّل اللاعب الدخول بنجاح باستخدام "ألعاب Google Play".
أولاً، في إجراء
onCreateالخاص بنشاط تسجيل الدخول، احصل على المثيل المشترك لعنصرFirebaseAuth:Kotlin
private lateinit var auth: FirebaseAuth // ... // Initialize Firebase Auth auth = Firebase.auth
Java
private FirebaseAuth mAuth; // ... // Initialize Firebase Auth mAuth = FirebaseAuth.getInstance();
When initializing your Activity, check to see if the player is already signed in with Firebase:
Kotlin
override fun onStart() { super.onStart() // Check if user is signed in (non-null) and update UI accordingly. val currentUser = auth.currentUser updateUI(currentUser) }
Java
@Override public void onStart() { super.onStart(); // Check if user is signed in (non-null) and update UI accordingly. FirebaseUser currentUser = mAuth.getCurrentUser(); updateUI(currentUser); }
إذا لم يسجّل اللاعب الدخول، اعرض له تجربة اللعبة بدون تسجيل الدخول، بما في ذلك خيار تسجيل الدخول.
بعد أن يسجّل اللاعب الدخول باستخدام "ألعاب Google Play" إما تلقائيًا أو تفاعليًا، يمكنك الحصول على رمز المصادقة من عنصر
GoogleSignInAccountواستبداله ببيانات اعتماد Firebase والمصادقة باستخدام Firebase من خلال بيانات اعتماد Firebase:Kotlin
// Call this both in the silent sign-in task's OnCompleteListener and in the // Activity's onActivityResult handler. private fun firebaseAuthWithPlayGames(acct: GoogleSignInAccount) { Log.d(TAG, "firebaseAuthWithPlayGames:" + acct.id!!) val auth = Firebase.auth val credential = PlayGamesAuthProvider.getCredential(acct.serverAuthCode!!) auth.signInWithCredential(credential) .addOnCompleteListener(this) { task -> if (task.isSuccessful) { // Sign in success, update UI with the signed-in user's information Log.d(TAG, "signInWithCredential:success") val user = auth.currentUser updateUI(user) } else { // If sign in fails, display a message to the user. Log.w(TAG, "signInWithCredential:failure", task.exception) Toast.makeText( baseContext, "Authentication failed.", Toast.LENGTH_SHORT, ).show() updateUI(null) } // ... } }
Java
// Call this both in the silent sign-in task's OnCompleteListener and in the // Activity's onActivityResult handler. private void firebaseAuthWithPlayGames(GoogleSignInAccount acct) { Log.d(TAG, "firebaseAuthWithPlayGames:" + acct.getId()); final FirebaseAuth auth = FirebaseAuth.getInstance(); AuthCredential credential = PlayGamesAuthProvider.getCredential(acct.getServerAuthCode()); auth.signInWithCredential(credential) .addOnCompleteListener(this, new OnCompleteListener<AuthResult>() { @Override public void onComplete(@NonNull Task<AuthResult> task) { if (task.isSuccessful()) { // Sign in success, update UI with the signed-in user's information Log.d(TAG, "signInWithCredential:success"); FirebaseUser user = auth.getCurrentUser(); updateUI(user); } else { // If sign in fails, display a message to the user. Log.w(TAG, "signInWithCredential:failure", task.getException()); Toast.makeText(MainActivity.this, "Authentication failed.", Toast.LENGTH_SHORT).show(); updateUI(null); } // ... } }); }
في حال نجاح الطلب إلى
signInWithCredential، يمكنك استخدام طريقةgetCurrentUserللحصول على بيانات حساب المستخدم.
الخطوات التالية
بعد أن يسجّل المستخدم الدخول لأول مرة، يتم إنشاء حساب مستخدم جديد وربطه بمعرّف "ألعاب Google Play". يتم تخزين هذا الحساب الجديد كجزء من مشروعك على Firebase، ويمكن استخدامه لتحديد هوية المستخدم في كل تطبيق في مشروعك.
في لعبتك، يمكنك الحصول على معرّف Firebase UID الخاص بالمستخدم من عنصر FirebaseUser:
Kotlin
val user = auth.currentUser user?.let { val playerName = it.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 FirebaseUser.getIdToken() instead. val uid = it.uid }
Java
FirebaseUser user = mAuth.getCurrentUser(); String playerName = user.getDisplayName(); // 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 FirebaseUser.getIdToken() instead. String uid = user.getUid();
في "قاعدة بيانات Firebase في الوقت الفعلي" و"قواعد أمان Cloud Storage"، يمكنك الحصول على
رقم تعريف المستخدم الفريد للمستخدم الذي سجّل الدخول من المتغيّر auth، واستخدامه
للتحكّم في البيانات التي يمكن للمستخدم الوصول إليها.
للحصول على معلومات لاعب في "ألعاب Play" أو للوصول إلى خدمات "ألعاب Play"، استخدِم واجهات برمجة التطبيقات التي توفّرها حزمة تطوير البرامج (SDK) لخدمات "ألعاب Google Play".
لتسجيل خروج مستخدم، يمكنك استدعاء FirebaseAuth.signOut:
Kotlin
Firebase.auth.signOut()
Java
FirebaseAuth.getInstance().signOut();