আপনার ইউনিটি প্রকল্পে Firebase যোগ করুন

আমাদের Firebase Unity SDK গুলির সাহায্যে আপনার Unity গেমগুলিকে আরও শক্তিশালী করুন।

আপনার ইউনিটি প্রজেক্টে Firebase প্লাগ করা কতটা সহজ তা দেখানোর জন্য, আমরা একটি নমুনা গেম তৈরি করেছি, MechaHamster। যদি আপনি কোনও গেমে Firebase যোগ করার চেষ্টা করতে চান, তাহলে GitHub- এ থাকা স্টার্টার ভার্সনটি ব্যবহার করুন। যদি আপনি একটি সম্পূর্ণ ভার্সন চান, তাহলে অ্যাপ স্টোর বা Google Play Store ভার্সনগুলি দেখুন।

মেকাহ্যামস্টার (গিটহাব)

মেকাহ্যামস্টার (অ্যাপ স্টোর)

মেকাহ্যামস্টার (প্লে স্টোর)

Firebase দিয়ে আপনার গেমগুলিকে শক্তিশালী করার বিষয়ে আরও তথ্য আমাদের Firebase গেম পৃষ্ঠায় জানুন।

আপনার ইউনিটি প্রজেক্টে কি ইতিমধ্যেই Firebase যোগ করেছেন? নিশ্চিত করুন যে আপনি Firebase Unity SDK এর সর্বশেষ সংস্করণ ব্যবহার করছেন।

পূর্বশর্ত

• ইউনিটি ২০২১ এলটিএস বা তার পরবর্তী সংস্করণ ইনস্টল করুন। পূর্ববর্তী সংস্করণগুলিও সামঞ্জস্যপূর্ণ হতে পারে কিন্তু সক্রিয়ভাবে সমর্থিত হবে না।

• (শুধুমাত্র অ্যাপল প্ল্যাটফর্মের জন্য) নিম্নলিখিতগুলি ইনস্টল করুন:

  • এক্সকোড ১৬.২ বা তার বেশি
  • কোকোপডস ১.১২.০ বা তার বেশি

• নিশ্চিত করুন যে আপনার ইউনিটি প্রকল্পটি এই প্রয়োজনীয়তাগুলি পূরণ করে:

  • iOS-এর জন্য — iOS 15 বা তার উচ্চতর ভার্সনের জন্য
  • tvOS-এর জন্য - tvOS 15 বা তার বেশি ভার্সনের জন্য
  • অ্যান্ড্রয়েডের জন্য — লক্ষ্যমাত্রা API স্তর 23 (মার্শম্যালো) বা উচ্চতর

• আপনার অ্যাপটি চালানোর জন্য একটি ফিজিক্যাল ডিভাইস সেট আপ করুন অথবা একটি এমুলেটর ব্যবহার করুন।

  • অ্যাপল প্ল্যাটফর্মের জন্য — একটি ফিজিক্যাল ডিভাইস সেট আপ করুন অথবা একটি iOS বা tvOS সিমুলেটর ব্যবহার করুন।

    আপনি কি Cloud Messaging ব্যবহার করতে চান?

    iOS বা tvOS-এ Cloud Messaging জন্য, এখানে পূর্বশর্তগুলি রয়েছে:

    • একটি ফিজিক্যাল ডিভাইস সেট আপ করুন।
    • আপনার অ্যাপল ডেভেলপার অ্যাকাউন্টের জন্য একটি অ্যাপল পুশ নোটিফিকেশন অথেনটিকেশন কী পান।
    • XCode-এ App > Capabilities এর অধীনে Push Notifications সক্ষম করুন।

  • অ্যান্ড্রয়েডের জন্য — এমুলেটরদের অবশ্যই গুগল প্লেতে একটি এমুলেটর ইমেজ ব্যবহার করতে হবে।

• আপনার গুগল অ্যাকাউন্ট ব্যবহার করে ফায়ারবেসে সাইন ইন করুন ।

যদি আপনার কাছে ইতিমধ্যেই কোন ইউনিটি প্রজেক্ট না থাকে এবং শুধুমাত্র একটি Firebase পণ্য চেষ্টা করে দেখতে চান, তাহলে আপনি আমাদের কুইকস্টার্ট নমুনাগুলির একটি ডাউনলোড করতে পারেন।

ধাপ ১ : একটি ফায়ারবেস প্রকল্প তৈরি করুন

আপনার ইউনিটি প্রজেক্টে ফায়ারবেস যোগ করার আগে, আপনার ইউনিটি প্রজেক্টের সাথে সংযোগ স্থাপনের জন্য আপনাকে একটি ফায়ারবেস প্রজেক্ট তৈরি করতে হবে। ফায়ারবেস প্রজেক্ট সম্পর্কে আরও জানতে আন্ডারস্ট্যান্ড ফায়ারবেস প্রজেক্টস দেখুন।

ধাপ ২ : Firebase-এ আপনার অ্যাপ নিবন্ধন করুন

আপনার Firebase প্রকল্পের সাথে সংযোগ স্থাপনের জন্য আপনি এক বা একাধিক অ্যাপ বা গেম নিবন্ধন করতে পারেন।

1. Firebase কনসোলে যান।

2. প্রজেক্ট ওভারভিউ পৃষ্ঠার কেন্দ্রে, সেটআপ ওয়ার্কফ্লো চালু করতে ইউনিটি আইকন ( plat_unity ) এ ক্লিক করুন।

   যদি আপনি ইতিমধ্যেই আপনার Firebase প্রকল্পে একটি অ্যাপ যোগ করে থাকেন, তাহলে প্ল্যাটফর্ম বিকল্পগুলি প্রদর্শন করতে অ্যাপ যোগ করুন -এ ক্লিক করুন।

3. আপনার ইউনিটি প্রজেক্টের কোন বিল্ড টার্গেটটি আপনি নিবন্ধন করতে চান তা নির্বাচন করুন, অথবা আপনি একই সময়ে উভয় টার্গেট নিবন্ধন করতেও নির্বাচন করতে পারেন।

4. আপনার ইউনিটি প্রজেক্টের প্ল্যাটফর্ম-নির্দিষ্ট আইডি(গুলি) লিখুন।

   • iOS এর জন্য — iOS বান্ডেল আইডি ক্ষেত্রে আপনার ইউনিটি প্রজেক্টের iOS আইডি লিখুন।

   • অ্যান্ড্রয়েডের জন্য — অ্যান্ড্রয়েড প্যাকেজ নামের ক্ষেত্রে আপনার ইউনিটি প্রোজেক্টের অ্যান্ড্রয়েড আইডি লিখুন।
     প্যাকেজের নাম এবং অ্যাপ্লিকেশন আইডি শব্দ দুটি প্রায়শই বিনিময়যোগ্যভাবে ব্যবহৃত হয়।

   তোমার ইউনিটি প্রজেক্টের আইডি কোথায় পাওয়া যাবে?

   আপনার ইউনিটি আইডিইতে আপনার ইউনিটি প্রজেক্টটি খুলুন, তারপর প্রতিটি প্ল্যাটফর্মের সেটিংস বিভাগে যান:

   • iOS এর জন্য — বিল্ড সেটিংস > iOS এ নেভিগেট করুন।

   • অ্যান্ড্রয়েডের জন্য — অ্যান্ড্রয়েড > প্লেয়ার সেটিংস > অন্যান্য সেটিংসে নেভিগেট করুন।

   আপনার ইউনিটি প্রজেক্টের আইডি হল বান্ডেল আইডেন্টিফায়ার মান (উদাহরণ আইডি: com.yourcompany.yourproject )।

5. (ঐচ্ছিক) আপনার ইউনিটি প্রজেক্টের প্ল্যাটফর্ম-নির্দিষ্ট ডাকনাম(গুলি) লিখুন।
   এই ডাকনামগুলি অভ্যন্তরীণ, সুবিধাজনক শনাক্তকারী এবং শুধুমাত্র Firebase কনসোলে আপনার কাছে দৃশ্যমান।

6. অ্যাপ নিবন্ধন করুন এ ক্লিক করুন।

ধাপ ৩ : ফায়ারবেস কনফিগারেশন ফাইল যোগ করুন

1. Firebase কনসোল সেটআপ ওয়ার্কফ্লোতে আপনার প্ল্যাটফর্ম-নির্দিষ্ট Firebase কনফিগারেশন ফাইল(গুলি) পান।

   • iOS এর জন্য — Download GoogleService-Info.plist এ ক্লিক করুন।

   • অ্যান্ড্রয়েডের জন্য — google-services.json ডাউনলোড করুন এ ক্লিক করুন।

   এই কনফিগারেশন ফাইলটি সম্পর্কে আপনার কী জানা দরকার?

   • Firebase কনফিগারেশন ফাইলটিতে আপনার প্রোজেক্ট এবং অ্যাপের জন্য অনন্য, কিন্তু গোপন নয় এমন শনাক্তকারী রয়েছে। এই কনফিগারেশন ফাইল সম্পর্কে আরও জানতে, Understand Firebase Projects দেখুন।

   • আপনি যেকোনো সময় আপনার Firebase কনফিগারেশন ফাইলটি আবার ডাউনলোড করতে পারেন।

   • নিশ্চিত করুন যে কনফিগ ফাইলের নামটিতে অতিরিক্ত অক্ষর যুক্ত করা নেই, যেমন (2) ।

2. আপনার ইউনিটি প্রজেক্টের প্রজেক্ট উইন্ডোটি খুলুন, তারপর আপনার কনফিগারেশন ফাইল(গুলি) Assets ফোল্ডারে সরান।

3. Firebase কনসোলে ফিরে, সেটআপ ওয়ার্কফ্লোতে, Next এ ক্লিক করুন।

ধাপ ৪ : ফায়ারবেস ইউনিটি SDK যোগ করুন

1. Firebase কনসোলে, Firebase Unity SDK ডাউনলোড করুন এ ক্লিক করুন, তারপর সুবিধাজনক কোথাও SDK আনজিপ করুন।

   • আপনি যেকোনো সময় আবার Firebase Unity SDK ডাউনলোড করতে পারেন।

   • Firebase Unity SDK প্ল্যাটফর্ম-নির্দিষ্ট নয়।

2. আপনার ওপেন ইউনিটি প্রজেক্টে, Assets > Import Package > Custom Package এ যান।

3. আনজিপ করা SDK থেকে, আপনার অ্যাপে ব্যবহার করতে চান এমন সমর্থিত Firebase পণ্যগুলি নির্বাচন করুন।

   Analytics সক্ষম করা হয়েছে

   • Google Analytics জন্য ফায়ারবেস প্যাকেজ যোগ করুন: FirebaseAnalytics.unitypackage
   • আপনার অ্যাপে ব্যবহার করতে চান এমন অন্য যেকোনো Firebase পণ্যের প্যাকেজ যোগ করুন। উদাহরণস্বরূপ, Firebase Authentication এবং Firebase Realtime Database ব্যবহার করতে:
     FirebaseAuth.unitypackage এবং FirebaseDatabase.unitypackage

   Analytics সক্ষম করা নেই

   আপনার অ্যাপে যে Firebase পণ্যগুলি ব্যবহার করতে চান তার প্যাকেজগুলি যোগ করুন। উদাহরণস্বরূপ, Firebase Authentication এবং Firebase Realtime Database ব্যবহার করতে:
   FirebaseAuth.unitypackage এবং FirebaseDatabase.unitypackage

4. ইমপোর্ট ইউনিটি প্যাকেজ উইন্ডোতে, ইমপোর্ট এ ক্লিক করুন।

5. Firebase কনসোলে ফিরে, সেটআপ ওয়ার্কফ্লোতে, Next এ ক্লিক করুন।

ধাপ ৫ : গুগল প্লে সার্ভিসেস ভার্সনের প্রয়োজনীয়তা নিশ্চিত করুন

অ্যান্ড্রয়েডের জন্য Firebase Unity SDK-এর কিছু পণ্যের জন্য Google Play services প্রয়োজন। কোন পণ্যগুলিতে এই নির্ভরতা রয়েছে তা জানুন। এই পণ্যগুলি ব্যবহার করার আগে Google Play services আপ-টু-ডেট থাকতে হবে।

আপনার অ্যাপ্লিকেশনের শুরুতে নিম্নলিখিত using স্টেটমেন্ট এবং ইনিশিয়ালাইজেশন কোড যোগ করুন। SDK-তে অন্য কোনও পদ্ধতিতে কল করার আগে আপনি Google Play services প্রয়োজনীয় সংস্করণে পরীক্ষা করতে এবং ঐচ্ছিকভাবে আপডেট করতে পারেন।

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

তুমি সম্পূর্ণ প্রস্তুত! তোমার ইউনিটি প্রকল্পটি নিবন্ধিত এবং Firebase ব্যবহারের জন্য কনফিগার করা হয়েছে।

তবে, যদি আপনার সেট আপ করতে সমস্যা হয়, তাহলে ইউনিটি ট্রাবলশুটিং এবং FAQ দেখুন।

একটি ডেস্কটপ ওয়ার্কফ্লো সেট আপ করুন ( বিটা )

যখন আপনি একটি গেম তৈরি করেন, তখন প্রথমে ইউনিটি এডিটর এবং ডেস্কটপ প্ল্যাটফর্মে আপনার গেমটি পরীক্ষা করা অনেক সহজ হয়, তারপর ডেভেলপমেন্টের পরে মোবাইল ডিভাইসে স্থাপন এবং পরীক্ষা করা। এই কর্মপ্রবাহকে সমর্থন করার জন্য, আমরা Firebase Unity SDK-এর একটি উপসেট প্রদান করি যা Windows, macOS, Linux এবং ইউনিটি এডিটরের মধ্যে থেকে চলতে পারে।

1. মোবাইল প্ল্যাটফর্মের মতো একই নির্দেশাবলী অনুসরণ করে একটি ডেস্কটপ-প্ল্যাটফর্ম ইউনিটি প্রকল্প সেট আপ করুন (উপরের ধাপ "ফায়ারবেস দিয়ে আপনার অ্যাপ নিবন্ধন করুন" দিয়ে শুরু করুন)।

2. ইউনিটি আইডিইতে আপনার ইউনিটি প্রজেক্টটি চালান অথবা ডেস্কটপের জন্য আপনার ইউনিটি প্রজেক্ট তৈরি করতে নির্বাচন করুন।

3. (ঐচ্ছিক) আপনার ইউনিটি প্রজেক্টটি সম্পাদনা মোডে চালান।

   Firebase Unity এসডিকে ইউনিটির সম্পাদনা মোডেও চালানো যেতে পারে, যা সম্পাদক প্লাগইনগুলিতে এটি ব্যবহারের অনুমতি দেয়।

   1. যখন আপনি সম্পাদক দ্বারা ব্যবহৃত একটি FirebaseApp তৈরি করেন, তখন ডিফল্ট ইনস্ট্যান্স ব্যবহার করবেন না।

   2. পরিবর্তে, FirebaseApp.Create() কলটিতে একটি অনন্য নাম দিন।

      ইউনিটি আইডিই দ্বারা ব্যবহৃত ইনস্ট্যান্স এবং আপনার ইউনিটি প্রকল্প দ্বারা ব্যবহৃত ইনস্ট্যান্সের মধ্যে বিকল্পগুলির মধ্যে দ্বন্দ্ব এড়াতে এটি গুরুত্বপূর্ণ।

সমর্থিত Firebase পণ্য

ইউনিটি ফায়ারবেস লাইব্রেরি সম্পর্কে আরও জানুন রেফারেন্স ডকুমেন্টেশনে ।

মোবাইলের জন্য উপলব্ধ Firebase লাইব্রেরি

Firebase Unity SDK অ্যাপল এবং অ্যান্ড্রয়েডে নিম্নলিখিত Firebase পণ্যগুলিকে সমর্থন করে:

ডেস্কটপের জন্য উপলব্ধ Firebase লাইব্রেরি

Firebase Unity SDK-তে পণ্যের একটি উপসেটের জন্য ডেস্কটপ ওয়ার্কফ্লো সাপোর্ট অন্তর্ভুক্ত রয়েছে, যা Firebase-এর কিছু অংশকে ইউনিটি এডিটরে এবং Windows, macOS এবং Linux-এর স্বতন্ত্র ডেস্কটপ বিল্ডগুলিতে ব্যবহার করতে সক্ষম করে।

উইন্ডোজ, ম্যাকওএস এবং লিনাক্সের জন্য তৈরি করার সময় সুবিধার জন্য ফায়ারবেস অবশিষ্ট ডেস্কটপ লাইব্রেরিগুলিকে স্টাব (অ-কার্যকরী) বাস্তবায়ন হিসাবে সরবরাহ করে। অতএব, ডেস্কটপকে লক্ষ্য করার জন্য আপনাকে শর্তসাপেক্ষে কোড কম্পাইল করার প্রয়োজন নেই।

পরবর্তী পদক্ষেপ

• নমুনা Firebase অ্যাপগুলি অন্বেষণ করুন।

• আপনার অ্যাপ চালু করার জন্য প্রস্তুত হোন:

  • Google Cloud কনসোলে আপনার প্রকল্পের জন্য বাজেট সতর্কতা সেট আপ করুন।
  • একাধিক Firebase পরিষেবা জুড়ে আপনার প্রকল্পের ব্যবহারের সামগ্রিক চিত্র পেতে Firebase কনসোলে ব্যবহার এবং বিলিং ড্যাশবোর্ড পর্যবেক্ষণ করুন।
  • ফায়ারবেস লঞ্চ চেকলিস্ট পর্যালোচনা করুন।

• Firebase এবং আপনার ইউনিটি প্রকল্প নিয়ে সমস্যা হচ্ছে? ইউনিটি সমস্যা সমাধান এবং প্রায়শই জিজ্ঞাসিত প্রশ্নাবলী দেখুন।