हमारे फायरबेस यूनिटी एसडीके के साथ अपने यूनिटी गेम्स को सशक्त बनाएं।
यह दिखाने के लिए कि आपके यूनिटी प्रोजेक्ट में फायरबेस को प्लग करना कितना आसान है, हमने एक नमूना गेम, मेचाहैम्स्टर बनाया। यदि आप किसी गेम में फायरबेस जोड़ने का प्रयास करना चाहते हैं, तो GitHub पर मौजूद स्टार्टर संस्करण का उपयोग करें। यदि आप पूर्ण संस्करण चाहते हैं, तो ऐप स्टोर या Google Play स्टोर में संस्करण देखें।
हमारे फायरबेस गेम्स पेज पर फायरबेस के साथ अपने गेम को सशक्त बनाने के बारे में अधिक जानकारी प्राप्त करें।
क्या आपने पहले ही अपने यूनिटी प्रोजेक्ट में फ़ायरबेस जोड़ लिया है? सुनिश्चित करें कि आप फायरबेस यूनिटी एसडीके के नवीनतम संस्करण का उपयोग कर रहे हैं।
आवश्यक शर्तें
यूनिटी 2019.1 या बाद का संस्करण स्थापित करें। पुराने संस्करण भी संगत हो सकते हैं लेकिन सक्रिय रूप से समर्थित नहीं होंगे। यूनिटी 2019.1 के लिए समर्थन को अप्रचलित माना जाता है, और अगली बड़ी रिलीज़ के बाद इसे सक्रिय रूप से समर्थित नहीं किया जाएगा।
(केवल Apple प्लेटफ़ॉर्म) निम्नलिखित इंस्टॉल करें:
- Xcode 13.3.1 या उच्चतर
- कोकोपोड्स 1.10.0 या उच्चतर
सुनिश्चित करें कि आपका यूनिटी प्रोजेक्ट इन आवश्यकताओं को पूरा करता है:
- iOS के लिए - iOS 11 या उच्चतर को लक्षित करता है
- टीवीओएस के लिए - टीवीओएस 12 या उच्चतर को लक्षित करता है
- एंड्रॉइड के लिए - एपीआई स्तर 19 (किटकैट) या उच्चतर लक्ष्य
अपना ऐप चलाने के लिए एक भौतिक उपकरण सेट करें या एक एमुलेटर का उपयोग करें।
Apple प्लेटफ़ॉर्म के लिए - एक भौतिक डिवाइस सेट करें या iOS या tvOS सिम्युलेटर का उपयोग करें।
आईओएस या टीवीओएस पर क्लाउड मैसेजिंग के लिए, यहां आवश्यक शर्तें हैं:
- एक भौतिक उपकरण स्थापित करें.
- अपने Apple डेवलपर खाते के लिए Apple पुश अधिसूचना प्रमाणीकरण कुंजी प्राप्त करें।
- ऐप > क्षमताओं के अंतर्गत XCode में पुश नोटिफिकेशन सक्षम करें।
एंड्रॉइड के लिए - एमुलेटर्स को Google Play के साथ एक एमुलेटर छवि का उपयोग करना होगा।
- अपने Google खाते का उपयोग करके फायरबेस में साइन इन करें ।
यदि आपके पास पहले से कोई यूनिटी प्रोजेक्ट नहीं है और आप केवल फायरबेस उत्पाद आज़माना चाहते हैं, तो आप हमारे क्विकस्टार्ट नमूनों में से एक डाउनलोड कर सकते हैं।
चरण 1 : एक फायरबेस प्रोजेक्ट बनाएं
इससे पहले कि आप अपने यूनिटी प्रोजेक्ट में फायरबेस जोड़ सकें, आपको अपने यूनिटी प्रोजेक्ट से जुड़ने के लिए एक फायरबेस प्रोजेक्ट बनाना होगा। फायरबेस प्रोजेक्ट्स के बारे में अधिक जानने के लिए फायरबेस प्रोजेक्ट्स को समझें पर जाएँ।
चरण 2 : अपने ऐप को फायरबेस के साथ पंजीकृत करें
आप अपने फायरबेस प्रोजेक्ट से जुड़ने के लिए एक या अधिक ऐप्स या गेम पंजीकृत कर सकते हैं।
फायरबेस कंसोल पर जाएं।
प्रोजेक्ट अवलोकन पृष्ठ के केंद्र में, सेटअप वर्कफ़्लो लॉन्च करने के लिए यूनिटी आइकन (
) पर क्लिक करें।यदि आपने पहले से ही अपने फायरबेस प्रोजेक्ट में एक ऐप जोड़ा है, तो प्लेटफ़ॉर्म विकल्प प्रदर्शित करने के लिए ऐप जोड़ें पर क्लिक करें।
चुनें कि आपके यूनिटी प्रोजेक्ट का कौन सा निर्माण लक्ष्य आप पंजीकृत करना चाहते हैं, या आप एक ही समय में दोनों लक्ष्यों को पंजीकृत करने का चयन भी कर सकते हैं।
अपने यूनिटी प्रोजेक्ट की प्लेटफ़ॉर्म-विशिष्ट आईडी दर्ज करें।
आईओएस के लिए - आईओएस बंडल आईडी फ़ील्ड में अपने यूनिटी प्रोजेक्ट की आईओएस आईडी दर्ज करें।
एंड्रॉइड के लिए - एंड्रॉइड पैकेज नाम फ़ील्ड में अपने यूनिटी प्रोजेक्ट की एंड्रॉइड आईडी दर्ज करें।
पैकेज नाम और एप्लिकेशन आईडी शब्द अक्सर एक दूसरे के स्थान पर उपयोग किए जाते हैं।
अपनी यूनिटी आईडीई में अपना यूनिटी प्रोजेक्ट खोलें, फिर प्रत्येक प्लेटफ़ॉर्म के लिए सेटिंग अनुभाग पर जाएँ:
iOS के लिए - बिल्ड सेटिंग्स > iOS पर नेविगेट करें।
एंड्रॉइड के लिए - एंड्रॉइड > प्लेयर सेटिंग्स > अन्य सेटिंग्स पर नेविगेट करें।
आपके यूनिटी प्रोजेक्ट की आईडी बंडल आइडेंटिफ़ायर मान है (उदाहरण आईडी:
com.yourcompany.yourproject
)।(वैकल्पिक) अपने यूनिटी प्रोजेक्ट के प्लेटफ़ॉर्म-विशिष्ट उपनाम दर्ज करें।
ये उपनाम आंतरिक, सुविधा पहचानकर्ता हैं और केवल फायरबेस कंसोल में आपको दिखाई देते हैं।ऐप रजिस्टर करें पर क्लिक करें.
चरण 3 : फायरबेस कॉन्फ़िगरेशन फ़ाइलें जोड़ें
फ़ायरबेस कंसोल सेटअप वर्कफ़्लो में अपनी प्लेटफ़ॉर्म-विशिष्ट फ़ायरबेस कॉन्फ़िगरेशन फ़ाइल प्राप्त करें।
iOS के लिए - GoogleService-Info.plist डाउनलोड करें पर क्लिक करें।
एंड्रॉइड के लिए - डाउनलोड google-services.json पर क्लिक करें।
फायरबेस कॉन्फ़िगरेशन फ़ाइल में आपके प्रोजेक्ट के लिए अद्वितीय, लेकिन गैर-गुप्त पहचानकर्ता शामिल हैं। इस कॉन्फ़िगरेशन फ़ाइल के बारे में अधिक जानने के लिए, फ़ायरबेस प्रोजेक्ट्स को समझें पर जाएँ।
आप किसी भी समय अपनी फायरबेस कॉन्फ़िगरेशन फ़ाइल को दोबारा डाउनलोड कर सकते हैं।
सुनिश्चित करें कि कॉन्फ़िगरेशन फ़ाइल नाम अतिरिक्त वर्णों, जैसे
(2)
के साथ नहीं जोड़ा गया है।
अपने यूनिटी प्रोजेक्ट की प्रोजेक्ट विंडो खोलें, फिर अपनी कॉन्फ़िगरेशन फ़ाइल को
Assets
फ़ोल्डर में ले जाएँ।फ़ायरबेस कंसोल में वापस, सेटअप वर्कफ़्लो में, अगला क्लिक करें।
चरण 4 : फायरबेस यूनिटी एसडीके जोड़ें
फ़ायरबेस कंसोल में, डाउनलोड फ़ायरबेस यूनिटी एसडीके पर क्लिक करें, फिर एसडीके को किसी सुविधाजनक स्थान पर अनज़िप करें।
आप किसी भी समय फायरबेस यूनिटी एसडीके को दोबारा डाउनलोड कर सकते हैं।
फायरबेस यूनिटी एसडीके प्लेटफ़ॉर्म-विशिष्ट नहीं है।
अपने खुले यूनिटी प्रोजेक्ट में, एसेट्स > इंपोर्ट पैकेज > कस्टम पैकेज पर नेविगेट करें।
अनज़िप्ड एसडीके से, समर्थित फायरबेस उत्पादों का चयन करें जिन्हें आप अपने ऐप में उपयोग करना चाहते हैं।
एनालिटिक्स सक्षम
- Google Analytics के लिए Firebase पैकेज जोड़ें:
FirebaseAnalytics.unitypackage
- किसी भी अन्य फायरबेस उत्पाद के लिए पैकेज जोड़ें जिसे आप अपने ऐप में उपयोग करना चाहते हैं। उदाहरण के लिए, फायरबेस प्रमाणीकरण और फायरबेस रीयलटाइम डेटाबेस का उपयोग करने के लिए:
FirebaseAuth.unitypackage
औरFirebaseDatabase.unitypackage
एनालिटिक्स सक्षम नहीं है
उन फ़ायरबेस उत्पादों के लिए पैकेज जोड़ें जिन्हें आप अपने ऐप में उपयोग करना चाहते हैं। उदाहरण के लिए, फायरबेस प्रमाणीकरण और फायरबेस रीयलटाइम डेटाबेस का उपयोग करने के लिए:
FirebaseAuth.unitypackage
औरFirebaseDatabase.unitypackage
- Google Analytics के लिए Firebase पैकेज जोड़ें:
आयात एकता पैकेज विंडो में, आयात पर क्लिक करें।
फ़ायरबेस कंसोल में वापस, सेटअप वर्कफ़्लो में, अगला क्लिक करें।
चरण 5 : Google Play सेवाओं की संस्करण आवश्यकताओं की पुष्टि करें
एंड्रॉइड के लिए फायरबेस यूनिटी एसडीके के लिए Google Play सेवाओं की आवश्यकता होती है, जो एसडीके का उपयोग करने से पहले अद्यतित होनी चाहिए।
अपने एप्लिकेशन की शुरुआत में निम्नलिखित कोड जोड़ें। आप एसडीके में किसी भी अन्य तरीके को कॉल करने से पहले 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. } });
तुम सब सेट हो! आपका यूनिटी प्रोजेक्ट फायरबेस का उपयोग करने के लिए पंजीकृत और कॉन्फ़िगर किया गया है।
हालाँकि, यदि आपको सेट अप करने में परेशानी हो रही है, तो यूनिटी समस्या निवारण और FAQ पर जाएँ।
डेस्कटॉप वर्कफ़्लो सेट करें ( बीटा )
जब आप कोई गेम बना रहे होते हैं, तो पहले यूनिटी एडिटर और डेस्कटॉप प्लेटफ़ॉर्म पर अपने गेम का परीक्षण करना, फिर बाद में विकास के दौरान मोबाइल उपकरणों पर तैनात करना और परीक्षण करना अक्सर आसान होता है। इस वर्कफ़्लो का समर्थन करने के लिए, हम फायरबेस यूनिटी एसडीके का एक सबसेट प्रदान करते हैं जो विंडोज़, मैकओएस, लिनक्स और यूनिटी संपादक के भीतर से चल सकता है।
मोबाइल प्लेटफ़ॉर्म के समान निर्देशों का पालन करके एक डेस्कटॉप-प्लेटफ़ॉर्म यूनिटी प्रोजेक्ट सेट करें (ऊपर दिए गए फायरबेस चरण के साथ अपने ऐप को पंजीकृत करें से शुरू करें)।
अपने यूनिटी प्रोजेक्ट को यूनिटी आईडीई में चलाएं या डेस्कटॉप के लिए अपना यूनिटी प्रोजेक्ट बनाने का चयन करें।
(वैकल्पिक) अपने यूनिटी प्रोजेक्ट को संपादन मोड में चलाएं।
फायरबेस यूनिटी एसडीके को यूनिटी के संपादन मोड में भी चलाया जा सकता है, जिससे संपादक प्लगइन्स में इसके उपयोग की अनुमति मिलती है।
जब आप संपादक द्वारा उपयोग किया जाने वाला
FirebaseApp
बनाते हैं, तो डिफ़ॉल्ट इंस्टेंस का उपयोग न करें।इसके बजाय,
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 |
विंडोज़, मैकओएस और लिनक्स के लिए निर्माण करते समय फायरबेस शेष डेस्कटॉप लाइब्रेरी को सुविधा के लिए स्टब (गैर-कार्यात्मक) कार्यान्वयन के रूप में प्रदान करता है। इसलिए, आपको डेस्कटॉप को लक्षित करने के लिए सशर्त रूप से कोड संकलित करने की आवश्यकता नहीं है।
अगले कदम
नमूना फायरबेस ऐप्स का अन्वेषण करें।
अपना ऐप लॉन्च करने की तैयारी करें:
- Google क्लाउड कंसोल में अपने प्रोजेक्ट के लिए बजट अलर्ट सेट करें।
- कई फायरबेस सेवाओं में अपने प्रोजेक्ट के उपयोग की समग्र तस्वीर प्राप्त करने के लिए फायरबेस कंसोल में उपयोग और बिलिंग डैशबोर्ड की निगरानी करें।
- फायरबेस लॉन्च चेकलिस्ट की समीक्षा करें।
क्या फायरबेस और आपके यूनिटी प्रोजेक्ट में परेशानी आ रही है? यूनिटी समस्या निवारण और FAQ पर जाएँ।