Android पर Google Play की गेम सेवाओं का इस्तेमाल करके पुष्टि करें

Google Play की गेम सेवाओं का इस्तेमाल करके, खिलाड़ियों को Firebase पर बनाए गए किसी Android गेम में साइन इन करने की सुविधा दी जा सकती है. Firebase के साथ Google Play की गेम सेवाओं में साइन-इन करने के लिए, पहले खिलाड़ी को Google Play Games में साइन इन कराएं. ऐसा करते समय, OAuth 2.0 ऑथराइज़ेशन कोड का अनुरोध करें. इसके बाद, Firebase क्रेडेंशियल जनरेट करने के लिए, ऑथराइज़ेशन कोड को PlayGamesAuthProvider पर भेजें. इस क्रेडेंशियल का इस्तेमाल, Firebase से पुष्टि करने के लिए किया जा सकता है.

शुरू करने से पहले

Firebase के साथ Google Play Games services साइन-इन का इस्तेमाल करने के लिए, सेटअप करने का यह तरीका अपनाएं:

अपना Android प्रोजेक्ट सेट अप करना

  1. अगर आपने पहले से ही A/B टेस्टिंग नहीं बनाई है, तो अपने Android प्रोजेक्ट में Firebase जोड़ें.

  2. मॉड्यूल (ऐप्लिकेशन-लेवल) की Gradle फ़ाइल (आम तौर पर <project>/<app-module>/build.gradle.kts या <project>/<app-module>/build.gradle) में, Android के लिए Firebase Authentication लाइब्रेरी की डिपेंडेंसी जोड़ें. हमारा सुझाव है कि लाइब्रेरी के वर्शन को कंट्रोल करने के लिए, Firebase Android BoM का इस्तेमाल करें.

    साथ ही, Firebase Authentication को सेट अप करने के लिए, आपको अपने ऐप्लिकेशन में Google Play services का SDK टूल जोड़ना होगा.

    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 लाइब्रेरी के साथ काम करने वाले वर्शन का इस्तेमाल करेगा.

    (दूसरा तरीका)  BoM का इस्तेमाल किए बिना, Firebase लाइब्रेरी डिपेंडेंसी जोड़ें 

    अगर आपको 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 फ़िंगरप्रिंट सेट करें.

    gradle signingReport कमांड की मदद से, अपने साइनिंग सर्टिफ़िकेट का SHA हैश पाया जा सकता है:

    ./gradlew signingReport

  3. Google Play Games को साइन-इन की सुविधा देने वाली सेवा के तौर पर चालू करें:

    1. अपने प्रोजेक्ट के वेब सर्वर का क्लाइंट आईडी और क्लाइंट सीक्रेट ढूंढें. वेब सर्वर क्लाइंट आईडी, Google Play के ऑथराइज़ेशन सर्वर को आपके Firebase प्रोजेक्ट की जानकारी देता है.

      ये वैल्यू ढूंढने के लिए:

      1. Google API कंसोल के क्रेडेंशियल पेज पर, अपना Firebase प्रोजेक्ट खोलें.
      2. OAuth 2.0 क्लाइंट आईडी सेक्शन में, वेब क्लाइंट (Google की सेवा से अपने-आप बना) की ज़्यादा जानकारी वाला पेज खोलें. इस पेज पर, आपके वेब सर्वर का क्लाइंट आईडी और सीक्रेट दिखता है.
    2. Firebase कंसोल में वापस जाएं. इसके बाद, Security > Authentication पर जाएं.

    3. साइन-इन का तरीका टैब में, Play Games से साइन-इन करने की सुविधा देने वाली कंपनी को चालू करें. आपको अपने प्रोजेक्ट के वेब सर्वर क्लाइंट आईडी और क्लाइंट सीक्रेट की जानकारी देनी होगी. यह जानकारी आपको Google Cloud कंसोल से मिली होगी.

अपने Firebase ऐप्लिकेशन की जानकारी के साथ Play Games services को कॉन्फ़िगर करें

  1. Google Play Console में, अपना Google Play ऐप्लिकेशन खोलें या कोई ऐप्लिकेशन बनाएं.

  2. बढ़ाएं सेक्शन में, Play Games services > सेटअप और मैनेजमेंट > कॉन्फ़िगरेशन पर क्लिक करें.

  3. हां, मेरे गेम में पहले से ही Google API का इस्तेमाल किया जाता है पर क्लिक करें. इसके बाद, सूची से अपना Firebase प्रोजेक्ट चुनें और फिर इस्तेमाल करें पर क्लिक करें.

  4. Play Games services कॉन्फ़िगरेशन पेज पर, क्रेडेंशियल जोड़ें पर क्लिक करें.

    1. गेम सर्वर का टाइप चुनें.
    2. OAuth क्लाइंट फ़ील्ड में, अपने प्रोजेक्ट का वेब क्लाइंट आईडी चुनें. पक्का करें कि यह वही क्लाइंट आईडी हो जो आपने Play Games साइन-इन की सुविधा चालू करते समय दिया था.
    3. बदलावों को सेव करें.
  5. Play Games services कॉन्फ़िगरेशन पेज पर, क्रेडेंशियल जोड़ें पर फिर से क्लिक करें.

    1. Android टाइप चुनें.
    2. OAuth क्लाइंट फ़ील्ड में, अपने प्रोजेक्ट का Android क्लाइंट आईडी चुनें. (अगर आपको अपना Android क्लाइंट आईडी नहीं दिखता है, तो पक्का करें कि आपने Firebase कंसोल में अपने गेम का SHA-1 फ़िंगरप्रिंट सेट किया हो.)
    3. बदलावों को सेव करें.
  6. टेस्टर पेज पर, उन उपयोगकर्ताओं के ईमेल पते जोड़ें जिन्हें Play Store पर गेम रिलीज़ होने से पहले, उसमें साइन इन करना है.

अपने गेम में Play Games में साइन इन करने की सुविधा को इंटिग्रेट करना

सबसे पहले, अपने ऐप्लिकेशन में Play Games में साइन-इन करने की सुविधा को इंटिग्रेट करें. ज़्यादा जानकारी के लिए, 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 तरीके में अपने वेब सर्वर क्लाइंट आईडी को पास करना होगा. यह वह आईडी है जो आपने Firebase कंसोल में, Play Games में साइन-इन करने की सुविधा चालू करते समय दिया था.

Firebase की मदद से पुष्टि करना

अपने ऐप्लिकेशन में Play Games में साइन-इन करने की सुविधा जोड़ने के बाद, आपको Firebase सेट अप करना होगा. इससे, Google खाते के उन क्रेडेंशियल का इस्तेमाल किया जा सकेगा जो आपको तब मिलते हैं, जब कोई खिलाड़ी Play Games में साइन इन करता है.

  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. अपनी गतिविधि शुरू करते समय, देखें कि खिलाड़ी ने पहले से ही 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. जब कोई खिलाड़ी, Play Games में बैकग्राउंड में या इंटरैक्टिव तरीके से साइन इन कर लेता है, तो 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 तरीके का इस्तेमाल किया जा सकता है.

अगले चरण

जब कोई उपयोगकर्ता पहली बार साइन इन करता है, तो एक नया उपयोगकर्ता खाता बन जाता है. साथ ही, वह उसके Play Games आईडी से लिंक हो जाता है. यह नया खाता, आपके Firebase प्रोजेक्ट के हिस्से के तौर पर सेव किया जाता है. इसका इस्तेमाल, आपके प्रोजेक्ट के हर ऐप्लिकेशन में किसी उपयोगकर्ता की पहचान करने के लिए किया जा सकता है.

अपने गेम में, उपयोगकर्ता का Firebase यूआईडी, 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 वैरिएबल से पाया जा सकता है. साथ ही, इसका इस्तेमाल करके यह कंट्रोल किया जा सकता है कि उपयोगकर्ता कौनसा डेटा ऐक्सेस कर सकता है.

किसी उपयोगकर्ता के Google Play Games प्लेयर की जानकारी पाने या Google Play की गेम सेवाओं को ऐक्सेस करने के लिए, Google Play Games SDK के एपीआई इस्तेमाल करें.

किसी उपयोगकर्ता को साइन आउट करने के लिए, FirebaseAuth.signOut को कॉल करें:

Kotlin

Firebase.auth.signOut()

Java

FirebaseAuth.getInstance().signOut();