Firebase را به پروژه Unity خود اضافه کنید

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

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

مکا همستر (گیت‌هاب)

مکا همستر (اپ استور)

مکا همستر (فروشگاه پلی)


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

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

پیش‌نیازها

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

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

    • Xcode نسخه ۱۳.۳.۱ یا بالاتر
    • کوکو پادز ۱.۱۲.۰ یا بالاتر

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

    • برای iOS - iOS 13 یا بالاتر را هدف قرار می‌دهد.
    • برای tvOS - tvOS 13 یا بالاتر را هدف قرار می‌دهد
    • برای اندروید - سطح API 21 (لالی‌پاپ) یا بالاتر را هدف قرار می‌دهد

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

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

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

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

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

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

مرحله ۲ : برنامه خود را در Firebase ثبت کنید

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

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

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

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

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

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

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

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

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

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

مرحله 3 : اضافه کردن فایل‌های پیکربندی Firebase

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

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

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

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

  3. به کنسول Firebase برگردید، در گردش کار تنظیمات، روی Next کلیک کنید.

مرحله 4 : اضافه کردن SDK های Firebase Unity

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

    • شما می‌توانید هر زمان که بخواهید Firebase Unity SDK را دوباره دانلود کنید.

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

  2. در پروژه باز Unity خود، به مسیر Assets > Import Package > Custom Package بروید.

  3. از SDK استخراج‌شده، محصولات پشتیبانی‌شده‌ی 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. در پنجره‌ی «وارد کردن بسته‌ی یونیتی» ، روی «وارد کردن» کلیک کنید.

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

کار تمام است! پروژه Unity شما برای استفاده از Firebase ثبت و پیکربندی شده است.

اگر در راه‌اندازی مشکل دارید، به بخش عیب‌یابی و سوالات متداول یونیتی مراجعه کنید.

راه‌اندازی گردش کار دسکتاپ ( بتا )

وقتی در حال ساخت یک بازی هستید، اغلب خیلی راحت‌تر است که ابتدا بازی خود را در ویرایشگر Unity و روی پلتفرم‌های دسکتاپ آزمایش کنید، سپس بعداً در مراحل توسعه، آن را روی دستگاه‌های تلفن همراه مستقر و آزمایش کنید. برای پشتیبانی از این گردش کار، ما زیرمجموعه‌ای از SDK های Firebase Unity را ارائه می‌دهیم که می‌توانند روی ویندوز، macOS، لینوکس و از داخل ویرایشگر Unity اجرا شوند.

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

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

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

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

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

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

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

محصولات پشتیبانی شده فایربیس

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

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

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

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

محصول فایربیس (دسکتاپ) بسته یونیتی
منطق هوش مصنوعی فایربیس 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

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

مراحل بعدی