আপনার Unity প্রোজেক্টে Firebase যোগ করা

আমাদের Firebase Unity SDK-এর মাধ্যমে আপনার Unity গেম আরও উন্নত করুন।

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

MechaHamster (GitHub)

MechaHamster (App Store)

MechaHamster (Play Store)


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

আপনার Unity প্রোজেক্টে Firebase আগেই যোগ করেছেন? আপনি Firebase Unity SDK-এর লেটেস্ট ভার্সন ব্যবহার করছেন কিনা তা নিশ্চিত করুন।

পূর্বশর্ত

  • Unity 2021 LTS বা তার পরবর্তী ভার্সন ইনস্টল করুন। আগের ভার্সনও মানানসই হতে পারে, তবে সেগুলি অ্যাক্টিভভাবে কাজ করবে না।

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

    • Xcode 26.2 বা তার পরের যেকোনও ভার্সন
    • CocoaPods 1.12.0 বা তার পরবর্তী যেকোনও ভার্সন

  • আপনার Unity প্রোজেক্ট এইসব প্রয়োজনীয়তা পূরণ করছে কিনা তা ভালো করে দেখে নিন:

    • iOS-এর জন্য — iOS 15 বা তার পরবর্তী যেকোনও ভার্সন টার্গেট করে
    • tvOS-এর জন্য - tvOS 15 বা তার পরবর্তী ভার্সনকে টার্গেট করে
    • Android-এর জন্য — API লেভেল ২৪ (Nougat) বা তার পরবর্তী ভার্সনকে টার্গেট করে

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

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

    • Android-এর জন্য — এমুলেটর অবশ্যই Google Play-এর সাথে এমুলেটর ইমেজ ব্যবহার করতে হবে।

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

ধাপ ১: Firebase প্রোজেক্ট তৈরি করুন

আপনার Unity প্রোজেক্টে Firebase যোগ করার আগে, আপনার Unity প্রোজেক্টের সাথে কানেক্ট করার জন্য আপনাকে একটি Firebase প্রোজেক্ট তৈরি করতে হবে। Firebase প্রোজেক্ট সম্পর্কে আরও জানতে Firebase প্রোজেক্ট বুঝুন পৃষ্ঠা দেখুন।

ধাপ ২: Firebase-এ আপনার অ্যাপ রেজিস্টার করুন

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

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

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

    আপনি যদি আগে থেকেই আপনার Firebase প্রোজেক্টে কোনও অ্যাপ যোগ করে থাকেন, তাহলে প্ল্যাটফর্মের বিকল্পগুলি দেখতে অ্যাপ যোগ করুন বিকল্পে ক্লিক করুন।

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

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

    • iOS-এর জন্য — iOS বান্ডেল আইডি ফিল্ডে আপনার Unity প্রোজেক্টের iOS আইডি লিখুন।

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

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

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

ধাপ ৩: Firebase কনফিগারেশন ফাইল যোগ করা

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

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

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

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

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

ধাপ ৪: Firebase ইউনিটি SDK যোগ করুন

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

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

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

  2. আপনার খোলা Unity প্রোজেক্টে, অ্যাসেট > প্যাকেজ ইমপোর্ট করুন > কাস্টম প্যাকেজ বিকল্পে নেভিগেট করুন।

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

    Analytics চালু করা রয়েছে

    • Google Analytics-এর জন্য Firebase প্যাকেজ যোগ করুন: FirebaseAnalytics.unitypackage
    • আপনার অ্যাপে ব্যবহার করতে চান এমন অন্য যেকোনও Firebase প্রোডাক্টের জন্য প্যাকেজ যোগ করুন। যেমন, Firebase Authentication এবং Firebase Realtime Database ব্যবহার করতে:
      FirebaseAuth.unitypackage এবং FirebaseDatabase.unitypackage

    Analytics চালু করা নেই

    আপনার অ্যাপে ব্যবহার করতে চান এমন Firebase প্রোডাক্টের জন্য প্যাকেজ যোগ করুন। যেমন, Firebase Authentication এবং Firebase Realtime Database ব্যবহার করতে:
    FirebaseAuth.unitypackage এবং FirebaseDatabase.unitypackage

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

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

ধাপ ৫: Google Play পরিষেবার ভার্সন সংক্রান্ত প্রয়োজনীয়তা কনফার্ম করুন

Android-এর জন্য 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.
  }
});

আপনি একদম রেডি! আপনার Unity প্রোজেক্ট রেজিস্টার করা হয়েছে এবং Firebase ব্যবহার করার জন্য কনফিগার করা হয়েছে।

তবে, সেট-আপ করার সময় কোনও সমস্যা হলে, Unity সমস্যার সমাধান ও প্রায়শই জিজ্ঞাসিত প্রশ্ন দেখুন।

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

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

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

  2. Unity IDE-তে আপনার Unity প্রোজেক্ট রান করুন অথবা ডেস্কটপ-এর জন্য আপনার Unity প্রোজেক্ট তৈরি করতে বেছে নিন।

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

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

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

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

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

মানানসই Firebase প্রোডাক্ট

রেফারেন্স ডকুমেন্টেশন থেকে Unity Firebase লাইব্রেরি সম্পর্কে আরও জানুন।

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

Firebase Unity SDK, Apple ও Android-এ নিম্নলিখিত Firebase প্রোডাক্টে কাজ করে:

Firebase প্রোডাক্ট Unity প্যাকেজ
AdMob AdMob Unity প্লাগ-ইনে আলাদাভাবে ডিস্ট্রিবিউট করা হয়েছে
Firebase AI Logic 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
Realtime Database FirebaseDatabase.unitypackage
Remote Config FirebaseRemoteConfig.unitypackage
(সাজেস্ট করা হয়েছে) FirebaseAnalytics.unitypackage
বাতিল করা বা কাজ করে না এমন লাইব্রেরি
Dynamic Links FirebaseDynamicLinks.unitypackage
(সাজেস্ট করা হয়েছে) FirebaseAnalytics.unitypackage

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

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

Firebase প্রোডাক্ট (ডেস্কটপ) Unity প্যাকেজ
Firebase AI Logic 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

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

পরবর্তী ধাপ