افزودن Firebase به پروژه Unity

بازی‌های Unity خود را با کیت‌های توسعه نرم‌افزار Firebase Unity ما تقویت کنید.

برای نشان دادن اینکه چقدر آسان است که Firebase را به پروژه Unity خود متصل کنید، ما یک بازی نمونه به نام MechaHamster ساخته‌ایم. اگر می‌خواهید افزودن Firebase به بازی را امتحان کنید، از نسخه آغازین موجود در GitHub استفاده کنید. اگر نسخه کامل را می‌خواهید، نسخه‌های موجود در App Store یا Google Play Store را بررسی کنید.

MechaHamster (GitHub)

MechaHamster (App Store)

MechaHamster (فروشگاه Play)


برای کسب اطلاعات بیشتر درباره تقویت بازی‌هایتان با Firebase، به صفحه بازی‌های Firebase ما مراجعه کنید.

قبلاً Firebase را به پروژه Unity خود اضافه کرده‌اید؟ مطمئن شوید که از جدیدترین نسخه Firebase Unity SDK استفاده می‌کنید.

پیش‌نیازها

  • Unity 2021 LTS یا نسخه‌های جدیدتر را نصب کنید. نسخه‌های قدیمی‌تر نیز ممکن است سازگار باشند اما به‌طور فعال پشتیبانی نخواهند شد.

  • (فقط پلاتفرم‌های Apple) موارد زیر را نصب کنید:

    • Xcode نسخه ۲۶.۲ یا بالاتر
    • CocoaPods نسخه ۱.۱۲.۰ یا بالاتر

  • مطمئن شوید پروژه Unity شما این الزامات را برآورده می‌کند:

    • ویژه iOS — iOS 15 یا بالاتر را هدف قرار می‌دهد
    • برای tvOS - tvOS 15 یا بالاتر را هدف قرار می‌دهد
    • برای Android — میانای برنامه‌سازی کاربردی سطح ۲۴ (Nougat) یا بالاتر را هدف قرار می‌دهد

  • دستگاهی فیزیکی راه‌اندازی کنید یا از شبیه‌ساز برای اجرای برنامه‌تان استفاده کنید.

    • برای پلاتفرم‌های Apple — دستگاه فیزیکی راه‌اندازی کنید یا از شبیه‌ساز iOS یا tvOS استفاده کنید.

    • برای Android — شبیه‌سازها باید از تصویر شبیه‌ساز با Google Play استفاده کنند.

اگر ازقبل پروژه Unity ندارید و فقط می‌خواهید محصول Firebase را امتحان کنید، می‌توانید یکی از نمونه‌های شروع سریع ما را بارگیری کنید.

مرحله ۱: ایجاد پروژه Firebase

قبل‌از اینکه بتوانید Firebase را به پروژه Unity خود اضافه کنید، باید یک پروژه Firebase ایجاد کنید تا به پروژه Unity شما متصل شود. برای کسب اطلاعات بیشتر درباره پروژه‌های Firebase، به آشنایی با پروژه‌های Firebase مراجعه کنید.

مرحله ۲: ثبت برنامه در Firebase

می‌توانید یک یا چند برنامه یا بازی را برای اتصال به پروژه Firebase خود ثبت کنید.

  1. به کنسول Firebase بروید.

  2. در مرکز صفحه نمای کلی پروژه، روی نماد Unity () کلیک کنید تا گردش کار راه‌اندازی شروع شود.

    اگر قبلاً برنامه‌ای به پروژه Firebase خود اضافه کرده‌اید، روی افزودن برنامه کلیک کنید تا گزینه‌های پلاتفرم نمایش داده شود.

  3. انتخاب کنید که کدام هدف ساخت پروژه Unity را می‌خواهید ثبت کنید، یا حتی می‌توانید انتخاب کنید که هر دو هدف را اکنون به‌طور هم‌زمان ثبت کنید.

  4. شناسه(های) مختص پلاتفرم پروژه Unity را وارد کنید.

    • برای iOS — شناسه iOS پروژه Unity را در فیلد شناسه دسته نرم‌افزاری iOS وارد کنید.

    • برای Android — شناسه Android پروژه Unity خود را در فیلد نام بسته Android وارد کنید.
      اصطلاحات نام بسته و شناسه برنامه اغلب به‌جای یکدیگر استفاده می‌شوند.

  5. (اختیاری) نام(های) مستعار مختص پلاتفرم پروژه Unity خود را وارد کنید.
    این نام‌های مستعار شناسه‌های داخلی و راحتی هستند و فقط برای شما در کنسول Firebase قابل‌مشاهده هستند.

  6. روی ثبت برنامه کلیک کنید.

مرحله ۳: افزودن فایل‌های پیکربندی Firebase

  1. فایل(های) پیکربندی Firebase مختص پلاتفرم خود را در گردش کار راه‌اندازی کنسول Firebase دریافت کنید.

    • برای iOS — روی بارگیری GoogleService-Info.plist کلیک کنید.

    • برای Android — روی بارگیری google-services.json کلیک کنید.

  2. پنجره Project پروژه Unity را باز کنید، سپس فایل(های) پیکربندی را به پوشه Assets منتقل کنید.

  3. به کنسول Firebase برگردید و در گردش کار راه‌اندازی، روی بعدی کلیک کنید.

مرحله ۴: افزودن کیت‌های توسعه نرم‌افزار Firebase در Unity

  1. در کنسول Firebase، روی بارگیری کیت توسعه نرم‌افزار Firebase Unity کلیک کنید، سپس کیت توسعه نرم‌افزار را در جایی مناسب از حالت فشرده خارج کنید.

    • هرزمان خواستید می‌توانید کیت توسعه نرم‌افزار Firebase Unity را دوباره بارگیری کنید.

    • کیت توسعه نرم‌افزار Firebase Unity مختص پلاتفرم نیست.

  2. در پروژه Unity بازشده، به دارایی‌ها > وارد کردن بسته > بسته سفارشی بروید.

  3. از کیت توسعه نرم‌افزار از حالت فشرده خارج‌شده، محصولات Firebase پشتیبانی‌شده را که می‌خواهید در برنامه‌تان استفاده کنید انتخاب کنید.

    ‫Analytics فعال شد

    • بسته Firebase را برای 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. در پنجره Import Unity Package، روی Import کلیک کنید.

  5. به کنسول Firebase برگردید و در گردش کار راه‌اندازی، روی بعدی کلیک کنید.

مرحله ۵: تأیید الزامات نسخه خدمات Google Play

برخی‌از محصولات در کیت توسعه نرم‌افزار Firebase Unity برای Android به Google Play services نیاز دارند. ببینید کدام محصولات این وابستگی را دارند. Google Play services باید به‌روز باشد تا بتوان از آن محصولات استفاده کرد.

عبارت using و کد مقداردهی اولیه زیر را در ابتدای برنامه‌تان اضافه کنید. می‌توانید قبل‌از فراخوانی هر روش دیگری در کیت توسعه نرم‌افزار، 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 را ارائه می‌دهیم که می‌توانند در Windows،‏ macOS،‏ Linux، و از داخل ویرایشگر Unity اجرا شوند.

  1. با دنبال کردن همان دستورالعمل‌های پلاتفرم تلفن همراه، پروژه Unity پلاتفرم رایانه را راه‌اندازی کنید (با مرحله ثبت برنامه در Firebase در بالا شروع کنید).

  2. پروژه Unity خود را در Unity IDE اجرا کنید یا برای ساختن پروژه Unity خود برای رایانه انتخاب کنید.

  3. (اختیاری) پروژه Unity را در «حالت ویرایش» اجرا کنید.

    Firebase Unity SDK را می‌توان در حالت ویرایش Unity نیز اجرا کرد، که امکان استفاده از آن را در افزایه‌های ویرایشگر فراهم می‌کند.

    1. وقتی FirebaseApp مورداستفاده ویرایشگر را ایجاد می‌کنید، از نمونه پیش‌فرض استفاده نکنید.

    2. درعوض، نامی منحصربه‌فرد برای تماس FirebaseApp.Create() ارائه دهید.

      این کار برای جلوگیری از تداخل در گزینه‌های بین نمونه استفاده‌شده توسط Unity IDE و نمونه استفاده‌شده توسط پروژه Unity شما مهم است.

محصولات Firebase پشتیبانی‌شده

درباره کتابخانه‌های Unity Firebase در اسناد مرجع بیشتر بدانید.

کتابخانه‌های Firebase دردسترس برای تلفن همراه

کیت توسعه نرم‌افزار Firebase Unity از محصولات Firebase زیر در Apple و Android پشتیبانی می‌کند:

محصول Firebase بسته Unity
AdMob به‌طور جداگانه در افزایه Unity AdMob توزیع شده است
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

Firebase بقیه کتابخانه‌های رایانه را به‌صورت پیاده‌سازی‌های تهی (غیرفعال) ارائه می‌دهد تا ساختن برای Windows،‏ macOS، و Linux راحت‌تر شود. بنابراین، لازم نیست کد را به‌صورت شرطی برای هدف قرار دادن رایانه رومیزی کامپایل کنید.

مراحل بعدی