يمكنك تحسين ألعابك على Unity باستخدام حِزم تطوير البرامج (SDK) من Firebase Unity.
لتوضيح مدى سهولة ربط Firebase بمشروعك على Unity، أنشأنا نموذج لعبة باسم MechaHamster. إذا أردت تجربة إضافة Firebase إلى لعبة، استخدِم الإصدار الأولي المتوفّر على GitHub. إذا أردت الحصول على نسخة كاملة، يمكنك الاطّلاع على النُسخ المتوفّرة في متجر التطبيقات أو Google Play Store.
MechaHamster (متجر Google Play)
يمكنك الاطّلاع على مزيد من المعلومات حول تحسين ألعابك باستخدام Firebase في صفحة ألعاب Firebase.
هل سبق لك إضافة Firebase إلى مشروع Unity؟ تأكَّد من استخدام أحدث إصدار من حزمة تطوير البرامج (SDK) لـ Firebase Unity.
المتطلبات الأساسية
ثبِّت الإصدار Unity 2022 LTS أو إصدارًا أحدث. قد تكون الإصدارات السابقة متوافقة أيضًا، ولكن لن يتم توفير الدعم لها بشكل نشط.
(أنظمة Apple الأساسية فقط) ثبِّت ما يلي:
- الإصدار 26.2 من Xcode أو إصدار أحدث
تأكَّد من أنّ مشروع Unity يستوفي المتطلبات التالية:
- بالنسبة إلى أجهزة iOS: يستهدف الإصدار 15 من نظام التشغيل iOS أو الإصدارات الأحدث
- بالنسبة إلى tvOS: يستهدف الإصدار 15 من tvOS أو الإصدارات الأحدث
- على أجهزة Android: يستهدف المستوى 24 من واجهة برمجة التطبيقات (Nougat) أو الإصدارات الأحدث
اضبط جهازًا فعليًا أو استخدِم محاكيًا لتشغيل تطبيقك.
بالنسبة إلى أنظمة Apple الأساسية: يمكنك إعداد جهاز فعلي أو استخدام محاكي iOS أو tvOS.
على أجهزة Android: برامج المحاكاة يجب استخدام صورة محاكاة مع Google Play.
إذا لم يكن لديك مشروع Unity وتريد فقط تجربة أحد منتجات Firebase، يمكنك تنزيل أحد نماذج البدء السريع.
الخطوة 1: إنشاء مشروع Firebase
قبل إضافة Firebase إلى مشروع Unity، عليك إنشاء مشروع Firebase لربطه بمشروع Unity. انتقِل إلى مقالة فهم مشاريع Firebase لمزيد من المعلومات عن مشاريع Firebase.
الخطوة 2: تسجيل تطبيقك في Firebase
يمكنك تسجيل تطبيق أو لعبة أو أكثر لربطها بمشروعك على Firebase.
انتقِل إلى وحدة تحكّم Firebase.
في وسط صفحة النظرة العامة على المشروع، انقر على رمز Unity () لبدء سير عمل الإعداد.
إذا سبق لك إضافة تطبيق إلى مشروعك على Firebase، انقر على إضافة تطبيق لعرض خيارات المنصّة.
اختَر هدف الإصدار الذي تريد تسجيله في مشروع Unity، أو يمكنك اختيار تسجيل كلا الهدفَين الآن في الوقت نفسه.
أدخِل أرقام تعريف مشروعك على Unity الخاصة بالمنصة.
بالنسبة إلى أجهزة iOS: أدخِل معرّف iOS لمشروع Unity في حقل معرّف حزمة iOS.
بالنسبة إلى Android: أدخِل معرّف Android لمشروع Unity في حقل اسم حزمة Android.
غالبًا ما يُستخدَم المصطلحان اسم الحزمة ورقم تعريف التطبيق بالتبادل.
اختياري: أدخِل الأسماء المميّزة الخاصة بالمنصّة لمشروع Unity.
هذه الأسماء المستعارة هي معرّفات داخلية ومريحة ولا تظهر إلا لك في وحدة تحكّم "Firebase".انقر على تسجيل التطبيق (Register app).
الخطوة 3: إضافة ملفات إعدادات Firebase
احصل على ملفات إعداد Firebase الخاصة بالمنصة في سير عمل إعداد وحدة تحكّم Firebase.
بالنسبة إلى أجهزة iOS: انقر على تنزيل GoogleService-Info.plist.
بالنسبة إلى Android: انقر على تنزيل google-services.json.
افتح نافذة المشروع في مشروع Unity، ثم انقل ملفات الإعداد إلى مجلد
Assets.بالعودة إلى وحدة تحكّم Firebase، في سير عمل الإعداد، انقر على التالي.
الخطوة 4: إضافة حِزم تطوير البرامج (SDK) لمنصّة Firebase Unity
في وحدة تحكّم Firebase، انقر على تنزيل حزمة تطوير البرامج (SDK) لـ Firebase Unity، ثم استخرِج حزمة تطوير البرامج (SDK) في مكان مناسب.
يمكنك تنزيل حزمة تطوير البرامج (SDK) لـ Firebase Unity مرة أخرى في أي وقت.
حزمة تطوير البرامج (SDK) لـ Firebase Unity ليست خاصة بالنظام الأساسي.
في مشروع Unity المفتوح، انتقِل إلى مواد العرض > استيراد حزمة > حزمة مخصّصة.
من حزمة تطوير البرامج (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:
في نافذة استيراد حزمة Unity (Import Unity Package)، انقر على استيراد (Import).
بالعودة إلى وحدة تحكّم Firebase، في سير عمل الإعداد، انقر على التالي.
الخطوة 5: التأكّد من متطلبات إصدار "خدمات Google Play"
تتطلّب بعض المنتجات في حزمة تطوير البرامج (SDK) لـ Unity Firebase لنظام التشغيل Android استخدام Google Play services. المنتجات التي تتطلّب هذا الإجراء يجب تحديث "Google Play services" قبل استخدام هذه المنتجات.
أضِف عبارة using ورمز الإعداد التاليَين في بداية تطبيقك. يمكنك التحقّق من توفّر تحديث لـ Google Play services وتحديثه اختياريًا إلى الإصدار المطلوب قبل استدعاء أي طرق أخرى في حزمة 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.
إعداد سير عمل على الكمبيوتر المكتبي (إصدار تجريبي)
عند إنشاء لعبة، يكون من الأسهل غالبًا اختبارها في محرِّر Unity وعلى الأنظمة الأساسية لأجهزة الكمبيوتر المكتبي أولاً، ثم نشرها واختبارها على الأجهزة الجوّالة لاحقًا في مرحلة التطوير. ولدعم سير العمل هذا، نقدّم مجموعة فرعية من حزم تطوير البرامج (SDK) الخاصة بـ Firebase Unity التي يمكن تشغيلها على أنظمة التشغيل Windows وmacOS وLinux ومن داخل محرِّر Unity.
يمكنك إعداد مشروع Unity لمنصة كمبيوتر مكتبي باتّباع التعليمات نفسها المخصّصة لمنصة الأجهزة الجوّالة (ابدأ بخطوة تسجيل تطبيقك في Firebase أعلاه).
شغِّل مشروع Unity في بيئة التطوير المتكاملة (IDE) في Unity أو اختَر إنشاء مشروع Unity للكمبيوتر المكتبي.
(اختياري) شغِّل مشروع Unity في "وضع التعديل" (Edit Mode).
يمكن أيضًا تشغيل حزمة تطوير البرامج (SDK) لـ Firebase Unity في وضع التعديل في Unity، ما يسمح باستخدامها في المكوّنات الإضافية للمحرِّر.
عند إنشاء
FirebaseAppيستخدمه المحرّر، لا تستخدِم المثيل التلقائي.بدلاً من ذلك، أدخِل اسمًا فريدًا لطلب
FirebaseApp.Create().هذا الإجراء مهم لتجنُّب حدوث تعارض في الخيارات بين المثيل الذي تستخدمه بيئة التطوير المتكاملة (IDE) في Unity والمثيل الذي يستخدمه مشروعك في Unity.
منتجات Firebase المتوافقة
يمكنك الاطّلاع على مزيد من المعلومات حول مكتبات Unity Firebase في المستندات المرجعية.
مكتبات Firebase المتاحة للأجهزة الجوّالة
تتوافق حزمة تطوير البرامج (SDK) لـ Firebase Unity مع منتجات Firebase التالية على أجهزة Apple وAndroid:
| منتج Firebase | حزمة Unity |
|---|---|
| AdMob | يتم توزيعها بشكل منفصل في المكوّن الإضافي AdMob Unity |
| Firebase AI Logic | FirebaseAI.unitypackage |
| 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
|
| Realtime Database | FirebaseDatabase.unitypackage |
| Remote Config | FirebaseRemoteConfig.unitypackage
(الخيار الذي يُنصح به) FirebaseAnalytics.unitypackage
|
| المكتبات المتوقفة نهائيًا أو غير المتوافقة | |
| Dynamic Links | FirebaseDynamicLinks.unitypackage
(الخيار الذي يُنصح به) FirebaseAnalytics.unitypackage
|
مكتبات Firebase المتاحة لأجهزة الكمبيوتر المكتبي
تتضمّن حزمة تطوير البرامج (SDK) لـ Firebase Unity دعمًا لسير عمل الكمبيوتر المكتبي لمجموعة فرعية من المنتجات، ما يتيح استخدام أجزاء معيّنة من Firebase في محرِّر Unity وفي إصدارات الكمبيوتر المكتبي المستقلة على أنظمة التشغيل Windows وmacOS وLinux.
| منتج Firebase (كمبيوتر مكتبي) | حزمة Unity |
|---|---|
| Firebase AI Logic | FirebaseAI.unitypackage |
| 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.