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

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

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

MechaHamster (GitHub)

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

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


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

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

پیش نیازها

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

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

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

    • برای iOS - iOS 11 یا بالاتر را هدف قرار می دهد
    • برای tvOS - tvOS 12 یا بالاتر را هدف قرار می دهد
    • برای Android - API سطح 19 (KitKat) یا بالاتر را هدف قرار می دهد
  • یک دستگاه فیزیکی راه اندازی کنید یا از یک شبیه ساز برای اجرای برنامه خود استفاده کنید.

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

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

اگر قبلاً پروژه یونیتی ندارید و فقط می‌خواهید یک محصول 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 — روی دانلود 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 باید به‌روز باشد.

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

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 دیدن کنید.

تنظیم یک گردش کار دسکتاپ ( بتا )

هنگامی که در حال ایجاد یک بازی هستید، اغلب آسان‌تر است که ابتدا بازی خود را در ویرایشگر یونیتی و روی پلتفرم‌های دسکتاپ آزمایش کنید، سپس آن را در دستگاه‌های تلفن همراه در مراحل بعدی توسعه و آزمایش کنید. برای پشتیبانی از این گردش کار، ما زیرمجموعه‌ای از 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 موجود برای موبایل

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

محصول Firebase بسته یونیتی
AdMob به طور جداگانه در افزونه AdMob Unity توزیع شده است
تجزیه و تحلیل FirebaseAnalytics.unitypackage
بررسی برنامه FirebaseAppCheck.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 (رومیزی) بسته یونیتی
بررسی برنامه FirebaseAppCheck.unitypackage
احراز هویت FirebaseAuth.unitypackage
توابع ابری FirebaseFunctions.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
فضای ذخیره ابری FirebaseStorage.unitypackage
پایگاه داده بیدرنگ FirebaseDatabase.unitypackage
پیکربندی از راه دور FirebaseRemoteConfig.unitypackage

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

مراحل بعدی