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

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

हमने एक सैंपल गेम, MechaHamster बनाया है. इससे यह पता चलता है कि Firebase को अपने Unity प्रोजेक्ट में जोड़ना कितना आसान है. अगर आप 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 प्रोजेक्ट बनाना

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

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

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

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

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

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

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

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

    • iOS के लिएiOS बंडल आईडी फ़ील्ड में, अपने Unity प्रोजेक्ट का 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 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 स्टेटमेंट और इनिशियलाइज़ेशन कोड जोड़ें. SDK टूल में किसी भी दूसरे तरीके को कॉल करने से पहले, 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. Editor में इस्तेमाल किया जाने वाला 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 के लिए बिल्ड करते समय, बाकी डेस्कटॉप लाइब्रेरी को स्टब (काम न करने वाले) के तौर पर लागू करता है. इसलिए, आपको डेस्कटॉप को टारगेट करने के लिए, शर्तों के साथ कोड कंपाइल करने की ज़रूरत नहीं है.

अगले चरण