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

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

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

MechaHamster (GitHub)

MechaHamster (ऐप स्टोर)

MechaHamster (Play Store)


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

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

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

  • Unity 2019.1 या इसके बाद का वर्शन इंस्टॉल करें. पुराने वर्शन भी काम कर सकते हैं, लेकिन वे काम नहीं करेंगे. Unity 2019.1 के लिए यह सुविधा अब बंद कर दी गई है और यह अगली बड़ी रिलीज़ के बाद काम नहीं करेगी.

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

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

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

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

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

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

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

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

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

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

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

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

    • Firebase यूनिटी SDK टूल, प्लैटफ़ॉर्म के हिसाब से नहीं होता.

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

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

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

    • Google Analytics के लिए Firebase पैकेज जोड़ें: FirebaseAnalytics.unitypackage
    • आपको अपने ऐप्लिकेशन में जिन Firebase प्रॉडक्ट का इस्तेमाल करना है उनके लिए पैकेज जोड़ें. उदाहरण के लिए, Firebase से पुष्टि करने की सुविधा और Firebase रीयल टाइम डेटाबेस का इस्तेमाल करने के लिए:
      FirebaseAuth.unitypackage और FirebaseDatabase.unitypackage

    Analytics चालू नहीं है

    Firebase के उन प्रॉडक्ट के पैकेज जोड़ें जिनका इस्तेमाल आपको अपने ऐप्लिकेशन में करना है. उदाहरण के लिए, Firebase से पुष्टि करने की सुविधा और Firebase रीयल टाइम डेटाबेस का इस्तेमाल करने के लिए:
    FirebaseAuth.unitypackage और FirebaseDatabase.unitypackage

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

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

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

Android के लिए, Firebase Unity 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 से जुड़ी समस्या हल करने और अक्सर पूछे जाने वाले सवाल पर जाएं.

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

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

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

  2. Unity IDE में अपना Unity प्रोजेक्ट चलाएं या desktop के लिए 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 यूनिटी प्लगिन में अलग से डिस्ट्रिब्यूट किया जाता है
Analytics FirebaseAnalytics.unitypackage
ऐप्लिकेशन की जांच FirebaseAppCheck.unitypackage
पुष्टि करना FirebaseAuth.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
Cloud के फ़ंक्शन FirebaseFunctions.unitypackage
क्लाउड से मैसेज FirebaseMessaging.unitypackage
(सुझाया गया) FirebaseAnalytics.unitypackage
क्लाउड स्टोरेज FirebaseStorage.unitypackage
Crashlytics FirebaseCrashlytics.unitypackage
(सुझाया गया) FirebaseAnalytics.unitypackage
डाइनैमिक लिंक FirebaseDynamicLinks.unitypackage
(सुझाया गया) FirebaseAnalytics.unitypackage
रीयलटाइम डेटाबेस FirebaseDatabase.unitypackage
रिमोट कॉन्फ़िगरेशन FirebaseRemoteConfig.unitypackage
(सुझाया गया) FirebaseAnalytics.unitypackage

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

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

Firebase प्रॉडक्ट (डेस्कटॉप) Unity पैकेज
ऐप्लिकेशन की जांच FirebaseAppCheck.unitypackage
पुष्टि करना FirebaseAuth.unitypackage
Cloud के फ़ंक्शन FirebaseFunctions.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
क्लाउड स्टोरेज FirebaseStorage.unitypackage
रीयलटाइम डेटाबेस FirebaseDatabase.unitypackage
रिमोट कॉन्फ़िगरेशन FirebaseRemoteConfig.unitypackage

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

अगले चरण