अपने Unity प्रोजेक्ट में Firebase जोड़ना

हमारे Firebase Unity SDK टूल की मदद से, अपने Unity गेम को बेहतर बनाएं.

Firebase को आपके Unity प्रोजेक्ट में प्लग करना कितना आसान है, यह दिखाने के लिए हमने सैंपल गेम, MechaHamster. अगर आपको किसी गेम में Firebase जोड़ना है, तो GitHub पर मौजूद शुरुआती वर्शन का इस्तेमाल करें. अगर आपको पूरा वर्शन चाहिए, तो App Store या Google Play Store से सभी वर्शन हटा दें.

MechaHamster (GitHub)

MechaHamster (ऐप स्टोर)

MechaHamster (Play Store)


Firebase की मदद से अपने गेम को बेहतर बनाने के बारे में ज़्यादा जानने के लिए, हमारे Firebase गेम पेज पर जाएं.

क्या आपने अपने Unity प्रोजेक्ट में पहले से ही Firebase जोड़ लिया है? सुनिश्चित करें कि आप Firebase Unity SDK टूल का सबसे नया वर्शन.

ज़रूरी शर्तें

  • Unity 2021 एलटीएस या इसके बाद वाले वर्शन को इंस्टॉल करें. यह Unity 2020 के लिए काम करता है बंद कर दिया गया है. साथ ही, अगले अहम विज्ञापन टेक्स्ट के बाद, सक्रिय रूप से काम नहीं करेगा रिलीज़. हालांकि, हो सकता है कि यह ऐप्लिकेशन, पहले के वर्शन पर भी काम करे, लेकिन इन पर इसे इस्तेमाल करने के लिए, आपको ज़्यादा मेहनत करनी पड़ सकती है.

  • (सिर्फ़ Apple प्लैटफ़ॉर्म के लिए) ये इंस्टॉल करें:

    • Xcode 13.3.1 या इसके बाद का वर्शन
    • CocoaPods 1.12.0 या इसके बाद का वर्शन
  • पक्का करें कि आपका Unity प्रोजेक्ट इन ज़रूरी शर्तों को पूरा करता हो:

    • iOS के लिए — iOS 13 या उसके बाद के वर्शन को टारगेट करता है
    • tvOS के लिए - tvOS 13 या इसके बाद के वर्शन को टारगेट करता है
    • Android के लिए — एपीआई लेवल 21 को टारगेट करता है (Lollipop) या उससे बाद का वर्शन
  • अपना ऐप्लिकेशन चलाने के लिए, एक फ़िज़िकल डिवाइस सेट अप करें या एम्युलेटर का इस्तेमाल करें.

    • Apple प्लैटफ़ॉर्म के लिए — कोई फ़िज़िकल डिवाइस सेट अप करें या iOS या tvOS सिम्युलेटर का इस्तेमाल करें.

    • Android के लिएएम्युलेटर को Google Play के साथ एम्युलेटर इमेज का इस्तेमाल करना होगा.

अगर आपके पास पहले से Unity प्रोजेक्ट नहीं है और आपको Firebase को आज़माना है, तो प्रॉडक्ट के लिए, आप हमारे क्विकस्टार्ट सैंपल में से एक डाउनलोड कर सकते हैं.

पहला चरण: Firebase प्रोजेक्ट बनाना

Firebase को अपने Unity प्रोजेक्ट में जोड़ने से पहले, आपको एक Firebase बनाना होगा प्रोजेक्ट पर काम करता है. इस लिंक पर जाएँ ज़्यादा जानने के लिए, Firebase प्रोजेक्ट को समझना Firebase प्रोजेक्ट.

दूसरा चरण: अपने ऐप्लिकेशन को Firebase के साथ रजिस्टर करना

अपने Firebase से कनेक्ट करने के लिए, एक या उससे ज़्यादा ऐप्लिकेशन या गेम रजिस्टर किए जा सकते हैं प्रोजेक्ट.

  1. Firebase console पर जाएं.

  2. सेटअप वर्कफ़्लो लॉन्च करने के लिए, प्रोजेक्ट की खास जानकारी वाले पेज के बीच में मौजूद Unity आइकॉन () पर क्लिक करें.

    अगर आपने अपने Firebase प्रोजेक्ट में पहले से ही कोई ऐप्लिकेशन जोड़ दिया है, तो प्लैटफ़ॉर्म के विकल्प दिखाने के लिए, ऐप्लिकेशन जोड़ें पर क्लिक करें.

  3. चुनें कि आपको अपने Unity प्रोजेक्ट के लिए किस बिल्ड टारगेट को रजिस्टर करना है. या अब आप एक ही समय में दोनों लक्ष्यों को रजिस्टर करने का विकल्प भी चुन सकते हैं.

  4. अपने Unity प्रोजेक्ट के प्लैटफ़ॉर्म के हिसाब से आईडी डालें.

    • iOS के लिए — अपने Unity प्रोजेक्ट का iOS आईडी iOS बंडल आईडी फ़ील्ड.

    • Android के लिए — इसमें अपने Unity प्रोजेक्ट का Android आईडी डालें Android पैकेज नाम फ़ील्ड का नाम डालें.
      अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है आम तौर पर, पैकेज का नाम और ऐप्लिकेशन आईडी शब्दों का इस्तेमाल किया जाता है एक-दूसरे की जगह पर.

  5. (ज़रूरी नहीं) अपने Unity प्रोजेक्ट के लिए प्लैटफ़ॉर्म के हिसाब से कोई दूसरा नाम डालें.
    ये कोई आधिकारिक नाम नहीं हैं. ये सिर्फ़ Firebase console में दिखते हैं.

  6. ऐप्लिकेशन रजिस्टर करें पर क्लिक करें.

तीसरा चरण: Firebase कॉन्फ़िगरेशन फ़ाइलें जोड़ना

  1. इसमें अपने प्लैटफ़ॉर्म के हिसाब से Firebase कॉन्फ़िगरेशन फ़ाइल(फ़ाइलें) पाएं Firebase कंसोल का सेटअप वर्कफ़्लो.

    • iOS के लिएGoogleService-Info.plist डाउनलोड करें पर क्लिक करें.

    • Android के लिएgoogle-services.json डाउनलोड करें पर क्लिक करें.

  2. अपने Unity प्रोजेक्ट की प्रोजेक्ट विंडो खोलें. इसके बाद, अपने कॉन्फ़िगरेशन को दूसरी जगह ले जाएं फ़ाइल(फ़ाइलें) Assets फ़ोल्डर में डाल दें.

  3. Firebase कंसोल में वापस आएं और सेटअप वर्कफ़्लो में, आगे बढ़ें पर क्लिक करें.

चौथा चरण: Firebase Unity SDK टूल जोड़ना

    उपलब्ध कराता है.
  1. Firebase कंसोल में, Firebase Unity SDK टूल डाउनलोड करें पर क्लिक करें. इसके बाद, SDK टूल को किसी सुविधाजनक जगह पर अनज़िप करें.

    • Firebase Unity SDK टूल को कभी भी फिर से डाउनलोड किया जा सकता है.

    • Firebase Unity SDK टूल, किसी खास प्लैटफ़ॉर्म के लिए नहीं है.

  2. अपने खुले हुए Unity प्रोजेक्ट में, यहां जाएं ऐसेट > पैकेज इंपोर्ट करें > कस्टम पैकेज.

  3. अनज़िप किए गए SDK टूल से, काम करने वाला Firebase चुनें जिन प्रॉडक्ट में आपको इस्तेमाल करना है आपका ऐप्लिकेशन.

    Analytics चालू किया गया

    • Google Analytics के लिए Firebase पैकेज जोड़ें: FirebaseAnalytics.unitypackage
    • आपको जिन Firebase प्रॉडक्ट में इस्तेमाल करना है उनके लिए पैकेज जोड़ें आपका ऐप्लिकेशन. उदाहरण के लिए, Firebase Authentication और Firebase Realtime Database:
      FirebaseAuth.unitypackage और FirebaseDatabase.unitypackage

    Analytics चालू नहीं है

    उन Firebase प्रॉडक्ट के पैकेज जोड़ें जिनका इस्तेमाल आपको अपने ऐप्लिकेशन में करना है. उदाहरण के लिए, Firebase Authentication और Firebase Realtime Database का इस्तेमाल करने के लिए:
    FirebaseAuth.unitypackage और FirebaseDatabase.unitypackage

  4. Unity पैकेज को इंपोर्ट करें विंडो में, इंपोर्ट करें पर क्लिक करें.

  5. Firebase कंसोल में वापस जाकर, सेटअप वर्कफ़्लो में, आगे बढ़ें पर क्लिक करें.

पांचवां चरण: Google Play services के वर्शन की ज़रूरी शर्तों की पुष्टि करें

Android के लिए, Firebase Unity SDK टूल का इस्तेमाल करना ज़रूरी है Google Play services, जिसमें अप-टू-डेट होना चाहिए, ताकि SDK टूल इस्तेमाल किया जा सके.

अपनेusing का इस्तेमाल करें. Google Play services को देखा जा सकता है और वैकल्पिक तौर पर अपडेट किया जा सकता है किसी अन्य को कॉल करने से पहले, Firebase Unity SDK टूल के लिए ज़रूरी वर्शन तरीकों का इस्तेमाल करना होगा.

using Firebase.Extensions;
Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWithOnMainThread(task => {
  var dependencyStatus = task.Result;
  if (dependencyStatus == Firebase.DependencyStatus.Available) {
    // Create and hold a reference to your FirebaseApp,
    // where app is a Firebase.FirebaseApp property of your application class.
       app = Firebase.FirebaseApp.DefaultInstance;

    // Set a flag here to indicate whether Firebase is ready to use by your app.
  } else {
    UnityEngine.Debug.LogError(System.String.Format(
      "Could not resolve all Firebase dependencies: {0}", dependencyStatus));
    // Firebase Unity SDK is not safe to use here.
  }
});

अब इसे इस्तेमाल किया जा सकता है! आपका Unity प्रोजेक्ट, Firebase का इस्तेमाल करने के लिए रजिस्टर और कॉन्फ़िगर किया गया हो.

अगर आपको सेट अप करने में समस्या आ रही है, तो इस लिंक पर जाएं Unity की समस्या का हल और अक्सर पूछे जाने वाले सवाल.

डेस्कटॉप वर्कफ़्लो सेट अप करना (बीटा वर्शन)

जब आप कोई गेम बनाते हैं, तो अक्सर सबसे पहले Unity एडिटर और डेस्कटॉप प्लैटफ़ॉर्म पर. इसके बाद, मोबाइल पर डिप्लॉय और टेस्ट करें जिन्हें बाद में डेवलप किया गया. इस वर्कफ़्लो में मदद करने के लिए, हम Firebase Unity SDK टूल का सबसेट जो चल सकता है यह ऐप्लिकेशन, Windows, macOS, Linux, और Unity एडिटर से खरीदा जा सकता है.

  1. मोबाइल प्लैटफ़ॉर्म के लिए दिए गए निर्देशों का पालन करके, डेस्कटॉप प्लैटफ़ॉर्म के लिए Unity प्रोजेक्ट सेट अप करें. इसके लिए, ऊपर दिए गए Firebase के साथ अपना ऐप्लिकेशन रजिस्टर करें चरण से शुरू करें.

  2. Unity IDE में अपना Unity प्रोजेक्ट चलाएं या अपना Unity बनाने के लिए चुनें डेस्कटॉप का प्रोजेक्ट.

  3. (ज़रूरी नहीं) अपने Unity प्रोजेक्ट को बदलाव मोड में चलाएं.

    Firebase Unity SDK टूल को Unity के एडिट मोड में भी चलाया जा सकता है. इससे, एडिटर प्लग इन में इसका इस्तेमाल किया जा सकता है.

    1. जब एडिटर ऐसा FirebaseApp बनाते हैं, तो इसका इस्तेमाल न करें डिफ़ॉल्ट इंस्टेंस.

    2. इसके बजाय, FirebaseApp.Create() कॉल को कोई यूनीक नाम दें.

      यह ज़रूरी है, ताकि Unity IDE और आपके Unity प्रोजेक्ट के बीच, विकल्पों में कोई टकराव न हो.

इस्तेमाल किए जा सकने वाले Firebase प्रॉडक्ट

Unity Firebase लाइब्रेरी के बारे में यहां ज़्यादा जानें रेफ़रंस दस्तावेज़.

मोबाइल के लिए उपलब्ध Firebase लाइब्रेरी

Firebase Unity SDK टूल, Apple और Android पर Firebase के इन प्रॉडक्ट के साथ काम करता है:

Firebase प्रॉडक्ट Unity पैकेज
AdMob AdMob Unity प्लगिन में अलग से उपलब्ध कराए जाते हैं
Analytics FirebaseAnalytics.unitypackage
App Check FirebaseAppCheck.unitypackage
Authentication FirebaseAuth.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
Cloud Functions FirebaseFunctions.unitypackage
Cloud Messaging FirebaseMessaging.unitypackage
(सुझाया गया) FirebaseAnalytics.unitypackage
Cloud Storage FirebaseStorage.unitypackage
Crashlytics FirebaseCrashlytics.unitypackage
(सुझाया गया) FirebaseAnalytics.unitypackage
Dynamic Links FirebaseDynamicLinks.unitypackage
(सुझाया गया) FirebaseAnalytics.unitypackage
Realtime Database FirebaseDatabase.unitypackage
Remote Config FirebaseRemoteConfig.unitypackage
(सुझाया गया) FirebaseAnalytics.unitypackage

डेस्कटॉप के लिए उपलब्ध Firebase लाइब्रेरी

Firebase Unity SDK टूल में, डेस्कटॉप वर्कफ़्लो सहायता शामिल है Firebase के कुछ हिस्सों का इस्तेमाल Windows, macOS, और Linux पर, Unity एडिटर और इन स्टैंडअलोन डेस्कटॉप में बनाया गया ऐप्लिकेशन.

Firebase प्रॉडक्ट (डेस्कटॉप) Unity पैकेज
App Check FirebaseAppCheck.unitypackage
Authentication FirebaseAuth.unitypackage
Cloud Functions FirebaseFunctions.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
Cloud Storage FirebaseStorage.unitypackage
Realtime Database FirebaseDatabase.unitypackage
Remote Config FirebaseRemoteConfig.unitypackage

Firebase, Windows, macOS, और Linux के लिए बिल्ड करते समय, बाकी डेस्कटॉप लाइब्रेरी को स्टब (काम न करने वाले) के तौर पर लागू करता है. इसलिए, आपको डेस्कटॉप को टारगेट करने के लिए, शर्तों के साथ कोड कंपाइल करने की ज़रूरत नहीं है.

अगले चरण