Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

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

قدرت تا خود را وحدت بازی با ما فایربیس وحدت SDK ها.

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

MechaHamster (GitHub)

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

MechaHamster (فروشگاه Play)


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

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

پیش نیازها

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

  • (IOS تنها) نصب زیر:

    • کد X4 9.4.1 یا بالاتر
    • CocoaPods 1.10.0 یا بالاتر
  • اطمینان حاصل کنید که پروژه Unity شما این الزامات را دارد:

    • برای iOS - هدف قرار در iOS 10 یا بالاتر
    • برای آندروید - سطح اهداف API 16 (Jelly Bean) یا بالاتر

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

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

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

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

مرحله 1: ایجاد یک پروژه فایربیس

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

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

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

  1. رفتن به کنسول فایربیس .

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

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

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

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

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

    • برای آندروید - را وارد کنید ID آندروید پروژه وحدت خود را در نام بسته Android زمینه است.
      نام نظر بسته و ID نرم افزار اغلب به جای یکدیگر استفاده می شود.

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

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

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

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

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

    • برای آندروید - کلیک کنید دانلود گوگل services.json.

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

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

گام 4: اضافه کردن فایربیس وحدت SDK ها

  1. در فایربیس کنسول، کلیک کنید دانلود فایربیس وحدت SDK، سپس جدا کردن از SDK جایی راحت است.

    • شما می توانید دانلود فایربیس وحدت SDK دوباره در هر زمان.

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

  2. در پروژه خود باز وحدت، حرکت به دارایی> واردات بسته بندی> بسته بندی سفارشی.

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

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

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

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

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

  4. در پنجره واردات وحدت بسته بندی، واردات را کلیک کنید.

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

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

فایربیس وحدت SDK برای آندروید نیاز به سرویس Google Play ، که باید تا به روز می شود قبل از SDK را می توان مورد استفاده قرار گیرد.

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

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

  1. تنظیم یک پروژه دسکتاپ وحدت پلت فرم با پیروی از دستورالعمل همان است که برای پلت فرم تلفن همراه (با شروع ثبت نام برنامه خود را با Firebase مرحله بالا).

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

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

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

    1. هنگامی که شما یک FirebaseApp استفاده شده توسط سردبیر، آیا به عنوان مثال به طور پیش فرض استفاده نمی کند.

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

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

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

اطلاعات بیشتر در مورد کتابخانه وحدت فایربیس در یادگیری اسناد مرجع .

فایربیس وحدت SDK پشتیبانی از محصولات زیر فایربیس در IOS و اندیشه:

محصول Firebase بسته وحدت
AdMob به طور جداگانه در افزونه AdMob Unity توزیع می شود
تجزیه و تحلیل FirebaseAnalytics.unitypackage
احراز هویت FirebaseAuth.unitypackage
ابر 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 (دسکتاپ)

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

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

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

مراحل بعدی