بازی های Unity خود را با Firebase Unity SDK های ما تقویت کنید.
برای اینکه نشان دهیم اتصال Firebase به پروژه یونیتی چقدر آسان است، یک بازی نمونه ساختیم، MechaHamster. اگر میخواهید افزودن Firebase به بازی را امتحان کنید، از نسخه آغازین موجود در GitHub استفاده کنید. اگر نسخه کاملی میخواهید، نسخههای موجود در App Store یا Google Play Store را بررسی کنید.
در صفحه بازی های 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 سطح 19 (KitKat) یا بالاتر را هدف قرار می دهد
یک دستگاه فیزیکی راه اندازی کنید یا از یک شبیه ساز برای اجرای برنامه خود استفاده کنید.
برای پلتفرم های اپل — یک دستگاه فیزیکی راه اندازی کنید یا از شبیه ساز iOS یا tvOS استفاده کنید.
برای 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 خود ثبت کنید.
به کنسول Firebase بروید.
در مرکز صفحه نمای کلی پروژه، روی نماد Unity (
) کلیک کنید تا گردش کار راه اندازی شود.اگر قبلاً برنامهای را به پروژه Firebase خود اضافه کردهاید، روی افزودن برنامه کلیک کنید تا گزینههای پلتفرم نمایش داده شوند.
هدف ساخت پروژه یونیتی خود را که میخواهید ثبت کنید انتخاب کنید، یا حتی میتوانید هر دو هدف را هماکنون ثبت کنید.
شناسه(های) پلتفرم خاص پروژه 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
).(اختیاری) نام مستعار پلتفرم خاص پروژه Unity خود را وارد کنید.
این نامهای مستعار داخلی و شناسههای راحتی هستند و فقط در کنسول Firebase برای شما قابل مشاهده هستند.روی ثبت برنامه کلیک کنید.
مرحله 3 : فایل های پیکربندی Firebase را اضافه کنید
فایل(های) پیکربندی Firebase مخصوص پلتفرم خود را در گردش کار راه اندازی کنسول Firebase دریافت کنید.
برای iOS — روی دانلود GoogleService-Info.plist کلیک کنید.
برای Android — روی Download google-services.json کلیک کنید.
فایل پیکربندی Firebase حاوی شناسههای منحصر به فرد، اما غیر مخفی برای پروژه شما است. برای کسب اطلاعات بیشتر در مورد این فایل پیکربندی، از Understand Firebase Projects دیدن کنید.
میتوانید فایل پیکربندی Firebase خود را دوباره در هر زمانی دانلود کنید.
مطمئن شوید که نام فایل پیکربندی با کاراکترهای اضافی مانند
(2)
اضافه نشده باشد.
پنجره Project پروژه Unity خود را باز کنید، سپس فایل(های) پیکربندی خود را به پوشه
Assets
منتقل کنید.در کنسول Firebase ، در گردش کار راه اندازی، روی Next کلیک کنید.
مرحله 4 : SDK های Firebase Unity را اضافه کنید
در کنسول Firebase ، روی Download Firebase Unity SDK کلیک کنید، سپس SDK را در جایی مناسب از حالت فشرده خارج کنید.
میتوانید Firebase Unity SDK را دوباره در هر زمانی دانلود کنید.
Firebase Unity SDK مخصوص پلتفرم نیست.
در پروژه Unity باز خود، به Assets > Import Package > Custom Package بروید.
از 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
- بسته Firebase را برای Google Analytics اضافه کنید:
در پنجره Import Unity Package ، روی Import کلیک کنید.
در کنسول 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 اجرا شود.
با پیروی از دستورالعملهای مشابه برای پلتفرم تلفن همراه، یک پروژه یونیتی دسکتاپ راهاندازی کنید (با مرحله ثبت برنامه خود با Firebase در بالا شروع کنید).
پروژه Unity خود را در Unity IDE اجرا کنید یا برای ساخت پروژه Unity برای دسکتاپ انتخاب کنید.
(اختیاری) پروژه Unity خود را در حالت ویرایش اجرا کنید.
Firebase Unity SDK همچنین می تواند در حالت ویرایش Unity اجرا شود و امکان استفاده از آن در افزونه های ویرایشگر را فراهم می کند.
هنگامی که یک
FirebaseApp
ایجاد می کنید که توسط ویرایشگر استفاده می شود، از نمونه پیش فرض استفاده نکنید.در عوض، یک نام منحصر به فرد برای فراخوانی
FirebaseApp.Create()
ارائه دهید.این مهم برای جلوگیری از تضاد در گزینه ها بین نمونه مورد استفاده توسط Unity IDE و نمونه مورد استفاده توسط پروژه Unity شما است.
محصولات Firebase پشتیبانی می شود
درباره کتابخانه های Unity Firebase در مستندات مرجع بیشتر بیاموزید.
کتابخانه های Firebase موجود برای موبایل
Firebase Unity SDK از محصولات Firebase زیر در Apple و Android پشتیبانی می کند:
محصول Firebase | بسته یونیتی |
---|---|
AdMob | به طور جداگانه در افزونه AdMob Unity توزیع شده است |
Analytics | FirebaseAnalytics.unitypackage |
App Check | FirebaseAppCheck.unitypackage |
Authentication | FirebaseAuth.unitypackage |
Cloud Firestore | FirebaseFirestore.unitypackage |
Cloud Functions | FirebaseFunctions.unitypackage |
Cloud Messaging | FirebaseMessaging.unitypackage (توصیه می شود) FirebaseAnalytics.unitypackage |
Cloud Storage | FirebaseStorage.unitypackage |
Crashlytics | FirebaseCrashlytics.unitypackage (توصیه می شود) FirebaseAnalytics.unitypackage |
Dynamic Links | FirebaseDynamicLinks.unitypackage (توصیه می شود) FirebaseAnalytics.unitypackage |
Realtime Database | FirebaseDatabase.unitypackage |
Remote Config | FirebaseRemoteConfig.unitypackage (توصیه می شود) FirebaseAnalytics.unitypackage |
کتابخانه های Firebase موجود برای دسکتاپ
Firebase Unity SDK شامل پشتیبانی از گردش کار دسکتاپ برای زیرمجموعهای از محصولات میشود که امکان استفاده از بخشهای خاصی از Firebase را در ویرایشگر Unity و در ساختهای دسکتاپ مستقل در ویندوز، macOS و لینوکس فراهم میکند.
محصول Firebase (رومیزی) | بسته یونیتی |
---|---|
App Check | FirebaseAppCheck.unitypackage |
Authentication | FirebaseAuth.unitypackage |
Cloud Functions | FirebaseFunctions.unitypackage |
Cloud Firestore | FirebaseFirestore.unitypackage |
Cloud Storage | FirebaseStorage.unitypackage |
Realtime Database | FirebaseDatabase.unitypackage |
Remote Config | FirebaseRemoteConfig.unitypackage |
Firebase کتابخانههای دسکتاپ باقیمانده را بهعنوان پیادهسازیهای خرد (غیر کاربردی) برای راحتی در هنگام ساخت برای Windows، macOS و Linux ارائه میکند. بنابراین، برای هدف قرار دادن دسکتاپ نیازی به کامپایل کد مشروط ندارید.
مراحل بعدی
نمونه برنامه های Firebase را کاوش کنید.
برای راه اندازی برنامه خود آماده شوید:
- هشدارهای بودجه را برای پروژه خود در کنسول Google Cloud تنظیم کنید.
- داشبورد استفاده و صورتحساب را در کنسول Firebase نظارت کنید تا تصویری کلی از استفاده از پروژه خود در چندین سرویس Firebase داشته باشید.
- چک لیست راه اندازی Firebase را مرور کنید.
آیا با Firebase و پروژه Unity خود مشکل دارید؟ از عیبیابی و پرسشهای متداول Unity دیدن کنید.
بازی های Unity خود را با Firebase Unity SDK های ما تقویت کنید.
برای اینکه نشان دهیم اتصال Firebase به پروژه یونیتی چقدر آسان است، یک بازی نمونه ساختیم، MechaHamster. اگر میخواهید افزودن Firebase به بازی را امتحان کنید، از نسخه آغازین موجود در GitHub استفاده کنید. اگر نسخه کاملی میخواهید، نسخههای موجود در App Store یا Google Play Store را بررسی کنید.
در صفحه بازی های 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 سطح 19 (KitKat) یا بالاتر را هدف قرار می دهد
یک دستگاه فیزیکی راه اندازی کنید یا از یک شبیه ساز برای اجرای برنامه خود استفاده کنید.
برای پلتفرم های اپل — یک دستگاه فیزیکی راه اندازی کنید یا از شبیه ساز iOS یا tvOS استفاده کنید.
برای 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 خود ثبت کنید.
به کنسول Firebase بروید.
در مرکز صفحه نمای کلی پروژه، روی نماد Unity (
) کلیک کنید تا گردش کار راه اندازی شود.اگر قبلاً برنامهای را به پروژه Firebase خود اضافه کردهاید، روی افزودن برنامه کلیک کنید تا گزینههای پلتفرم نمایش داده شوند.
هدف ساخت پروژه یونیتی خود را که میخواهید ثبت کنید انتخاب کنید، یا حتی میتوانید هر دو هدف را هماکنون ثبت کنید.
شناسه(های) پلتفرم خاص پروژه 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
).(اختیاری) نام مستعار پلتفرم خاص پروژه Unity خود را وارد کنید.
این نامهای مستعار، شناسههای راحتی هستند و فقط در کنسول Firebase برای شما قابل مشاهده هستند.روی ثبت برنامه کلیک کنید.
مرحله 3 : فایل های پیکربندی Firebase را اضافه کنید
فایل(های) پیکربندی Firebase مخصوص پلتفرم خود را در گردش کار راه اندازی کنسول Firebase دریافت کنید.
برای iOS — روی دانلود GoogleService-Info.plist کلیک کنید.
برای Android — روی Download google-services.json کلیک کنید.
فایل پیکربندی Firebase حاوی شناسههای منحصر به فرد، اما غیر مخفی برای پروژه شما است. برای کسب اطلاعات بیشتر در مورد این فایل پیکربندی، از Understand Firebase Projects دیدن کنید.
میتوانید فایل پیکربندی Firebase خود را دوباره در هر زمانی دانلود کنید.
مطمئن شوید که نام فایل پیکربندی با کاراکترهای اضافی مانند
(2)
اضافه نشده باشد.
پنجره Project پروژه Unity خود را باز کنید، سپس فایل(های) پیکربندی خود را به پوشه
Assets
منتقل کنید.در کنسول Firebase ، در گردش کار راه اندازی، روی Next کلیک کنید.
مرحله 4 : SDK های Firebase Unity را اضافه کنید
در کنسول Firebase ، روی Download Firebase Unity SDK کلیک کنید، سپس SDK را در جایی مناسب از حالت فشرده خارج کنید.
میتوانید Firebase Unity SDK را دوباره در هر زمانی دانلود کنید.
Firebase Unity SDK مخصوص پلتفرم نیست.
در پروژه Unity باز خود، به Assets > Import Package > Custom Package بروید.
از 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
- بسته Firebase را برای Google Analytics اضافه کنید:
در پنجره Import Unity Package ، روی Import کلیک کنید.
در کنسول 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 اجرا شود.
با پیروی از دستورالعملهای مشابه برای پلتفرم تلفن همراه، یک پروژه یونیتی دسکتاپ راهاندازی کنید (با مرحله ثبت برنامه خود با Firebase در بالا شروع کنید).
پروژه Unity خود را در Unity IDE اجرا کنید یا برای ساخت پروژه Unity برای دسکتاپ انتخاب کنید.
(اختیاری) پروژه Unity خود را در حالت ویرایش اجرا کنید.
Firebase Unity SDK همچنین می تواند در حالت ویرایش Unity اجرا شود و امکان استفاده از آن در افزونه های ویرایشگر را فراهم می کند.
هنگامی که یک
FirebaseApp
ایجاد می کنید که توسط ویرایشگر استفاده می شود، از نمونه پیش فرض استفاده نکنید.در عوض، یک نام منحصر به فرد برای فراخوانی
FirebaseApp.Create()
ارائه دهید.این مهم برای جلوگیری از تضاد در گزینه ها بین نمونه مورد استفاده توسط Unity IDE و نمونه مورد استفاده توسط پروژه Unity شما است.
محصولات Firebase پشتیبانی می شود
درباره کتابخانه های Unity Firebase در مستندات مرجع بیشتر بیاموزید.
کتابخانه های Firebase موجود برای موبایل
Firebase Unity SDK از محصولات Firebase زیر در Apple و Android پشتیبانی می کند:
محصول Firebase | بسته یونیتی |
---|---|
AdMob | به طور جداگانه در افزونه AdMob Unity توزیع شده است |
Analytics | FirebaseAnalytics.unitypackage |
App Check | FirebaseAppCheck.unitypackage |
Authentication | FirebaseAuth.unitypackage |
Cloud Firestore | FirebaseFirestore.unitypackage |
Cloud Functions | FirebaseFunctions.unitypackage |
Cloud Messaging | FirebaseMessaging.unitypackage (توصیه می شود) FirebaseAnalytics.unitypackage |
Cloud Storage | FirebaseStorage.unitypackage |
Crashlytics | FirebaseCrashlytics.unitypackage (توصیه می شود) FirebaseAnalytics.unitypackage |
Dynamic Links | FirebaseDynamicLinks.unitypackage (توصیه می شود) FirebaseAnalytics.unitypackage |
Realtime Database | FirebaseDatabase.unitypackage |
Remote Config | FirebaseRemoteConfig.unitypackage (توصیه می شود) FirebaseAnalytics.unitypackage |
کتابخانه های Firebase موجود برای دسکتاپ
Firebase Unity SDK شامل پشتیبانی از گردش کار دسکتاپ برای زیرمجموعهای از محصولات میشود که امکان استفاده از بخشهای خاصی از Firebase را در ویرایشگر Unity و در ساختهای دسکتاپ مستقل در ویندوز، macOS و لینوکس فراهم میکند.
محصول Firebase (رومیزی) | بسته یونیتی |
---|---|
App Check | FirebaseAppCheck.unitypackage |
Authentication | FirebaseAuth.unitypackage |
Cloud Functions | FirebaseFunctions.unitypackage |
Cloud Firestore | FirebaseFirestore.unitypackage |
Cloud Storage | FirebaseStorage.unitypackage |
Realtime Database | FirebaseDatabase.unitypackage |
Remote Config | FirebaseRemoteConfig.unitypackage |
Firebase کتابخانههای دسکتاپ باقیمانده را بهعنوان پیادهسازیهای خرد (غیر کاربردی) برای راحتی در هنگام ساخت برای Windows، macOS و Linux ارائه میکند. بنابراین، برای هدف قرار دادن دسکتاپ نیازی به کامپایل کد مشروط ندارید.
مراحل بعدی
نمونه برنامه های Firebase را کاوش کنید.
برای راه اندازی برنامه خود آماده شوید:
- هشدارهای بودجه را برای پروژه خود در کنسول Google Cloud تنظیم کنید.
- داشبورد استفاده و صورتحساب را در کنسول Firebase نظارت کنید تا تصویری کلی از استفاده از پروژه خود در چندین سرویس Firebase داشته باشید.
- چک لیست راه اندازی Firebase را مرور کنید.
آیا با Firebase و پروژه Unity خود مشکل دارید؟ از عیبیابی و پرسشهای متداول Unity دیدن کنید.
بازی های Unity خود را با Firebase Unity SDK های ما تقویت کنید.
برای اینکه نشان دهیم اتصال Firebase به پروژه یونیتی چقدر آسان است، یک بازی نمونه ساختیم، MechaHamster. اگر میخواهید افزودن Firebase به بازی را امتحان کنید، از نسخه آغازین موجود در GitHub استفاده کنید. اگر نسخه کاملی میخواهید، نسخههای موجود در App Store یا Google Play Store را بررسی کنید.
در صفحه بازی های 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 سطح 19 (KitKat) یا بالاتر را هدف قرار می دهد
یک دستگاه فیزیکی راه اندازی کنید یا از یک شبیه ساز برای اجرای برنامه خود استفاده کنید.
برای پلتفرم های اپل — یک دستگاه فیزیکی راه اندازی کنید یا از شبیه ساز iOS یا tvOS استفاده کنید.
برای 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 خود ثبت کنید.
به کنسول Firebase بروید.
در مرکز صفحه نمای کلی پروژه، روی نماد Unity (
) کلیک کنید تا گردش کار راه اندازی شود.اگر قبلاً برنامهای را به پروژه Firebase خود اضافه کردهاید، روی افزودن برنامه کلیک کنید تا گزینههای پلتفرم نمایش داده شوند.
هدف ساخت پروژه یونیتی خود را که میخواهید ثبت کنید انتخاب کنید، یا حتی میتوانید هر دو هدف را هماکنون ثبت کنید.
شناسه(های) پلتفرم خاص پروژه 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
).(اختیاری) نام مستعار پلتفرم خاص پروژه Unity خود را وارد کنید.
این نامهای مستعار، شناسههای راحتی هستند و فقط در کنسول Firebase برای شما قابل مشاهده هستند.روی ثبت برنامه کلیک کنید.
مرحله 3 : فایل های پیکربندی Firebase را اضافه کنید
فایل(های) پیکربندی Firebase مخصوص پلتفرم خود را در گردش کار راه اندازی کنسول Firebase دریافت کنید.
برای iOS — روی دانلود GoogleService-Info.plist کلیک کنید.
برای Android — روی Download google-services.json کلیک کنید.
فایل پیکربندی Firebase حاوی شناسههای منحصر به فرد، اما غیر مخفی برای پروژه شما است. برای کسب اطلاعات بیشتر در مورد این فایل پیکربندی، از Understand Firebase Projects دیدن کنید.
میتوانید فایل پیکربندی Firebase خود را دوباره در هر زمانی دانلود کنید.
مطمئن شوید که نام فایل پیکربندی با کاراکترهای اضافی مانند
(2)
اضافه نشده باشد.
پنجره Project پروژه Unity خود را باز کنید، سپس فایل(های) پیکربندی خود را به پوشه
Assets
منتقل کنید.در کنسول Firebase ، در گردش کار راه اندازی، روی Next کلیک کنید.
مرحله 4 : SDK های Firebase Unity را اضافه کنید
در کنسول Firebase ، روی Download Firebase Unity SDK کلیک کنید، سپس SDK را در جایی مناسب از حالت فشرده خارج کنید.
میتوانید Firebase Unity SDK را دوباره در هر زمانی دانلود کنید.
Firebase Unity SDK خاص سکو نیست.
در پروژه Unity باز خود، به Assets > Import Package > Custom Package بروید.
از 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
- بسته Firebase را برای Google Analytics اضافه کنید:
در پنجره Import Unity Package ، روی Import کلیک کنید.
دوباره در کنسول Firebase ، در گردش کار تنظیم ، روی Next کلیک کنید.
مرحله 5 : الزامات نسخه خدمات Google Play را تأیید کنید
Firebase Unity SDK برای Android به Google Play services نیاز دارد ، که قبل از استفاده از SDK باید به روز باشد.
موارد زیر را using
عبارت و کد اولیه سازی در ابتدای برنامه خود اضافه کنید. شما می توانید قبل از تماس با هر Unity دیگر در SDK Firebase 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.
}
});
شما آماده اید! پروژه وحدت شما برای استفاده از Firebase ثبت و پیکربندی شده است.
اگر در راه اندازی مشکل دارید ، از عیب یابی و سؤالات متداول دیدن می کنید.
تنظیم گردش کار دسک تاپ ( بتا )
وقتی در حال ایجاد یک بازی هستید ، آزمایش بازی خود در ویرایشگر وحدت و سیستم عامل های دسک تاپ بسیار ساده تر است ، سپس بعداً در توسعه دستگاه های تلفن همراه را مستقر و تست کنید. برای پشتیبانی از این گردش کار ، زیر مجموعه ای از SDK های Unity Firebase را ارائه می دهیم که می تواند در ویندوز ، MacOS ، Linux و از درون ویرایشگر وحدت اجرا شود.
با پیروی از همان دستورالعمل هایی که برای یک پلتفرم موبایل انجام دهید ، یک پروژه Unity Desktop-Platform را تنظیم کنید (با ثبت برنامه خود را با مرحله Firebase در بالا شروع کنید).
پروژه وحدت خود را در Unity IDE اجرا کنید یا برای ساخت پروژه وحدت خود برای دسک تاپ انتخاب کنید.
(اختیاری) پروژه وحدت خود را در حالت ویرایش اجرا کنید.
Firebase Unity SDK همچنین می تواند در حالت ویرایش Unity اجرا شود و امکان استفاده از آن در افزونه های ویرایشگر را فراهم می کند.
هنگامی که یک
FirebaseApp
ایجاد می کنید که توسط ویرایشگر استفاده می شود ، از نمونه پیش فرض استفاده نکنید.در عوض ، یک نام منحصر به فرد به تماس
FirebaseApp.Create()
ارائه دهید.این مهم برای جلوگیری از درگیری در گزینه های بین نمونه ای که توسط Unity IDE و نمونه ای که توسط پروژه وحدت شما استفاده شده است ، مهم است.
محصولات Firebase پشتیبانی شده
در اسناد مرجع در مورد کتابخانه های Firebase وحدت بیشتر بدانید.
کتابخانه های Firebase موجود برای موبایل
Firebase Unity SDK از محصولات Firebase زیر در Apple و Android پشتیبانی می کند:
محصول Firebase | بسته وحدت |
---|---|
AdMob | به طور جداگانه در افزونه AdMob Unity توزیع شده است |
Analytics | FirebaseAnalytics.unitypackage |
App Check | FirebaseAppCheck.unitypackage |
Authentication | FirebaseAuth.unitypackage |
Cloud Firestore | FirebaseFirestore.unitypackage |
Cloud Functions | FirebaseFunctions.unitypackage |
Cloud Messaging | FirebaseMessaging.unitypackage (توصیه می شود) FirebaseAnalytics.unitypackage |
Cloud Storage | FirebaseStorage.unitypackage |
Crashlytics | FirebaseCrashlytics.unitypackage (توصیه می شود) FirebaseAnalytics.unitypackage |
Dynamic Links | FirebaseDynamicLinks.unitypackage (توصیه می شود) FirebaseAnalytics.unitypackage |
Realtime Database | FirebaseDatabase.unitypackage |
Remote Config | FirebaseRemoteConfig.unitypackage (توصیه می شود) FirebaseAnalytics.unitypackage |
کتابخانه های Firebase موجود برای دسک تاپ
Firebase Unity SDK شامل پشتیبانی از گردش کار دسک تاپ برای زیر مجموعه ای از محصولات است ، این امکان را فراهم می کند تا قسمت های خاصی از Firebase را در ویرایشگر وحدت و در ساخت دسک تاپ مستقل بر روی ویندوز ، مکوس و لینوکس استفاده کند.
محصول Firebase (دسک تاپ) | بسته وحدت |
---|---|
App Check | FirebaseAppCheck.unitypackage |
Authentication | FirebaseAuth.unitypackage |
Cloud Functions | FirebaseFunctions.unitypackage |
Cloud Firestore | FirebaseFirestore.unitypackage |
Cloud Storage | FirebaseStorage.unitypackage |
Realtime Database | FirebaseDatabase.unitypackage |
Remote Config | FirebaseRemoteConfig.unitypackage |
Firebase کتابخانه های دسک تاپ باقیمانده را به عنوان پیاده سازی های خرد (غیر کاربردی) برای راحتی در هنگام ساخت ویندوز ، MACOS و لینوکس ارائه می دهد. بنابراین ، برای هدف قرار دادن دسک تاپ نیازی به تهیه کد به صورت مشروط ندارید.
مراحل بعدی
نمونه برنامه های Firebase را کاوش کنید.
برای راه اندازی برنامه خود آماده شوید:
- هشدارهای بودجه را برای پروژه خود در کنسول Google Cloud تنظیم کنید.
- داشبورد استفاده و صورتحساب را در کنسول Firebase کنترل کنید تا تصویری کلی از استفاده از پروژه خود در چندین سرویس Firebase دریافت کنید.
- چک لیست پرتاب Firebase را مرور کنید.
با Firebase و پروژه وحدت خود مشکل دارید؟ از عیب یابی وحدت و سؤالات متداول دیدن کنید.