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

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

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

MechaHamster (GitHub)

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

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


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

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

پیش نیازها

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

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

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

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

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

      برای Cloud Messaging در iOS یا tvOS، پیش نیازها در اینجا آمده است:

      • یک دستگاه فیزیکی راه اندازی کنید.
      • یک کلید تأیید اعتبار Apple Push Notification برای حساب Apple Developer خود دریافت کنید.
      • Push Notifications را در XCode در قسمت App > Capabilities فعال کنید.

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

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

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

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

  1. در کنسول Firebase ، روی افزودن پروژه کلیک کنید.

    • برای افزودن منابع Firebase به پروژه Google Cloud موجود ، نام پروژه آن را وارد کنید یا آن را از منوی کشویی انتخاب کنید.

    • برای ایجاد یک پروژه جدید، نام پروژه مورد نظر را وارد کنید. همچنین می توانید به صورت اختیاری شناسه پروژه نمایش داده شده در زیر نام پروژه را ویرایش کنید.

  2. در صورت درخواست، شرایط Firebase را بررسی کرده و بپذیرید.

  3. روی Continue کلیک کنید.

  4. (اختیاری) Google Analytics برای پروژه خود راه اندازی کنید، که به شما امکان می دهد با استفاده از هر یک از محصولات Firebase زیر تجربه ای بهینه داشته باشید:

    یا یک حساب Google Analytics موجود را انتخاب کنید یا یک حساب جدید ایجاد کنید.

    اگر حساب جدیدی ایجاد می‌کنید، مکان گزارش Analytics خود را انتخاب کنید، سپس تنظیمات اشتراک‌گذاری داده و شرایط Google Analytics را برای پروژه خود بپذیرید.

  5. روی ایجاد پروژه (یا افزودن Firebase ، اگر از پروژه Google Cloud موجود استفاده می کنید) کلیک کنید.

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

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

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

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

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

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

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

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

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

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

    پروژه Unity خود را در Unity IDE باز کنید، سپس به بخش تنظیمات برای هر پلتفرم بروید:

    • برای iOS - به Build Settings > iOS بروید.

    • برای Android - به Android > Player Settings > Other Settings بروید.

    شناسه پروژه Unity شما مقدار Bundle Identifier است (شناسه مثال: com.yourcompany.yourproject ).

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

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

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

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

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

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

    • فایل پیکربندی Firebase حاوی شناسه‌های منحصر به فرد، اما غیر مخفی برای پروژه شما است. برای کسب اطلاعات بیشتر در مورد این فایل پیکربندی، از Understand Firebase Projects دیدن کنید.

    • می‌توانید فایل پیکربندی Firebase خود را دوباره در هر زمانی دانلود کنید.

    • مطمئن شوید که نام فایل پیکربندی با کاراکترهای اضافی مانند (2) اضافه نشده باشد.

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

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

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

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

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

مراحل بعدی