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 استفاده کنید؟

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

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

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

• با استفاده از حساب Google خود وارد Firebase شوید .

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

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

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

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

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

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

2. در مرکز صفحه نمای کلی پروژه، روی نماد Unity ( plat_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 پشتیبانی‌شده را که می‌خواهید در برنامه خود استفاده کنید، انتخاب کنید.

   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 ، در گردش کار راه اندازی، روی Next کلیک کنید.

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

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

using دستورات و کد مقداردهی اولیه در ابتدای برنامه خود، موارد زیر را اضافه کنید. قبل از فراخوانی هر روش دیگری در SDK، می‌توانید Google Play services به نسخه‌ای که 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 موجود برای دسکتاپ

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

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

مراحل بعدی

• نمونه برنامه های Firebase را کاوش کنید.

• برای راه اندازی برنامه خود آماده شوید:

  • هشدارهای بودجه را برای پروژه خود در کنسول Google Cloud تنظیم کنید.
  • داشبورد استفاده و صورت‌حساب را در کنسول Firebase نظارت کنید تا تصویری کلی از استفاده از پروژه خود در چندین سرویس Firebase داشته باشید.
  • چک لیست راه اندازی Firebase را مرور کنید.

• آیا با Firebase و پروژه Unity خود مشکل دارید؟ از عیب‌یابی و پرسش‌های متداول Unity دیدن کنید.