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

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

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

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

  1. अगर आपने पहले से ऐसा नहीं किया है, तो अपने 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:33.7.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:21.3.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:23.1.0")
    
    // Also add the dependency for the Google Play services library and specify its version
    implementation("com.google.android.gms:play-services-auth:21.3.0")    
}
         क्या आपको Kotlin के लिए कोई लाइब्रेरी मॉड्यूल चाहिए? अक्टूबर 2023 (Firebase BoM 32.5.0) से, Kotlin और Java, दोनों डेवलपर मुख्य लाइब्रेरी मॉड्यूल का इस्तेमाल कर सकते हैं. ज़्यादा जानकारी के लिए, इस पहल के बारे में अक्सर पूछे जाने वाले सवाल देखें.

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

  1. Firebase कंसोल के सेटिंग पेज पर जाकर, अपने गेम का SHA-1 फ़िंगरप्रिंट सेट करें.

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

    ./gradlew signingReport

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

    1. अपने प्रोजेक्ट के वेब सर्वर का क्लाइंट आईडी और क्लाइंट सीक्रेट ढूंढें. वेब सर्वर क्लाइंट आईडी, Google Play के पुष्टि करने वाले सर्वर को आपके Firebase प्रोजेक्ट की पहचान करता है.

      ये वैल्यू देखने के लिए:

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

    2. इसके बाद, Firebase कंसोल में, पुष्टि सेक्शन खोलें.

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

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

  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 Games में साइन इन करना लेख पढ़ें.

अपने इंटिग्रेशन में, 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()
MainActivity.kt

Java

GoogleSignInOptions gso = new GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN)
        .requestServerAuthCode(getString(R.string.default_web_client_id))
        .build();
MainActivity.java

आपको 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
GoogleSignInActivity.kt

Java

private FirebaseAuth mAuth;
// ...
// Initialize Firebase Auth
mAuth = FirebaseAuth.getInstance();
GoogleSignInActivity.java
  1. अपनी गतिविधि शुरू करते समय, देखें कि खिलाड़ी ने पहले से ही 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)
}
GoogleSignInActivity.kt

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);
}
GoogleSignInActivity.java
 
If the player isn't signed in, present the player with your game's
signed-out experience, including the option to sign in.
  1. जब कोई खिलाड़ी 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)
            }

            // ...
        }
}
MainActivity.kt

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);
                    }

                    // ...
                }
            });
}
MainActivity.java

अगर signInWithCredential को कॉल करने पर कोई गड़बड़ी नहीं मिलती है, तो उपयोगकर्ता के खाते का डेटा पाने के लिए getCurrentUser का तरीका इस्तेमाल किया जा सकता है.

अगले चरण

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

अपने गेम में, FirebaseUser ऑब्जेक्ट से उपयोगकर्ता का Firebase UID पाया जा सकता है:

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
}

MainActivity.kt

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();
MainActivity.java

Firebase रीयलटाइम डेटाबेस और Cloud Storage के सुरक्षा नियमों में, auth वैरिएबल से साइन इन किए गए उपयोगकर्ता का यूनीक उपयोगकर्ता आईडी पाया जा सकता है. साथ ही, इसका इस्तेमाल करके यह कंट्रोल किया जा सकता है कि उपयोगकर्ता कौनसा डेटा ऐक्सेस कर सकता है.

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

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

Kotlin

Firebase.auth.signOut()
MainActivity.kt

Java

FirebaseAuth.getInstance().signOut();
MainActivity.java