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

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

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

MechaHamster (GitHub)

MechaHamster (فروشگاه App)

MechaHamster (فروشگاه بازی)


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

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

پیش نیازها

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

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

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

    • 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
ابر 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 برای راحتی در هنگام ساخت برای ویندوز ، macOS و Linux ، کتابخانه های دسک تاپ باقیمانده را به عنوان پیاده سازی های خرد (غیر کارکردی) فراهم می کند. بنابراین ، برای هدف قرار دادن دسکتاپ نیازی به کامپایل مشروط کد نیست.

مراحل بعدی