अपने यूनिटी प्रोजेक्ट में फायरबेस जोड़ें

हमारे फायरबेस यूनिटी एसडीके के साथ अपने यूनिटी गेम्स को पावर दें।

यह दिखाने के लिए कि आपके यूनिटी प्रोजेक्ट में Firebase को प्लग करना कितना आसान है, हमने एक नमूना गेम MechaHamster बनाया है, जिसे आप GitHub , App Store और Google Play Store से डाउनलोड कर सकते हैं।

मेचाहैम्स्टर (गिटहब)

मेचाहैम्स्टर (ऐप स्टोर)

मेचाहैम्स्टर (प्ले स्टोर)

हमारे फायरबेस गेम पेज पर फायरबेस के साथ अपने गेम को सशक्त बनाने के बारे में अधिक जानकारी प्राप्त करें।

आपके यूनिटी प्रोजेक्ट में पहले से ही Firebase जोड़ा गया है? सुनिश्चित करें कि आप Firebase Unity SDK के नवीनतम संस्करण का उपयोग कर रहे हैं।

आवश्यक शर्तें

• एकता 2019.1 या बाद में स्थापित करें। पहले के संस्करण भी संगत हो सकते हैं लेकिन सक्रिय रूप से समर्थित नहीं होंगे। यूनिटी 2019.1 के लिए समर्थन को पदावनत माना जाता है, और अगली बड़ी रिलीज़ के बाद सक्रिय रूप से समर्थित नहीं किया जाएगा।

• (केवल Apple प्लेटफ़ॉर्म) निम्न को स्थापित करें:

  • एक्सकोड 13.3.1 या उच्चतर
  • कोकोआपोड्स 1.10.0 या उच्चतर

• सुनिश्चित करें कि आपकी एकता परियोजना इन आवश्यकताओं को पूरा करती है:

  • आईओएस के लिए - आईओएस 11 या उच्चतर लक्षित करता है
  • TVOS के लिए - TVOS 12 या उच्चतर को लक्षित करता है
  • Android के लिए — लक्ष्य API स्तर 19 (किटकैट) या उच्चतर

• अपने ऐप को चलाने के लिए एक भौतिक उपकरण सेट करें या एक एमुलेटर का उपयोग करें।

  • Apple प्लेटफॉर्म के लिए — भौतिक डिवाइस सेट अप करें या iOS या tvOS सिम्युलेटर का उपयोग करें।

    क्या आप क्लाउड मैसेजिंग का उपयोग करना चाहते हैं?

    आईओएस या टीवीओएस पर क्लाउड मैसेजिंग के लिए, यहां पूर्वापेक्षाएँ हैं:

    • एक भौतिक उपकरण सेट करें।
    • अपने Apple डेवलपर खाते के लिए Apple Push Notification Authentication Key प्राप्त करें।
    • ऐप> क्षमताओं के तहत एक्सकोड में पुश अधिसूचनाएं सक्षम करें।

  • Android के लिए - एमुलेटर को Google Play के साथ एक एमुलेटर छवि का उपयोग करना चाहिए।

• अपने Google खाते का उपयोग करके फायरबेस में साइन इन करें ।

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

चरण 1 : एक फायरबेस प्रोजेक्ट बनाएं

इससे पहले कि आप अपने यूनिटी प्रोजेक्ट में फायरबेस जोड़ सकें, आपको अपने यूनिटी प्रोजेक्ट से कनेक्ट करने के लिए फायरबेस प्रोजेक्ट बनाना होगा। फायरबेस प्रोजेक्ट्स के बारे में अधिक जानने के लिए अंडरस्टैंड फायरबेस प्रोजेक्ट्स पर जाएं।

एक फायरबेस प्रोजेक्ट बनाएं

1. Firebase कंसोल में, प्रोजेक्ट जोड़ें पर क्लिक करें।

   • किसी मौजूदा Google क्लाउड प्रोजेक्ट में Firebase संसाधन जोड़ने के लिए, उसका प्रोजेक्ट नाम दर्ज करें या ड्रॉपडाउन मेनू से उसका चयन करें।

   • एक नया प्रोजेक्ट बनाने के लिए, वांछित प्रोजेक्ट का नाम दर्ज करें। आप प्रोजेक्ट नाम के नीचे प्रदर्शित प्रोजेक्ट आईडी को वैकल्पिक रूप से संपादित भी कर सकते हैं।

2. संकेत मिलने पर, Firebase शर्तों की समीक्षा करें और उन्हें स्वीकार करें.

3. जारी रखें पर क्लिक करें।

4. (वैकल्पिक) अपने प्रोजेक्ट के लिए Google Analytics सेट अप करें, जो आपको निम्न में से किसी भी Firebase उत्पाद का उपयोग करने का एक इष्टतम अनुभव प्रदान करने में सक्षम बनाता है:

   फायरबेस क्रैशलिटिक्स फायरबेस क्लाउड मैसेजिंग

   फायरबेस इन-ऐप मैसेजिंग फायरबेस रिमोट कॉन्फिग

   रिमोट कॉन्फिग वैयक्तिकरण फायरबेस ए / बी परीक्षण

   या तो किसी मौजूदा Google Analytics खाते का चयन करें या एक नया खाता बनाने के लिए।

   यदि आप एक नया खाता बनाते हैं, तो अपना Analytics रिपोर्टिंग स्थान चुनें, फिर अपने प्रोजेक्ट के लिए डेटा साझाकरण सेटिंग और Google Analytics शर्तें स्वीकार करें।

5. यदि आप किसी मौजूदा Google क्लाउड प्रोजेक्ट का उपयोग कर रहे हैं, तो प्रोजेक्ट बनाएं (या Firebase जोड़ें ) पर क्लिक करें।

फायरबेस स्वचालित रूप से आपके फायरबेस प्रोजेक्ट के लिए संसाधनों का प्रावधान करता है। जब प्रक्रिया पूरी हो जाती है, तो आपको Firebase कंसोल में आपके Firebase प्रोजेक्ट के अवलोकन पृष्ठ पर ले जाया जाएगा।

चरण 2 : अपने ऐप को फायरबेस के साथ पंजीकृत करें

आप अपने फायरबेस प्रोजेक्ट से जुड़ने के लिए एक या अधिक ऐप या गेम पंजीकृत कर सकते हैं।

1. फायरबेस कंसोल पर जाएं।

2. प्रोजेक्ट अवलोकन पृष्ठ के केंद्र में, सेटअप वर्कफ़्लो लॉन्च करने के लिए एकता आइकन ( plat_unity ) पर क्लिक करें।

   यदि आप पहले से ही अपने फायरबेस प्रोजेक्ट में एक ऐप जोड़ चुके हैं, तो प्लेटफ़ॉर्म विकल्प प्रदर्शित करने के लिए ऐप जोड़ें पर क्लिक करें।

3. अपनी एकता परियोजना के निर्माण लक्ष्य का चयन करें जिसे आप पंजीकृत करना चाहते हैं, या आप एक ही समय में दोनों लक्ष्यों को पंजीकृत करने के लिए भी चयन कर सकते हैं।

4. अपने यूनिटी प्रोजेक्ट की प्लेटफ़ॉर्म-विशिष्ट आईडी दर्ज करें।

   • आईओएस के लिए - आईओएस बंडल आईडी फील्ड में अपनी यूनिटी प्रोजेक्ट की आईओएस आईडी दर्ज करें।

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

   आपको अपनी एकता परियोजना की आईडी कहां मिलती है?

   अपनी यूनिटी आईडीई में अपना यूनिटी प्रोजेक्ट खोलें, फिर प्रत्येक प्लेटफॉर्म के लिए सेटिंग सेक्शन पर नेविगेट करें:

   • आईओएस के लिए - सेटिंग्स बनाने के लिए नेविगेट करें> आईओएस ।

   • Android के लिए — Android > प्लेयर सेटिंग > अन्य सेटिंग पर नेविगेट करें।

   आपकी एकता परियोजना की आईडी बंडल पहचानकर्ता मान है (उदाहरण आईडी: com.yourcompany.yourproject )।

5. (वैकल्पिक) अपने यूनिटी प्रोजेक्ट के प्लेटफ़ॉर्म-विशिष्ट उपनाम दर्ज करें।
   ये उपनाम आंतरिक, सुविधा पहचानकर्ता हैं और केवल फायरबेस कंसोल में आपको दिखाई देते हैं।

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

चरण 3 : फायरबेस कॉन्फ़िगरेशन फ़ाइलें जोड़ें

1. Firebase कंसोल सेटअप वर्कफ़्लो में अपनी प्लेटफ़ॉर्म-विशिष्ट Firebase कॉन्फ़िगरेशन फ़ाइल प्राप्त करें।

   • iOS के लिए — डाउनलोड GoogleService-Info.plist पर क्लिक करें।

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

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

   • फायरबेस कॉन्फ़िगरेशन फ़ाइल में आपके प्रोजेक्ट के लिए अद्वितीय, लेकिन गैर-गुप्त पहचानकर्ता शामिल हैं। इस कॉन्फ़िगरेशन फ़ाइल के बारे में अधिक जानने के लिए, Firebase Projects को समझें पर जाएं।

   • आप किसी भी समय अपनी फायरबेस कॉन्फ़िगरेशन फ़ाइल को दोबारा डाउनलोड कर सकते हैं।

   • सुनिश्चित करें कि कॉन्फ़िगरेशन फ़ाइल नाम अतिरिक्त वर्णों के साथ नहीं जोड़ा गया है, जैसे (2) .

2. अपने यूनिटी प्रोजेक्ट की प्रोजेक्ट विंडो खोलें, फिर अपनी कॉन्फिग फाइल (फाइलों) को Assets फोल्डर में ले जाएं।

3. Firebase कंसोल में वापस, सेटअप वर्कफ़्लो में, अगला क्लिक करें।

चरण 4 : फायरबेस यूनिटी एसडीके जोड़ें

1. फायरबेस कंसोल में, फायरबेस यूनिटी एसडीके डाउनलोड करें पर क्लिक करें, फिर एसडीके को कहीं सुविधाजनक जगह पर अनज़िप करें।

   • आप किसी भी समय Firebase Unity SDK को फिर से डाउनलोड कर सकते हैं।

   • फायरबेस यूनिटी एसडीके प्लेटफॉर्म-विशिष्ट नहीं है।

2. अपनी खुली एकता परियोजना में, संपत्ति > आयात पैकेज > कस्टम पैकेज पर नेविगेट करें।

3. अनज़िप किए गए SDK से, समर्थित Firebase उत्पादों का चयन करें जिन्हें आप अपने ऐप में उपयोग करना चाहते हैं।

   विश्लेषिकी सक्षम

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

   विश्लेषिकी सक्षम नहीं है

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

4. आयात एकता पैकेज विंडो में, आयात पर क्लिक करें।

5. Firebase कंसोल में वापस, सेटअप वर्कफ़्लो में, अगला क्लिक करें।

चरण 5 : Google Play सेवाओं की संस्करण आवश्यकताओं की पुष्टि करें

Android के लिए Firebase Unity SDK के लिए Google Play सेवाओं की आवश्यकता होती है, जो SDK का उपयोग करने से पहले अप-टू-डेट होनी चाहिए।

अपने आवेदन की शुरुआत में निम्नलिखित कोड जोड़ें। आप एसडीके में किसी अन्य तरीके को कॉल करने से पहले फायरबेस यूनिटी एसडीके द्वारा आवश्यक संस्करण के लिए Google Play सेवाओं की जांच कर सकते हैं और वैकल्पिक रूप से अपडेट कर सकते हैं।

Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWith(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.
  }
});

तुम सब सेट हो! आपका यूनिटी प्रोजेक्ट पंजीकृत है और फायरबेस का उपयोग करने के लिए कॉन्फ़िगर किया गया है।

हालांकि, यदि आपको सेट अप करने में समस्या हो रही है, तो यूनिटी समस्या निवारण और अक्सर पूछे जाने वाले प्रश्न पर जाएं।

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

जब आप एक गेम बना रहे होते हैं, तो पहले यूनिटी एडिटर में और डेस्कटॉप प्लेटफॉर्म पर अपने गेम का परीक्षण करना बहुत आसान होता है, फिर बाद में विकास में मोबाइल उपकरणों पर परिनियोजन और परीक्षण करना। इस वर्कफ़्लो का समर्थन करने के लिए, हम फायरबेस यूनिटी एसडीके का एक सबसेट प्रदान करते हैं जो विंडोज, मैकओएस, लिनक्स और यूनिटी एडिटर के भीतर चल सकता है।

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

2. यूनिटी आईडीई में अपना यूनिटी प्रोजेक्ट चलाएं या डेस्कटॉप के लिए अपना यूनिटी प्रोजेक्ट बनाने के लिए चुनें।

3. (वैकल्पिक) अपने यूनिटी प्रोजेक्ट को एडिट मोड में चलाएं।

   फायरबेस यूनिटी एसडीके को यूनिटी के एडिट मोड में भी चलाया जा सकता है, जिससे एडिटर प्लगइन्स में इसका उपयोग किया जा सकता है।

   1. जब आप संपादक द्वारा उपयोग किया जाने वाला FirebaseApp बनाते हैं, तो डिफ़ॉल्ट उदाहरण का उपयोग न करें।

   2. इसके बजाय, FirebaseApp.Create() कॉल को एक अनूठा नाम दें।

      यूनिटी आईडीई द्वारा उपयोग किए गए इंस्टेंस और आपके यूनिटी प्रोजेक्ट द्वारा उपयोग किए गए इंस्टेंस के बीच विकल्पों में विरोध से बचने के लिए यह महत्वपूर्ण है।

समर्थित फायरबेस उत्पाद

संदर्भ दस्तावेज़ में यूनिटी फायरबेस लाइब्रेरी के बारे में अधिक जानें।

मोबाइल के लिए उपलब्ध फायरबेस लाइब्रेरी

Firebase Unity SDK, Apple और Android पर निम्नलिखित Firebase उत्पादों का समर्थन करता है:

फायरबेस उत्पाद	एकता पैकेज
AdMob	AdMob Unity Plugin में अलग से वितरित किया गया
एनालिटिक्स	FirebaseAnalytics.unitypackage
ऐप चेक	FirebaseAppCheck.unitypackage
प्रमाणीकरण	FirebaseAuth.unitypackage
क्लाउड फायरस्टोर	FirebaseFirestore.unitypackage
क्लाउड फ़ंक्शंस	FirebaseFunctions.unitypackage
क्लाउड मैसेजिंग	FirebaseMessaging.unitypackage (अनुशंसित) FirebaseAnalytics.unitypackage
घन संग्रहण	FirebaseStorage.unitypackage
Crashlytics	FirebaseCrashlytics.unitypackage (अनुशंसित) FirebaseAnalytics.unitypackage
गतिशील लिंक	FirebaseDynamicLinks.unitypackage (अनुशंसित) FirebaseAnalytics.unitypackage
रीयलटाइम डेटाबेस	FirebaseDatabase.unitypackage
दूरस्थ विन्यास	FirebaseRemoteConfig.unitypackage (अनुशंसित) FirebaseAnalytics.unitypackage

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

फायरबेस यूनिटी एसडीके में उत्पादों के एक सबसेट के लिए डेस्कटॉप वर्कफ़्लो सपोर्ट शामिल है, जो फायरबेस के कुछ हिस्सों को यूनिटी संपादक में और विंडोज, मैकओएस और लिनक्स पर स्टैंडअलोन डेस्कटॉप बिल्ड में सक्षम बनाता है।

फायरबेस उत्पाद (डेस्कटॉप)	एकता पैकेज
ऐप चेक	FirebaseAppCheck.unitypackage
प्रमाणीकरण	FirebaseAuth.unitypackage
क्लाउड फ़ंक्शंस	FirebaseFunctions.unitypackage
क्लाउड फायरस्टोर	FirebaseFirestore.unitypackage
घन संग्रहण	FirebaseStorage.unitypackage
रीयलटाइम डेटाबेस	FirebaseDatabase.unitypackage
दूरस्थ विन्यास	FirebaseRemoteConfig.unitypackage

फायरबेस विंडोज, मैकओएस और लिनक्स के लिए निर्माण करते समय सुविधा के लिए स्टब (गैर-कार्यात्मक) कार्यान्वयन के रूप में शेष डेस्कटॉप लाइब्रेरी प्रदान करता है। इसलिए, आपको डेस्कटॉप को लक्षित करने के लिए सशर्त रूप से कोड संकलित करने की आवश्यकता नहीं है।

अगले कदम

• नमूना Firebase ऐप्स एक्सप्लोर करें।

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

  • Google क्लाउड कंसोल में अपने प्रोजेक्ट के लिए बजट अलर्ट सेट अप करें।
  • कई फायरबेस सेवाओं में अपने प्रोजेक्ट के उपयोग की समग्र तस्वीर प्राप्त करने के लिए फायरबेस कंसोल में उपयोग और बिलिंग डैशबोर्ड की निगरानी करें।
  • फायरबेस लॉन्च चेकलिस्ट की समीक्षा करें।

• फायरबेस और आपके यूनिटी प्रोजेक्ट के साथ परेशानी हो रही है? यूनिटी ट्रबलशूटिंग एंड एफएक्यू पर जाएं।