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

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

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

   आपके Unity प्रोजेक्ट का आईडी, बंडल आइडेंटिफ़ायर की वैल्यू होती है (उदाहरण के लिए, आईडी: 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 प्रोजेक्ट की प्रोजेक्ट विंडो खोलें, फिर अपनी कॉन्फ़िगरेशन फ़ाइल(फ़ाइलों) को 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 प्रोजेक्ट चलाएं या 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 लाइब्रेरी

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

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

अगले चरण

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

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

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

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