আপনার 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 লেভেল 23 (Marshmallow) বা তার পরের যেকোনও ভার্সনকে টার্গেট করে

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

    • 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-এর জন্য — আপনার Unity প্রোজেক্টের iOS আইডিটি iOS বান্ডেল আইডি ফিল্ডে লিখুন।

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

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

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

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

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

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

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

  2. আপনার Unity প্রোজেক্টের প্রোজেক্ট উইন্ডো খুলুন, তারপর আপনার config ফাইল Assets ফোল্ডারে সরান।

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

ধাপ ৪: Firebase Unity SDK যোগ করুন

  1. Firebase কনসোলে, SDK Firebase Unity ডাউনলোড করুন বিকল্পে ক্লিক করুন, তারপর 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.
  }
});

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

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

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

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

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

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

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

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

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

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

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

Firebase-এর সাথে মানানসই প্রোডাক্ট

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

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

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

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-তে ডেস্কটপ ওয়ার্কফ্লো সহায়তা অন্তর্ভুক্ত থাকে যা প্রোডাক্টের একটি সাবসেটের জন্য প্রযোজ্য। এর ফলে Firebase-এর নির্দিষ্ট অংশ Unity এডিটরে এবং Windows, macOS ও Linux-এ স্ট্যান্ডঅ্যালোন ডেস্কটপ বিল্ডে ব্যবহার করা যায়।

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

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

পরবর্তী ধাপ