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

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

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

अपना 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 की सेवाओं का SDK टूल जोड़ना होगा.

    dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:34.12.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.5.1")    
}

    Firebase Android BoM का इस्तेमाल करने पर, आपका ऐप्लिकेशन हमेशा Firebase Android लाइब्रेरी के साथ काम करने वाले वर्शन का इस्तेमाल करेगा.

    (दूसरा तरीका)  BoM का इस्तेमाल किए बिना 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:24.0.1")
    
    // Also add the dependency for the Google Play services library and specify its version
    implementation("com.google.android.gms:play-services-auth:21.5.1")    
}

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

  1. Firebase कंसोल के 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 को साइन-इन करने की सुविधा देने वाले प्लैटफ़ॉर्म के तौर पर चालू करें. आपको अपने प्रोजेक्ट का वेब सर्वर क्लाइंट आईडी और क्लाइंट सीक्रेट बताना होगा. यह जानकारी, आपको APIs कंसोल से मिली होगी.

अपने 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 क्लाइंट आईडी नहीं दिखता है, तो पक्का करें कि आपने अपने गेम का SHA-1 फ़िंगरप्रिंट Firebase कंसोल में सेट किया हो.)
    3. बदलावों को सेव करें.

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

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

अपने गेम में, 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
}

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 Games की खिलाड़ी से जुड़ी जानकारी पाने या Play Games की सेवाओं को ऐक्सेस करने के लिए, Google Play Games SDK टूल से मिले एपीआई का इस्तेमाल करें.

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

Kotlin

Firebase.auth.signOut()

Java

FirebaseAuth.getInstance().signOut();