Firebase पर बने Android गेम में खिलाड़ियों को साइन इन करने के लिए, Google Play की गेम सेवाओं का इस्तेमाल किया जा सकता है. अगर आपको Google Play Games सेवाओं में Firebase से साइन इन करना है, तो सबसे पहले Google Play Games से प्लेयर को साइन इन करें. इसके बाद, OAuth 2.0 पुष्टि करने वाले कोड का अनुरोध करें. इसके बाद, Firebase क्रेडेंशियल जनरेट करने के लिए, PlayGamesAuthProvider
को ऑथराइज़ेशन कोड पास करें. इसका इस्तेमाल Firebase से पुष्टि करने के लिए किया जा सकता है.
शुरू करने से पहले
अपना Android प्रोजेक्ट सेट अप करना
अगर आपने पहले से Firebase को नहीं जोड़ा है, तो अपने Android प्रोजेक्ट में Firebase जोड़ें.
अपने मॉड्यूल (ऐप्लिकेशन-लेवल) की Gradle फ़ाइल (आम तौर पर,
<project>/<app-module>/build.gradle.kts
या<project>/<app-module>/build.gradle
) में, Android के लिए Firebase से पुष्टि करने वाली लाइब्रेरी के लिए डिपेंडेंसी जोड़ें. लाइब्रेरी के वर्शन को कंट्रोल करने के लिए, हम Firebase Android BoM का इस्तेमाल करने का सुझाव देते हैं.इसके अलावा, Firebase से पुष्टि करने की सुविधा सेट अप करने के दौरान, आपको अपने ऐप्लिकेशन में Google Play services SDK टूल जोड़ना होगा.
dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.1.2")) // 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.0.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") }
अपना Firebase प्रोजेक्ट सेट अप करना
Firebase कंसोल के सेटिंग पेज से अपने गेम का SHA-1 फ़िंगरप्रिंट सेट करें.
Gradle
signingReport
कमांड का इस्तेमाल करके, अपने साइनिंग सर्टिफ़िकेट का SHA हैश पाया जा सकता है:./gradlew signingReport
Google Play Games को साइन इन की सेवा देने वाली कंपनी के तौर पर चालू करें:
अपने प्रोजेक्ट के वेब सर्वर का क्लाइंट आईडी और क्लाइंट सीक्रेट ढूंढें. वेब सर्वर क्लाइंट आईडी, Google Play के पुष्टि करने वाले सर्वर से आपके Firebase प्रोजेक्ट की पहचान करता है.
ये वैल्यू देखने के लिए:
- Google API कंसोल क्रेडेंशियल पेज पर अपना Firebase प्रोजेक्ट खोलें.
- OAuth 2.0 क्लाइंट आईडी सेक्शन में, वेब क्लाइंट (Google सेवा की ओर से अपने-आप बनाया गया) की ज़्यादा जानकारी वाला पेज खोलें. इस पेज में आपके वेब सर्वर के क्लाइंट आईडी और सीक्रेट की जानकारी दी गई है.
इसके बाद, Firebase कंसोल में जाकर, पुष्टि करने की सुविधा सेक्शन खोलें.
साइन इन करने का तरीका टैब पर, Play Games में साइन इन करने की सेवा देने वाली कंपनी को चालू करें. आपको एपीआई कंसोल से मिले प्रोजेक्ट के वेब सर्वर क्लाइंट आईडी और क्लाइंट सीक्रेट की जानकारी देनी होगी.
अपने Firebase ऐप्लिकेशन की जानकारी के साथ Play की गेम सेवाओं को कॉन्फ़िगर करें
Google Play Console में जाकर, अपना Google Play ऐप्लिकेशन खोलें या नया ऐप्लिकेशन बनाएं.
बढ़ाएं सेक्शन में जाकर, Play की गेम सेवाएं > सेटअप और मैनेजमेंट > कॉन्फ़िगरेशन पर क्लिक करें.
हां, मेरे गेम में पहले से ही Google API का इस्तेमाल हो रहा है पर क्लिक करें. इसके बाद, सूची से अपना Firebase प्रोजेक्ट चुनें और इस्तेमाल करें पर क्लिक करें.
Play की गेम सेवाओं के कॉन्फ़िगरेशन पेज पर, क्रेडेंशियल जोड़ें पर क्लिक करें.
- गेम सर्वर टाइप चुनें.
- OAuth क्लाइंट फ़ील्ड में, अपने प्रोजेक्ट का वेब क्लाइंट आईडी चुनें. पक्का करें कि यह वही क्लाइंट आईडी है जिसे आपने Play Games में साइन इन करने की सुविधा चालू करते समय डाला था.
- बदलावों को सेव करें.
अब भी Play की गेम सेवाओं के कॉन्फ़िगरेशन पेज पर जाकर, क्रेडेंशियल जोड़ें पर फिर से क्लिक करें.
- Android टाइप चुनें.
- OAuth क्लाइंट फ़ील्ड में, अपने प्रोजेक्ट का Android क्लाइंट आईडी चुनें. (अगर आपको अपना Android क्लाइंट आईडी नहीं दिखता है, तो पक्का करें कि आपने Firebase कंसोल में अपने गेम का SHA-1 फ़िंगरप्रिंट सेट किया हो.)
- बदलावों को सेव करें.
टेस्टर पेज पर, उन सभी उपयोगकर्ताओं के ईमेल पते जोड़ें जो Play Store पर गेम को रिलीज़ करने से पहले उसमें साइन इन करना चाहते हैं.
अपने गेम में, Play Games में साइन इन करने की सुविधा इंटिग्रेट करें
सबसे पहले, अपने ऐप्लिकेशन में Play Games में साइन इन करने की सुविधा जोड़ें. सभी निर्देशों के लिए Android गेम में साइन इन करें देखें.
अपने इंटिग्रेशन में, GoogleSignInOptions
ऑब्जेक्ट बनाते समय, DEFAULT_GAMES_SIGN_IN
कॉन्फ़िगरेशन का इस्तेमाल करें और requestServerAuthCode
को कॉल करें:
Kotlin+KTX
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 में साइन इन करने के बाद, आपको Google खाते के उन क्रेडेंशियल का इस्तेमाल करने के लिए Firebase सेट अप करना होगा जो Play Games में खिलाड़ी के साइन इन करने पर मिलते हैं.
- सबसे पहले, अपनी साइन-इन गतिविधि के
onCreate
तरीके में,FirebaseAuth
ऑब्जेक्ट का शेयर किया गया इंस्टेंस पाएं:
Kotlin+KTX
private lateinit var auth: FirebaseAuth // ... // Initialize Firebase Auth auth = Firebase.auth
Java
private FirebaseAuth mAuth; // ... // Initialize Firebase Auth mAuth = FirebaseAuth.getInstance();
- अपनी गतिविधि शुरू करते समय, यह देखें कि क्या प्लेयर ने पहले से Firebase से साइन इन किया हुआ है:
Kotlin+KTX
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); }
If the player isn't signed in, present the player with your game's
signed-out experience, including the option to sign in.
- जब कोई खिलाड़ी बिना आवाज़ या इंटरैक्टिव तरीके से Play Games में साइन इन करता है, तब
GoogleSignInAccount
ऑब्जेक्ट से ऑथराइज़ेशन कोड पाएं. इसके बाद, उसे Firebase क्रेडेंशियल के लिए बदलें और Firebase क्रेडेंशियल का इस्तेमाल करके, Firebase से पुष्टि करें:
Kotlin+KTX
// 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 यूआईडी पाया जा सकता है:
Kotlin+KTX
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 की गेम सेवाएं ऐक्सेस करने के लिए, Google Play Games SDK से मिले एपीआई का इस्तेमाल करें.
किसी उपयोगकर्ता को साइन आउट करने के लिए, FirebaseAuth.signOut()
पर कॉल करें:
Kotlin+KTX
Firebase.auth.signOut()
Java
FirebaseAuth.getInstance().signOut();