अपने 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 2021 LTS या इसके बाद का वर्शन इंस्टॉल करें. ऐसा हो सकता है कि इसके पुराने वर्शन भी काम करें, लेकिन उन पर यह सुविधा पूरी तरह से काम नहीं करेगी.

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

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

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

  • iOS के लिए — iOS 15 या इसके बाद के वर्शन को टारगेट करता है
  • tvOS के लिए - tvOS 15 या इसके बाद के वर्शन को टारगेट करता है
  • Android के लिए — एपीआई लेवल 24 (Nougat) या इसके बाद के वर्शन को टारगेट करता है

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

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

    क्या आपको Cloud Messaging का इस्तेमाल करना है?

    iOS या tvOS पर Cloud Messaging के लिए, ये ज़रूरी शर्तें हैं:

    • फ़िज़िकल डिवाइस सेट अप करें.
    • अपने Apple Developer खाते के लिए, Apple Push Notification Authentication Key पाएं.
    • XCode में पुश नोटिफ़िकेशन चालू करने के लिए, App > Capabilities पर जाएं.

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

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

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

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

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

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

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

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

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

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

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

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

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

   आपको अपने Unity प्रोजेक्ट का आईडी कहां मिलेगा?

   अपने Unity IDE में Unity प्रोजेक्ट खोलें. इसके बाद, हर प्लैटफ़ॉर्म के लिए सेटिंग सेक्शन पर जाएं:

   • iOS के लिए — Build Settings > iOS पर जाएं.

   • Android के लिए — Android > Player Settings > Other Settings पर जाएं.

   आपके Unity प्रोजेक्ट का आईडी, बंडल आइडेंटिफ़ायर की वैल्यू होती है (आईडी का उदाहरण: com.yourcompany.yourproject).

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

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

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

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

   • iOS के लिए — Download GoogleService-Info.plist पर क्लिक करें.

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

   इस कॉन्फ़िगरेशन फ़ाइल के बारे में आपको क्या जानना चाहिए?

   • Firebase की कॉन्फ़िगरेशन फ़ाइल में, आपके प्रोजेक्ट और ऐप्लिकेशन के लिए यूनीक, लेकिन सार्वजनिक आइडेंटिफ़ायर होते हैं. इस कॉन्फ़िगरेशन फ़ाइल के बारे में ज़्यादा जानने के लिए, Firebase प्रोजेक्ट को समझना लेख पढ़ें.

   • आपके पास किसी भी समय, Firebase कॉन्फ़िगरेशन फ़ाइल को फिर से डाउनलोड करने का विकल्प होता है.

   • पक्का करें कि कॉन्फ़िगरेशन फ़ाइल के नाम में (2) जैसे अतिरिक्त वर्ण न जोड़े गए हों.

2. अपने Unity प्रोजेक्ट की Project विंडो खोलें. इसके बाद, अपनी कॉन्फ़िगरेशन फ़ाइल या फ़ाइलों को 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 के वर्शन से जुड़ी ज़रूरी शर्तों की पुष्टि करना

Android के लिए Firebase Unity SDK में मौजूद कुछ प्रॉडक्ट के लिए, 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 लाइब्रेरी

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

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

अगले चरण

• सैंपल Firebase ऐप्लिकेशन एक्सप्लोर करें.

• अपना ऐप्लिकेशन लॉन्च करने के लिए तैयार हो जाएं:

  • Google Cloud कंसोल में अपने प्रोजेक्ट के लिए, बजट से जुड़ी सूचनाएं सेट अप करें.
  • Firebase कंसोल में इस्तेमाल और बिलिंग डैशबोर्ड पर नज़र रखें. इससे आपको Firebase की कई सेवाओं में, अपने प्रोजेक्ट के इस्तेमाल की पूरी जानकारी मिलेगी.
  • Firebase लॉन्च चेकलिस्ट देखें.

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