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

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

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

MechaHamster (GitHub)

MechaHamster (App Store)

MechaHamster (Play Store)

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

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

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

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

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

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

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

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

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

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

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

    iOS या tvOS पर Cloud Messaging का इस्तेमाल करने के लिए, ये ज़रूरी शर्तें पूरी करनी होंगी:

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

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

• अपने Google खाते का इस्तेमाल करके, Firebase में साइन इन करें.

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

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

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

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

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

1. Firebase console पर जाएं.

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

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

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

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

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

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

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

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

   • iOS के लिए — बिल्ड सेटिंग > iOS पर जाएं.

   • Android के लिए — Android > प्लेयर सेटिंग > अन्य सेटिंग पर जाएं.

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

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

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

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

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

   • iOS के लिए — 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 टूल डाउनलोड करें पर क्लिक करें. इसके बाद, एसडीके को अपनी सुविधा के हिसाब से अनज़िप करें.

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

   • Firebase Unity SDK टूल, किसी खास प्लैटफ़ॉर्म के लिए नहीं है.

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

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 टूल का इस्तेमाल करने से पहले, यह ज़रूरी है कि Google Play services अप-टू-डेट हो.

अपने ऐप्लिकेशन की शुरुआत में, यह 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 लाइब्रेरी

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

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

अगले चरण

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

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

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

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