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

بازی های Unity خود را با Firebase Unity SDK های ما تقویت کنید.

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

MechaHamster (GitHub)

MechaHamster (فروشگاه برنامه)

MechaHamster (فروشگاه پلی)


در صفحه بازی های Firebase ما اطلاعات بیشتری در مورد تقویت بازی های خود با Firebase بیابید.

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

پیش نیازها

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

  • (فقط iOS) موارد زیر را نصب کنید:

    • Xcode 13.3.1 یا بالاتر
    • CocoaPods 1.10.0 یا بالاتر
  • مطمئن شوید که پروژه یونیتی شما با این شرایط مطابقت دارد:

    • برای iOS - iOS 10 یا بالاتر را هدف قرار می دهد
    • برای Android - API سطح 19 (KitKat) یا بالاتر را هدف قرار می دهد

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

    • برای iOS - یک دستگاه فیزیکی iOS راه اندازی کنید یا از شبیه ساز iOS استفاده کنید.

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

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

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

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

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

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

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

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

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

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

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

    • برای iOS - شناسه iOS پروژه Unity خود را در قسمت ID بسته نرم افزاری iOS وارد کنید.

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

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

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

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

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

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

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

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

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

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

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

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

    • Firebase Unity SDK مخصوص پلتفرم نیست.

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

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

    تجزیه و تحلیل فعال شد

    • بسته Firebase را برای Google Analytics اضافه کنید: FirebaseAnalytics.unitypackage
    • بسته‌ها را برای سایر محصولات Firebase که می‌خواهید در برنامه خود استفاده کنید، اضافه کنید. به عنوان مثال، برای استفاده از Firebase Authentication و Firebase Realtime Database:
      FirebaseAuth.unitypackage و FirebaseDatabase.unitypackage

    تجزیه و تحلیل فعال نیست

    بسته های محصولات Firebase را که می خواهید در برنامه خود استفاده کنید اضافه کنید. به عنوان مثال، برای استفاده از Firebase Authentication و Firebase Realtime Database:
    FirebaseAuth.unitypackage و FirebaseDatabase.unitypackage

  4. در پنجره Import Unity Package ، روی Import کلیک کنید.

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

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

Firebase Unity SDK برای Android به خدمات Google Play نیاز دارد که قبل از استفاده از SDK باید به‌روز باشد.

کد زیر را در ابتدای برنامه خود اضافه کنید. قبل از فراخوانی هر روش دیگری در SDK، می‌توانید سرویس‌های Google Play را به نسخه مورد نیاز Firebase Unity SDK بررسی کرده و به‌صورت اختیاری به‌روزرسانی کنید.

Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWith(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. با پیروی از دستورالعمل‌های مشابه برای پلتفرم تلفن همراه، یک پروژه یونیتی دسکتاپ راه‌اندازی کنید (با مرحله ثبت برنامه خود با Firebase در بالا شروع کنید).

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

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

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

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

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

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

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

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

Firebase Unity SDK از محصولات Firebase زیر در iOS و Android پشتیبانی می کند:

محصول Firebase بسته یونیتی
AdMob به طور جداگانه در افزونه AdMob Unity توزیع شده است
تجزیه و تحلیل FirebaseAnalytics.unitypackage
احراز هویت FirebaseAuth.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
توابع ابری FirebaseFunctions.unitypackage
پیام رسانی ابری FirebaseMessaging.unitypackage
(توصیه می شود) FirebaseAnalytics.unitypackage
فضای ذخیره ابری FirebaseStorage.unitypackage
Crashlytics FirebaseCrashlytics.unitypackage
(توصیه می شود) FirebaseAnalytics.unitypackage
لینک های پویا FirebaseDynamicLinks.unitypackage
(توصیه می شود) FirebaseAnalytics.unitypackage
پایگاه داده بیدرنگ FirebaseDatabase.unitypackage
پیکربندی از راه دور FirebaseRemoteConfig.unitypackage
(توصیه می شود) FirebaseAnalytics.unitypackage

محصولات Firebase پشتیبانی شده (رومیزی)

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

محصول Firebase (رومیزی) بسته یونیتی
احراز هویت FirebaseAuth.unitypackage
توابع ابری FirebaseFunctions.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
فضای ذخیره ابری FirebaseStorage.unitypackage
پایگاه داده بیدرنگ FirebaseDatabase.unitypackage
پیکربندی از راه دور FirebaseRemoteConfig.unitypackage

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

مراحل بعدی