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

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

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

MechaHamster (GitHub)

MechaHamster (App Store)

MechaHamster (Play Store)


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

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

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

  • Unity 2022 LTS या इसके बाद का वर्शन इंस्टॉल करें. ऐसा हो सकता है कि पुराने वर्शन भी काम करें, लेकिन उन पर पूरी तरह से सहायता नहीं मिलेगी.

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

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

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

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

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

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

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

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

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

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

  1. Firebase कंसोल पर जाएं.

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

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

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

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

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

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

  5. ज़रूरी नहीं: अपने Unity प्रोजेक्ट के प्लैटफ़ॉर्म के हिसाब से निकनेम डालें.
    ये निकनेम, इंटरनल और सुविधा के लिए इस्तेमाल किए जाने वाले आइडेंटिफ़ायर हैं. ये सिर्फ़ आपको Firebase कंसोल में दिखते हैं.

  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 प्रोजेक्ट में, Assets > Import Package > Custom Package पर जाएं.

  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. Import Unity Package विंडो में, Import पर क्लिक करें.

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

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

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

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

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 प्लगिन में अलग से उपलब्ध है
Firebase AI Logic FirebaseAI.unitypackage
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
Realtime Database FirebaseDatabase.unitypackage
Remote Config FirebaseRemoteConfig.unitypackage
(सुझाया गया) FirebaseAnalytics.unitypackage
इस्तेमाल से बाहर हो चुकी या काम न करने वाली लाइब्रेरी
Dynamic Links FirebaseDynamicLinks.unitypackage
(सुझाया गया) FirebaseAnalytics.unitypackage

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

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

Firebase प्रॉडक्ट (डेस्कटॉप) Unity पैकेज
Firebase AI Logic FirebaseAI.unitypackage
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 के लिए ऐप्लिकेशन बनाते समय आसानी होती है. इसलिए, डेस्कटॉप को टारगेट करने के लिए, आपको शर्त के साथ कोड कंपाइल करने की ज़रूरत नहीं है.

अगले चरण