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

Android गेम में खिलाड़ियों को साइन इन करने के लिए, Google Play की गेम सेवाओं का इस्तेमाल किया जा सकता है Firebase पर बनाया गया. Google Play की गेम सेवाओं का इस्तेमाल करने के लिए, Firebase की मदद से साइन-इन करें सबसे पहले 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.5.1"))
   
       // 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.2.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.2.0")
   }

   क्या आपको Kotlin से जुड़े लाइब्रेरी मॉड्यूल की तलाश है? इतने समय में शुरू होगा अक्टूबर 2023 (Firebase BoM 32.5.0), Kotlin और Java डेवलपर, दोनों यह मुख्य लाइब्रेरी मॉड्यूल पर निर्भर करता है (जानकारी के लिए, इस पहल के बारे में अक्सर पूछे जाने वाले सवाल).

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

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

   आपको Gradle के साथ अपने साइनिंग सर्टिफ़िकेट का SHA हैश मिल सकता है signingReport निर्देश:

   ./gradlew signingReport

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

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

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

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

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

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

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

1. इस Google Play कंसोल, अपना 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 वाले ऐप्लिकेशन पर रिलीज़ करने से पहले उसमें साइन इन कर सकें Play Store.

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

सबसे पहले, Play Games में साइन इन करने की सुविधा को अपने ऐप्लिकेशन में इंटिग्रेट करें. यहां जाएं: Android Games में साइन इन करें पूरा निर्देश देखें.

अपने इंटिग्रेशन में, GoogleSignInOptions ऑब्जेक्ट बनाते समय, DEFAULT_GAMES_SIGN_IN का कॉन्फ़िगरेशन और requestServerAuthCode को कॉल करें:

val gso = GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN)
    .requestServerAuthCode(getString(R.string.default_web_client_id))
    .build()
MainActivity.kt

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

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

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

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

1. सबसे पहले, अपनी साइन इन गतिविधि के onCreate तरीके में, FirebaseAuth ऑब्जेक्ट का शेयर किया गया इंस्टेंस:

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

private FirebaseAuth mAuth;
// ...
// Initialize Firebase Auth
mAuth = FirebaseAuth.getInstance();
GoogleSignInActivity.java

1. अपनी गतिविधि शुरू करते समय, यह देखें कि प्लेयर ने पहले से साइन इन किया हुआ है या नहीं बनाने के लिए:

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

@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 से पुष्टि करना क्रेडेंशियल:

// 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

// 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 तरीके का इस्तेमाल किया जा सकता है.

अगले चरण

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

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

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

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() पर कॉल करें:

Firebase.auth.signOut()
MainActivity.kt

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