عزِّز قدرات ألعاب Unity باستخدام حِزم تطوير البرامج (SDK) الخاصة بمنصّة Firebase Unity.
لتوضيح مدى سهولة دمج Firebase في مشروعك على Unity، صمّمنا نموذج لعبة، MechaHamster. إذا أردت تجربة إضافة Firebase إلى لعبة، استخدِم إصدار المبتدئين المتوفّر على GitHub. إذا أردت نسخة مكتملة، يمكنك الاطّلاع على الإصدارات في App Store أو متجر Google Play.
يمكنك الاطّلاع على مزيد من المعلومات حول تحسين أداء ألعابك باستخدام Firebase من خلال صفحة ألعاب Firebase.
هل سبق لك إضافة Firebase إلى مشروع Unity؟ تأكَّد من استخدام أحدث إصدار من حزمة تطوير البرامج Unity من Firebase.
المتطلّبات الأساسية
تثبيت Unity 2019.1 أو إصدار أحدث. قد تكون الإصدارات السابقة متوافقة أيضًا ولكن لن تكون مدعومة بشكل نشط. يُعَدّ دعم Unity 2019.1 متوقفًا ولن يعود متاحًا بشكل نشط بعد الإصدار الرئيسي التالي.
(أنظمة Apple الأساسية فقط) ثبِّت ما يلي:
- Xcode 13.3.1 أو إصدار أحدث
- الإصدار 1.12.0 من CocoaPods أو إصدار أحدث
احرص على أن يستوفي مشروعك في Unity المتطلبات التالية:
- لنظام التشغيل iOS: يستهدف الإصدار 11 من نظام التشغيل iOS أو الإصدارات الأحدث.
- لنظام التشغيل tvOS - يستهدف الإصدار tvOS 12 أو الإصدارات الأحدث.
- لنظام التشغيل Android: يستهدف المستوى 19 من واجهة برمجة التطبيقات (KitKat) أو أعلى
ابدأ بإعداد جهاز فعلي أو استخدام محاكي لتشغيل تطبيقك.
بالنسبة إلى أنظمة Apple الأساسية: يمكنك إعداد جهاز فعلي أو استخدام محاكي iOS أو tvOS.
على أجهزة Android - يجب أن تستخدم المحاكيات صورة للمحاكي مع Google Play.
- سجّل الدخول إلى Firebase باستخدام حسابك في Google.
إذا لم يكن لديك مشروع 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.انقر على تسجيل التطبيق.
الخطوة 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) Unity من Firebase مرة أخرى في أي وقت.
إنّ حزمة تطوير البرامج (SDK) لمنصة Firebase Unity ليست خاصة بالنظام الأساسي.
في مشروع Unity المفتوح، انتقِل إلى مواد العرض > استيراد حزمة > الحزمة المخصّصة.
من حزمة SDK غير المضغوطة، اختَر منتجات Firebase المتوافقة التي تريد استخدامها في تطبيقك.
تفعيل الإحصاءات
- إضافة حزمة Firebase الخاصة بخدمة "إحصاءات Google":
FirebaseAnalytics.unitypackage
- أضِف الحِزم لأي منتجات أخرى من Firebase تريد استخدامها في
تطبيقك. على سبيل المثال، لاستخدام مصادقة Firebase
وقاعدة بيانات Firebase في الوقت الفعلي:
FirebaseAuth.unitypackage
وFirebaseDatabase.unitypackage
عدم تفعيل الإحصاءات
أضِف حِزم منتجات Firebase التي تريد استخدامها في تطبيقك. على سبيل المثال، لاستخدام مصادقة Firebase وقاعدة بيانات Firebase في الوقت الفعلي:
FirebaseAuth.unitypackage
وFirebaseDatabase.unitypackage
- إضافة حزمة Firebase الخاصة بخدمة "إحصاءات Google":
في نافذة استيراد حزمة Unity، انقر على استيراد.
في "وحدة تحكُّم Firebase"، انقر على التالي في سير عمل الإعداد.
الخطوة 5: التأكّد من متطلبات إصدار "خدمات Google Play"
تتطلّب حزمة تطوير البرامج (SDK) لمنصّة Firebase Unity لنظام التشغيل Android خدمات Google Play، التي يجب أن تكون محدّثة قبل استخدام حزمة تطوير البرامج (SDK).
أضِف عبارة using
ورمز الإعداد التاليَين في بداية التطبيق. يمكنك التحقّق من توفّر خدمات Google Play وتحديثها اختياريًا إلى
الإصدار المطلوب في حزمة تطوير البرامج (SDK) لمنصّة 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 وحلّها والأسئلة الشائعة.
إعداد سير عمل أجهزة كمبيوتر سطح المكتب (إصدار تجريبي)
عند إنشاء لعبة، غالبًا ما يكون من الأسهل كثيرًا اختبار لعبتك في "محرِّر Unity" وعلى الأنظمة الأساسية لأجهزة الكمبيوتر المكتبية أولاً، ثم نشرها واختبارها على الأجهزة الجوّالة لاحقًا في مرحلة التطوير. ولدعم سير العمل هذا، نقدّم مجموعة فرعية من حِزم تطوير البرامج (SDK) لمنصّة Firebase Unity التي يمكن تشغيلها على أنظمة التشغيل Windows وmacOS وLinux ومن داخل محرّر Unity.
يمكنك إعداد مشروع Unity على نظام أساسي مخصّص لأجهزة الكمبيوتر المكتبي من خلال اتّباع التعليمات نفسها الخاصة بالنظام الأساسي للأجهزة الجوّالة (ابدأ بعملية تسجيل تطبيقك في Firebase أعلاه).
يمكنك تشغيل مشروع Unity في Unity IDE أو اختيار إنشاء مشروع Unity لنظام كمبيوتر مكتبي.
(اختياري) يمكنك تنفيذ مشروع Unity في "وضع التعديل".
يمكن أيضًا تشغيل حزمة تطوير البرامج (SDK) لمنصة Firebase Unity في وضع التعديل من Unity، ما يسمح باستخدامها في المكوّنات الإضافية للمحرّر.
عند إنشاء عنصر
FirebaseApp
يستخدمه المحرِّر، لا تستخدِم المثيل التلقائي.بدلاً من ذلك، قدِّم اسمًا فريدًا للمكالمة
FirebaseApp.Create()
.يُعدّ ذلك مهمًا لتجنُّب حدوث تعارض في الخيارات بين المثيل المستخدَم من قِبل Unity IDE والمثيل المستخدَم في مشروع Unity.
منتجات Firebase المتوافقة
يمكنك الاطّلاع على المزيد من المعلومات حول مكتبات Unity Firebase في المستندات المرجعية.
مكتبات Firebase المتاحة للأجهزة الجوّالة
تتوافق حزمة تطوير برامج Firebase Unity مع منتجات Firebase التالية على Apple وAndroid:
منتج Firebase | حزمة Unity |
---|---|
AdMob | توزيعها بشكل منفصل في مكوّن Unity الإضافي من AdMob |
إحصاءات Google | FirebaseAnalytics.unitypackage |
فحص التطبيقات | FirebaseAppCheck.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) لمنصّة Firebase Unity إتاحة سير العمل على أجهزة الكمبيوتر المكتبي لمجموعة فرعية من المنتجات، ما يتيح استخدام أجزاء معيّنة من Firebase في محرِّر Unity وفي إصدارات أجهزة الكمبيوتر المكتبي المستقلة على أنظمة التشغيل Windows وmacOS وLinux.
منتج Firebase (جهاز كمبيوتر مكتبي) | حزمة Unity |
---|---|
فحص التطبيقات | FirebaseAppCheck.unitypackage |
المصادقة | FirebaseAuth.unitypackage |
الوظائف السحابية | FirebaseFunctions.unitypackage |
Cloud Firestore | FirebaseFirestore.unitypackage |
التخزين في السحابة الإلكترونية | FirebaseStorage.unitypackage |
قاعدة بيانات الوقت الفعلي | FirebaseDatabase.unitypackage |
الإعداد عن بُعد | FirebaseRemoteConfig.unitypackage |
ويوفر Firebase مكتبات سطح المكتب المتبقية كعمليات تنفيذ بديلة (غير فعّالة) لتيسير إنشاءها عند إنشاء أنظمة التشغيل Windows وmacOS وLinux. لذلك، لا تحتاج إلى تجميع الرمز البرمجي بشكل مشروط لاستهداف سطح المكتب.
الخطوات اللاحقة
استكشِف نماذج تطبيقات Firebase.
الاستعداد لإطلاق تطبيقك:
- إعداد تنبيهات الميزانية لمشروعك في Google Cloud Console
- راقِب لوحة بيانات الاستخدام والفوترة في وحدة تحكُّم Firebase للحصول على صورة عامة عن استخدام مشروعك على عدّة خدمات في Firebase.
- راجِع قائمة التحقّق الخاصة بإطلاق Firebase.
هل تواجه مشكلة في Firebase ومشروع Unity؟ انتقِل إلى قسم تحديد المشاكل وحلّها في Unity والأسئلة الشائعة حولها.