المصادقة باستخدام "خدمات ألعاب Google Play" على Android

يمكنك استخدام "خدمات ألعاب Google Play" لتسجيل دخول اللاعبين إلى لعبة Android تم إنشاؤها على Firebase. لاستخدام ميزة تسجيل الدخول إلى "خدمات ألعاب Google Play" من خلال Firebase، عليك أولاً تسجيل دخول اللاعب باستخدام "خدمات ألعاب Google Play" وطلب رمز مصادقة OAuth 2.0 عند إجراء ذلك. بعد ذلك، عليك تمرير رمز المصادقة إلى PlayGamesAuthProvider لإنشاء بيانات اعتماد Firebase التي يمكنك استخدامها للمصادقة من خلال Firebase.

قبل البدء

لاستخدام ميزة تسجيل الدخول إلى Google Play Games services مع Firebase، أكمِل الخطوات التالية:

إعداد مشروع Android

  1. أضِف Firebase إلى مشروع Android الخاص بك، في حال لم يسبق لك إجراء ذلك.

  2. في ملف 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

  1. في وحدة تحكّم Firebase، انتقِل إلى الأمان > المصادقة.

  2. في علامة التبويب الإعدادات، اضبط الملف المرجعي لشهادة SHA-1 للعبتك.

    يمكنك الحصول على تجزئة SHA لشهادة التوقيع باستخدام الأمر signingReport في gradle:

    ./gradlew signingReport

  3. تفعيل "ألعاب Google Play" كموفّر خدمة تسجيل الدخول:

    1. ابحث عن معرّف عميل خادم الويب وسر العميل لمشروعك. يحدّد معرّف العميل لخادم الويب مشروع Firebase الخاص بك لخوادم مصادقة Google Play.

      للعثور على هذه القيم:

      1. افتح مشروع Firebase في صفحة بيانات الاعتماد في وحدة تحكّم Google APIs.
      2. في قسم معرّفات عملاء OAuth 2.0، افتح صفحة تفاصيل عميل الويب (تم إنشاؤه تلقائيًا بواسطة خدمة Google). تعرض هذه الصفحة معرّف العميل والرمز السرّي لخادم الويب.
    2. في وحدة تحكّم Firebase، انتقِل إلى الأمان > المصادقة.

    3. في علامة التبويب طريقة تسجيل الدخول (Sign-in method)، فعِّل مزوّد خدمة تسجيل الدخول إلى ألعاب Play. عليك تحديد معرّف العميل وسر العميل لخادم الويب الخاص بمشروعك، واللذين حصلت عليهما من وحدة تحكّم Google Cloud.

ضبط Play Games services باستخدام معلومات تطبيق Firebase

  1. في وحدة تحكّم Google Play، افتح تطبيق Google Play أو أنشِئ تطبيقًا.

  2. في قسم النمو، انقر على Play Games services > الإعداد والإدارة > الإعدادات.

  3. انقر على نعم، تستخدم لعبتي واجهات Google APIs حاليًا، واختَر مشروع Firebase من القائمة، ثم انقر على استخدام.

  4. في صفحة إعدادات Play Games services، انقر على إضافة بيانات الاعتماد.

    1. اختَر نوع خادم اللعبة.
    2. في حقل عميل OAuth، اختَر معرّف عميل الويب الخاص بمشروعك. تأكَّد من أنّ هذا هو معرّف العميل نفسه الذي حدّدته عند تفعيل تسجيل الدخول إلى Play Games.
    3. احفظ التغييرات.
  5. في صفحة إعدادات Play Games services، انقر على إضافة بيانات الاعتماد مرة أخرى.

    1. اختَر نوع Android.
    2. في حقل عميل OAuth، اختَر معرّف عميل Android لمشروعك. (إذا لم يظهر لك معرِّف عميل Android، تأكَّد من ضبط بصمة إصبع SHA-1 للعبتك في وحدة تحكّم Firebase).
    3. احفظ التغييرات.
  6. في صفحة المختبِرون، أضِف عناوين البريد الإلكتروني لأي مستخدمين يحتاجون إلى تسجيل الدخول إلى لعبتك قبل إصدارها على 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

بعد إضافة ميزة تسجيل الدخول إلى &quot;ألعاب Google Play&quot; في تطبيقك، عليك إعداد Firebase لاستخدام بيانات اعتماد حساب Google التي تحصل عليها عندما يسجّل اللاعب الدخول بنجاح باستخدام &quot;ألعاب Google Play&quot;.

  1. أولاً، في إجراء onCreate الخاص بنشاط تسجيل الدخول، احصل على المثيل المشترك لعنصر FirebaseAuth:

    Kotlin

    private lateinit var auth: FirebaseAuth
    // ...
    // Initialize Firebase Auth
    auth = Firebase.auth

    Java

    private FirebaseAuth mAuth;
    // ...
    // Initialize Firebase Auth
    mAuth = FirebaseAuth.getInstance();
  2. 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);
    }

    إذا لم يسجّل اللاعب الدخول، اعرض له تجربة اللعبة بدون تسجيل الدخول، بما في ذلك خيار تسجيل الدخول.

  3. بعد أن يسجّل اللاعب الدخول باستخدام "ألعاب 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();