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

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

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

MechaHamster (GitHub)

MechaHamster (ऐप स्टोर)

MechaHamster (Play Store)


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

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

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

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

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

    • Xcode 13.3.1 या इसके बाद का वर्शन
    • CocoaPods 1.12.0 या उसके बाद का वर्शन

  • पक्का करें कि आपका Unity प्रोजेक्ट इन ज़रूरी शर्तों को पूरा करता हो:

    • iOS के लिए — iOS 13 या उसके बाद के वर्शन को टारगेट करता है
    • tvOS के लिए - यह tvOS 13 या उसके बाद के वर्शन को टारगेट करता है
    • Android के लिए — एपीआई लेवल 19 को टारगेट करता है (KitKat) या उससे ज़्यादा

  • अपना ऐप्लिकेशन चलाने के लिए, एक फ़िज़िकल डिवाइस सेट अप करें या एम्युलेटर का इस्तेमाल करें.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. Firebase कंसोल में, Firebase Unity 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 टूल, इन Firebase प्रॉडक्ट के साथ काम करता है: Apple और Android:

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 के लिए फ़ाइलें बनाई जा सकें. इसलिए, आपको डेस्कटॉप को टारगेट करने के लिए, शर्तों के साथ कोड कंपाइल करने की ज़रूरत नहीं है.

अगले चरण