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

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

यह दिखाने के लिए कि आपके यूनिटी प्रोजेक्ट में फायरबेस को प्लग करना कितना आसान है, हमने एक नमूना गेम, मेचाहैम्स्टर बनाया। यदि आप किसी गेम में फायरबेस जोड़ने का प्रयास करना चाहते हैं, तो GitHub पर मौजूद स्टार्टर संस्करण का उपयोग करें। यदि आप पूर्ण संस्करण चाहते हैं, तो ऐप स्टोर या Google Play स्टोर में संस्करण देखें।

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

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

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


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

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

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

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

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

    • Xcode 13.3.1 या उच्चतर
    • कोकोपोड्स 1.12.0 या उच्चतर
  • सुनिश्चित करें कि आपका यूनिटी प्रोजेक्ट इन आवश्यकताओं को पूरा करता है:

    • iOS के लिए - iOS 11 या उच्चतर को लक्षित करता है
    • टीवीओएस के लिए - टीवीओएस 12 या उच्चतर को लक्षित करता है
    • एंड्रॉइड के लिए - एपीआई स्तर 19 (किटकैट) या उच्चतर लक्ष्य
  • अपना ऐप चलाने के लिए एक भौतिक उपकरण सेट करें या एक एमुलेटर का उपयोग करें।

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

    • एंड्रॉइड के लिए - एमुलेटर्स को Google Play के साथ एक एमुलेटर छवि का उपयोग करना होगा।

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    एनालिटिक्स सक्षम

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

    एनालिटिक्स सक्षम नहीं है

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

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

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

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

एंड्रॉइड के लिए फायरबेस यूनिटी एसडीके के लिए Google Play सेवाओं की आवश्यकता होती है, जो एसडीके का उपयोग करने से पहले अद्यतित होनी चाहिए।

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

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.
  }
});

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

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

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

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

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

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

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

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

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

    2. इसके बजाय, FirebaseApp.Create() कॉल को एक अद्वितीय नाम प्रदान करें।

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

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

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

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

फायरबेस यूनिटी एसडीके ऐप्पल और एंड्रॉइड पर निम्नलिखित फायरबेस उत्पादों का समर्थन करता है:

फायरबेस उत्पाद एकता पैकेज
AdMob AdMob Unity Plugin में अलग से वितरित किया गया
एनालिटिक्स FirebaseAnalytics.unitypackage
ऐप जांचें FirebaseAppCheck.unitypackage
प्रमाणीकरण FirebaseAuth.unitypackage
क्लाउड फायरस्टोर FirebaseFirestore.unitypackage
क्लाउड फ़ंक्शंस FirebaseFunctions.unitypackage
क्लाउड मैसेजिंग FirebaseMessaging.unitypackage
(अनुशंसित) FirebaseAnalytics.unitypackage
घन संग्रहण FirebaseStorage.unitypackage
क्रैशलिटिक्स 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

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

अगले कदम