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

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

আপনার ইউনিটি প্রোজেক্টে ফায়ারবেস যুক্ত করা কতটা সহজ, তা দেখানোর জন্য আমরা মেকাহ্যামস্টার নামে একটি নমুনা গেম তৈরি করেছি। আপনি যদি কোনো গেমে ফায়ারবেস যুক্ত করে দেখতে চান, তাহলে গিটহাবে থাকা স্টার্টার সংস্করণটি ব্যবহার করুন। আর যদি একটি সম্পূর্ণ সংস্করণ চান, তাহলে অ্যাপ স্টোর বা Google Play Store থাকা সংস্করণগুলো দেখে নিতে পারেন।

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

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

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


ফায়ারবেসের সাহায্যে আপনার গেমগুলোকে আরও শক্তিশালী করার বিষয়ে আরও তথ্য জানতে আমাদের ফায়ারবেস গেমস পেজটি দেখুন।

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

পূর্বশর্ত

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

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

    • এক্সকোড ১৬.২ বা উচ্চতর
    • CocoaPods 1.12.0 বা উচ্চতর সংস্করণ

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

    • iOS-এর জন্য — iOS 15 বা তার উচ্চতর সংস্করণকে লক্ষ্য করে তৈরি
    • tvOS-এর জন্য - tvOS 15 বা তার উচ্চতর সংস্করণকে লক্ষ্য করে তৈরি।
    • অ্যান্ড্রয়েডের জন্য — এপিআই লেভেল ২৩ (মার্শমেলো) বা তার উচ্চতর সংস্করণকে লক্ষ্য করে তৈরি।

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

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

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

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

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

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

ধাপ ২ : ফায়ারবেসে আপনার অ্যাপটি নিবন্ধন করুন।

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

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

  2. প্রজেক্ট ওভারভিউ পেজের মাঝখানে, সেটআপ ওয়ার্কফ্লো চালু করতে ইউনিটি আইকনে ( ) ক্লিক করুন।

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

  3. আপনার ইউনিটি প্রোজেক্টের কোন বিল্ড টার্গেটটি রেজিস্টার করতে চান তা নির্বাচন করুন, অথবা আপনি চাইলে এখনই একই সাথে দুটি টার্গেটই রেজিস্টার করতে পারেন।

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

    • iOS-এর জন্য — iOS বান্ডেল আইডি ফিল্ডে আপনার ইউনিটি প্রজেক্টের iOS আইডিটি প্রবেশ করান।

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

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

  6. অ্যাপটি রেজিস্টার করতে ক্লিক করুন।

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

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

    • iOS-এর জন্য — GoogleService-Info.plist ডাউনলোড করতে ক্লিক করুন।

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

  2. আপনার ইউনিটি প্রজেক্টের প্রজেক্ট উইন্ডোটি খুলুন, এরপর আপনার কনফিগ ফাইলগুলো Assets ফোল্ডারে সরিয়ে নিন।

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

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

  1. Firebase কনসোলে, ‘Download Firebase Unity SDK’- তে ক্লিক করুন, তারপর SDK-টি আপনার সুবিধামত কোনো জায়গায় আনজিপ করুন।

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

    • Firebase Unity এসডিকে কোনো নির্দিষ্ট প্ল্যাটফর্মের জন্য নয়।

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

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

    Analytics সক্রিয় করা হয়েছে

    • Google Analytics এর জন্য Firebase প্যাকেজটি যোগ করুন: FirebaseAnalytics.unitypackage
    • আপনার অ্যাপে ব্যবহার করতে চান এমন অন্য যেকোনো ফায়ারবেস প্রোডাক্টের জন্য প্যাকেজগুলো যোগ করুন। উদাহরণস্বরূপ, 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 এসডিকে-এর কিছু প্রোডাক্টের জন্য 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.
  }
});

সবকিছু প্রস্তুত! আপনার ইউনিটি প্রজেক্টটি ফায়ারবেস ব্যবহারের জন্য নিবন্ধিত এবং কনফিগার করা হয়েছে।

তবে, সেট আপ করতে যদি আপনার কোনো সমস্যা হয়, তাহলে ইউনিটি ট্রাবলশুটিং ও প্রায়শই জিজ্ঞাসিত প্রশ্নাবলী (FAQ) দেখুন।

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

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

  1. মোবাইল প্ল্যাটফর্মের জন্য দেওয়া নির্দেশাবলী অনুসরণ করে একটি ডেস্কটপ-প্ল্যাটফর্ম ইউনিটি প্রজেক্ট সেট আপ করুন (উপরের ' Register your app with Firebase' ধাপ থেকে শুরু করুন)।

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

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

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

    1. এডিটরের ব্যবহারের জন্য FirebaseApp তৈরি করার সময় ডিফল্ট ইনস্ট্যান্সটি ব্যবহার করবেন না।

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

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

সমর্থিত ফায়ারবেস পণ্য

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

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

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

ফায়ারবেস পণ্য ইউনিটি প্যাকেজ
AdMob AdMob ইউনিটি প্লাগইনে আলাদাভাবে বিতরণ করা হয়েছে
ফায়ারবেস এআই লজিক FirebaseAI.unitypackage
Analytics FirebaseAnalytics.unitypackage
App Check FirebaseAppCheck.unitypackage
Authentication FirebaseAuth.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
Cloud Functions FirebaseFunctions.unitypackage
Cloud Messaging FirebaseMessaging.unitypackage
(সুপারিশকৃত) FirebaseAnalytics.unitypackage
Cloud Storage FirebaseStorage.unitypackage
Crashlytics FirebaseCrashlytics.unitypackage
(সুপারিশকৃত) FirebaseAnalytics.unitypackage
Dynamic Links FirebaseDynamicLinks.unitypackage
(সুপারিশকৃত) FirebaseAnalytics.unitypackage
Realtime Database FirebaseDatabase.unitypackage
Remote Config FirebaseRemoteConfig.unitypackage
(সুপারিশকৃত) FirebaseAnalytics.unitypackage

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

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

ফায়ারবেস পণ্য (ডেস্কটপ) ইউনিটি প্যাকেজ
ফায়ারবেস এআই লজিক FirebaseAI.unitypackage
App Check FirebaseAppCheck.unitypackage
Authentication FirebaseAuth.unitypackage
Cloud Functions FirebaseFunctions.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
Cloud Storage FirebaseStorage.unitypackage
Realtime Database FirebaseDatabase.unitypackage
Remote Config FirebaseRemoteConfig.unitypackage

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

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