Catch up on everthing we announced at this year's Firebase Summit. Learn more

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

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

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

MechaHamster (GitHub)

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

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


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

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

پیش نیازها

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  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 دوباره در هر زمان.

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

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

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

    تجزیه و تحلیل فعال شد

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

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

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

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

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

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

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

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

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. (اختیاری) اجرای پروژه وحدت خود را در حالت ویرایش.

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

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

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

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

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

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

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

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

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

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

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

مراحل بعدی