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

    آیا می‌خواهید از Cloud Messaging استفاده کنید؟

    برای استفاده Cloud Messaging در iOS یا tvOS، پیش‌نیازها به شرح زیر است:

    • یک دستگاه فیزیکی راه‌اندازی کنید.
    • یک کلید احراز هویت اعلان‌های فوری اپل برای حساب توسعه‌دهنده اپل خود دریافت کنید.
    • اعلان‌های فوری را در XCode از طریق مسیر App > Capabilities فعال کنید.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   شناسه پروژه یونیتی خود را از کجا پیدا می‌کنید؟

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

   • برای iOS — به تنظیمات ساخت > iOS بروید.

   • برای اندروید — به اندروید > تنظیمات پخش‌کننده > سایر تنظیمات بروید.

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

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

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

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

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

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

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

   چه چیزهایی در مورد این فایل پیکربندی باید بدانید؟

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

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

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

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 از محصولات فایربیس زیر در اپل و اندروید پشتیبانی می‌کند:

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

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

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

مراحل بعدی

• نمونه‌هایی از برنامه‌های Firebase را بررسی کنید.

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

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

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