عزِّز قدرات ألعاب Unity باستخدام حِزم تطوير البرامج (SDK) الخاصة بمنصّة Firebase Unity.
لتوضيح مدى سهولة دمج Firebase في مشروع Unity، أنشأنا نموذج لعبة، MechaHamster. إذا كنت تريد تجربة إضافة Firebase إلى لعبة، استخدم نسخة المبتدئين المتوفرة على GitHub. إذا كنت تريد إصدارًا مكتملاً، ضع علامة في المربّع الإصدارات في App Store أو متجر Google Play.
لمزيد من المعلومات عن تحسين أداء ألعابك باستخدام Firebase، انتقِل إلى صفحة ألعاب Firebase:
هل سبق لك إضافة Firebase إلى مشروع Unity؟ تأكد من استخدام أحدث إصدار من حزمة تطوير البرامج Unity من Firebase.
المتطلبات الأساسية
يجب تثبيت الإصدار Unity 2021 من قناة الدعم الطويل الأمد (LTS) أو إصدار أحدث. نولي أهمية كبرى لمبادئ Unity 2020 ، ولن يتم دعمها بشكل نشط بعد المشروع الرئيسي التالي . قد تكون الإصدارات السابقة متوافقة أيضًا ولكنها لن تكون نشطة.
(أنظمة Apple الأساسية فقط) ثبِّت ما يلي:
- Xcode 13.3.1 أو إصدار أحدث
- الإصدار 1.12.0 من CocoaPods أو إصدار أحدث
احرص على أن يستوفي مشروعك في Unity المتطلبات التالية:
- لنظام التشغيل iOS: يستهدف الإصدار 13 من نظام التشغيل iOS أو الإصدارات الأحدث.
- لنظام التشغيل tvOS - يستهدف الإصدار tvOS 13 أو الإصدارات الأحدث.
- لنظام التشغيل Android: يستهدف المستوى 19 من واجهة برمجة التطبيقات (KitKat) أو أعلى
ابدأ بإعداد جهاز فعلي أو استخدام محاكي لتشغيل تطبيقك.
بالنسبة إلى أنظمة Apple الأساسية: يمكنك إعداد جهاز فعلي أو استخدام نظام التشغيل iOS أو tvOS. المحاكي.
على أجهزة Android — يجب على المحاكيات استخدام صورة المحاكي في Google Play.
- سجّل الدخول إلى Firebase باستخدام حسابك الحساب.
إذا لم يكن لديك مشروع Unity ولم يسبق لك سوى تجربة منصة Firebase يمكنك تنزيل أحد نماذج البدء السريع لدينا.
الخطوة 1: إنشاء مشروع على Firebase
يجب إنشاء منصة Firebase لتتمكّن من إضافة منصة Firebase إلى مشروع Unity. لربطه بمشروع Unity. زيارة الموقع يمكنك فهم مشاريع Firebase للحصول على مزيد من المعلومات حول. مشاريع Firebase:
الخطوة 2: تسجيل تطبيقك في Firebase
يمكنك تسجيل تطبيق أو لعبة واحدة أو أكثر لربطها بحسابك على Firebase. مشروعك.
انتقِل إلى وحدة تحكُّم Firebase.
في منتصف صفحة النظرة العامة على المشروع، انقر على رمز Unity. (
) لبدء عملية الإعدادإذا سبق لك إضافة تطبيق إلى مشروعك على Firebase، انقر على إضافة تطبيق. لعرض خيارات النظام الأساسي.
اختَر التصميم المستهدَف لمشروع Unity الذي تريد تسجيله، أو يمكنك اختيار تسجيل كلا الهدفَين الآن في الوقت نفسه.
أدخِل أرقام التعريف الخاصة بالمنصّة الخاصة بمشروع Unity.
على أجهزة iOS: أدخِل رقم تعريف iOS لمشروع Unity في حزمة iOS رقم التعريف .
على أجهزة Android: أدخِل معرّف Android لمشروع Unity في حزمة Android name.
غالبًا ما يتم استخدام المصطلحين اسم الحزمة ورقم تعريف التطبيق. بالتبادل.
(اختياري) أدخِل الأسماء المستعارة الخاصة بمنصة مشروع 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) Unity من Firebase قبل طلب أي إصدار
في حزمة 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 المتاحة للأجهزة الجوّالة
توفِّر حزمة تطوير البرامج (SDK) لمنصة 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 وحلّها الأسئلة الشائعة: