عزز ألعاب Unity الخاصة بك باستخدام مجموعات Firebase Unity SDK.
لإظهار مدى سهولة توصيل Firebase بمشروع Unity الخاص بك ، صممنا لعبة نموذجية ، MechaHamster ، يمكنك تنزيلها من GitHub ومتجر التطبيقات ومتجر Google Play .
تعرف على مزيد من المعلومات حول تشغيل ألعابك باستخدام Firebase في صفحة ألعاب Firebase .
هل سبق لك إضافة Firebase إلى مشروع Unity الخاص بك؟ تأكد من أنك تستخدم أحدث إصدار من Firebase Unity SDK .
المتطلبات الأساسية
قم بتثبيت Unity 2018.4 أو أحدث. قد تكون الإصدارات السابقة متوافقة أيضًا ولكن لن يتم دعمها بشكل فعال. يعتبر دعم Unity 2018.4 مهملاً ، ولن يتم دعمه بشكل نشط بعد الإصدار الرئيسي التالي.
(iOS فقط) قم بتثبيت ما يلي:
- Xcode 13.3.1 أو أعلى
- CocoaPods 1.10.0 أو أعلى
تأكد من أن مشروع الوحدة الخاص بك يلبي هذه المتطلبات:
- لنظام iOS - يستهدف iOS 10 أو أعلى
لنظام التشغيل Android - يستهدف مستوى API 19 (KitKat) أو أعلى
قم بإعداد جهاز مادي أو استخدام محاكي لتشغيل تطبيقك.
لنظام iOS - قم بإعداد جهاز iOS فعلي أو استخدم محاكي iOS.
بالنسبة إلى Cloud Messaging على iOS ، إليك المتطلبات الأساسية:
- قم بإعداد جهاز iOS فعلي .
- احصل على مفتاح مصادقة Apple Push Notification لحساب Apple Developer الخاص بك.
- قم بتمكين دفع الإخطارات في XCode ضمن التطبيق> القدرات .
لنظام Android - يجب أن تستخدم المحاكيات صورة المحاكي مع Google Play.
- سجّل الدخول إلى Firebase باستخدام حساب Google الخاص بك.
إذا لم يكن لديك بالفعل مشروع Unity وترغب فقط في تجربة أحد منتجات Firebase ، فيمكنك تنزيل إحدى عينات البدء السريع الخاصة بنا.
الخطوة 1 : أنشئ مشروع Firebase
قبل أن تتمكن من إضافة Firebase إلى مشروع Unity الخاص بك ، تحتاج إلى إنشاء مشروع Firebase للاتصال بمشروع Unity الخاص بك. تفضل بزيارة فهم مشاريع Firebase لمعرفة المزيد حول مشاريع Firebase.
الخطوة 2 : تسجيل تطبيقك في Firebase
يمكنك تسجيل تطبيق أو لعبة واحدة أو أكثر للتواصل مع مشروع Firebase.
انتقل إلى وحدة تحكم Firebase .
في وسط صفحة نظرة عامة على المشروع ، انقر فوق أيقونة الوحدة (
) لبدء سير عمل الإعداد.إذا كنت قد أضفت بالفعل تطبيقًا إلى مشروع Firebase ، فانقر فوق إضافة تطبيق لعرض خيارات النظام الأساسي.
حدد أي هدف بناء لمشروع الوحدة الخاص بك الذي ترغب في تسجيله ، أو يمكنك حتى تحديد تسجيل كلا الهدفين الآن في نفس الوقت.
أدخل المعرف (المعرفات) الخاص بالنظام الأساسي لمشروع الوحدة الخاص بك.
لنظام iOS - أدخل معرف iOS لمشروع Unity الخاص بك في حقل معرف حزمة iOS .
لنظام Android - أدخل معرف Android الخاص بمشروع Unity في حقل اسم حزمة Android .
غالبًا ما يتم استخدام المصطلحين اسم الحزمة ومعرف التطبيق بالتبادل.
افتح مشروع Unity الخاص بك في Unity IDE الخاص بك ، ثم انتقل إلى قسم الإعدادات لكل نظام أساسي:
لنظام iOS - انتقل إلى إنشاء الإعدادات> iOS .
لنظام Android - انتقل إلى Android> إعدادات المشغل> إعدادات أخرى .
معرف مشروع الوحدة الخاص بك هو قيمة معرف الحزمة (معرف المثال:
com.yourcompany.yourproject
).(اختياري) أدخل الألقاب الخاصة بالنظام الأساسي لمشروع الوحدة الخاص بك.
هذه الأسماء المستعارة هي معرفات داخلية وملائمة ولا تظهر إلا لك في وحدة تحكم Firebase.انقر فوق تسجيل التطبيق .
الخطوة 3 : أضف ملفات تهيئة Firebase
احصل على ملف (ملفات) تكوين Firebase الخاص بالنظام الأساسي في سير عمل إعداد وحدة تحكم Firebase.
لنظام iOS - انقر فوق تنزيل GoogleService-Info.plist .
لنظام التشغيل Android - انقر فوق تنزيل google-services.json .
يحتوي ملف تهيئة Firebase على معرّفات فريدة ولكنها غير سرية لمشروعك. لمعرفة المزيد حول ملف التكوين هذا ، تفضل بزيارة فهم مشاريع Firebase .
يمكنك تنزيل ملف تهيئة Firebase مرة أخرى في أي وقت.
تأكد من عدم إلحاق اسم ملف التكوين بأحرف إضافية ، مثل
(2)
.
افتح نافذة المشروع في مشروع الوحدة الخاص بك ، ثم انقل ملف (ملفات) التكوين إلى مجلد
Assets
.مرة أخرى في وحدة تحكم Firebase ، في سير عمل الإعداد ، انقر فوق " التالي ".
الخطوة 4 : أضف حزم Firebase Unity SDK
في وحدة تحكم Firebase ، انقر على تنزيل Firebase Unity SDK ، ثم قم بفك ضغط SDK في مكان مناسب.
يمكنك تنزيل Firebase Unity SDK مرة أخرى في أي وقت.
إن حزمة Firebase Unity SDK ليست خاصة بالنظام الأساسي.
في مشروع Unity المفتوح ، انتقل إلى Assets > Import Package > Custom Package .
من حزمة SDK غير المضغوطة ، حدد منتجات Firebase المدعومة التي تريد استخدامها في تطبيقك.
تم تمكين التحليلات
- أضف حزمة Firebase لبرنامج Google Analytics:
FirebaseAnalytics.unitypackage
- أضف الحزم لأي من منتجات Firebase الأخرى التي تريد استخدامها في تطبيقك. على سبيل المثال ، لاستخدام مصادقة Firebase وقاعدة بيانات Firebase Realtime:
FirebaseAuth.unitypackage
وFirebaseDatabase.unitypackage
لم يتم تمكين التحليلات
أضف حزم منتجات Firebase التي تريد استخدامها في تطبيقك. على سبيل المثال ، لاستخدام مصادقة Firebase وقاعدة بيانات Firebase Realtime:
FirebaseAuth.unitypackage
وFirebaseDatabase.unitypackage
- أضف حزمة Firebase لبرنامج Google Analytics:
في نافذة استيراد حزمة الوحدة ، انقر فوق استيراد .
مرة أخرى في وحدة تحكم Firebase ، في سير عمل الإعداد ، انقر فوق " التالي ".
الخطوة 5 : تأكيد متطلبات إصدار خدمات Google Play
تتطلب حزمة Firebase Unity SDK لنظام Android خدمات Google Play ، والتي يجب أن تكون محدثة قبل التمكن من استخدام SDK.
أضف الكود التالي في بداية التطبيق الخاص بك. يمكنك التحقق من خدمات Google Play وتحديثها اختياريًا إلى الإصدار المطلوب بواسطة Firebase Unity SDK قبل استدعاء أي طرق أخرى في 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. } });
أنت جاهز تمامًا! تم تسجيل مشروع الوحدة الخاص بك وتهيئته لاستخدام Firebase.
إذا كنت تواجه مشكلة في الإعداد ، فانتقل إلى قسم استكشاف الأخطاء وإصلاحها والأسئلة الشائعة في Unity .
إعداد سير عمل سطح المكتب ( تجريبي )
عند إنشاء لعبة ، غالبًا ما يكون من الأسهل كثيرًا اختبار لعبتك في محرر Unity وعلى الأنظمة الأساسية لسطح المكتب أولاً ، ثم نشرها واختبارها على الأجهزة المحمولة لاحقًا في مرحلة التطوير. لدعم سير العمل هذا ، نقدم مجموعة فرعية من Firebase Unity SDKs والتي يمكن تشغيلها على أنظمة تشغيل Windows و macOS و Linux ومن داخل محرر Unity.
قم بإعداد مشروع Unity الخاص بالنظام الأساسي لسطح المكتب باتباع نفس التعليمات الخاصة بمنصة الأجهزة المحمولة (ابدأ بخطوة تسجيل تطبيقك باستخدام Firebase أعلاه).
قم بتشغيل مشروع Unity الخاص بك في Unity IDE أو حدد إنشاء مشروع Unity الخاص بك لسطح المكتب .
(اختياري) قم بتشغيل مشروع الوحدة في وضع التحرير.
يمكن أيضًا تشغيل Firebase Unity SDK في وضع تحرير Unity ، مما يسمح باستخدامه في مكونات المحرر الإضافية.
عندما تنشئ
FirebaseApp
يستخدمه المحرر ، لا تستخدم النسخة الافتراضية.بدلاً من ذلك ، قم بتوفير اسم فريد لاستدعاء
FirebaseApp.Create()
.هذا مهم لتجنب التعارض في الخيارات بين المثيل المستخدم بواسطة Unity IDE والمثيل الذي يستخدمه مشروع Unity الخاص بك.
منتجات Firebase المدعومة
تعرف على المزيد حول مكتبات Unity Firebase في الوثائق المرجعية .
تدعم حزمة Firebase Unity SDK منتجات Firebase التالية على نظامي التشغيل iOS و Android :
منتج Firebase | حزمة الوحدة |
---|---|
AdMob | يتم توزيعها بشكل منفصل في AdMob Unity Plugin |
تحليلات | 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 المدعومة (سطح المكتب)
تتضمن حزمة Firebase Unity SDK دعمًا لسير عمل سطح المكتب لمجموعة فرعية من المنتجات ، مما يتيح استخدام أجزاء معينة من Firebase في محرر Unity وفي تصميمات سطح المكتب المستقلة على أنظمة التشغيل Windows و macOS و Linux.
منتج Firebase (سطح المكتب) | حزمة الوحدة |
---|---|
المصادقة | FirebaseAuth.unitypackage |
وظائف السحابة | FirebaseFunctions.unitypackage |
سحابة Firestore | FirebaseFirestore.unitypackage |
سحابة التخزين | FirebaseStorage.unitypackage |
قاعدة بيانات الوقت الفعلي | FirebaseDatabase.unitypackage |
التكوين عن بعد | FirebaseRemoteConfig.unitypackage |
يوفر Firebase مكتبات سطح المكتب المتبقية كتطبيقات روتينية (غير وظيفية) للراحة عند الإنشاء لأنظمة Windows و macOS و Linux. لذلك ، لا تحتاج إلى ترجمة التعليمات البرمجية بشكل مشروط لاستهداف سطح المكتب.
الخطوات التالية
استكشاف نماذج تطبيقات Firebase .
استعد لإطلاق تطبيقك:
- قم بإعداد تنبيهات الميزانية لمشروعك في Google Cloud Console.
- راقب لوحة معلومات الاستخدام والفوترة في وحدة تحكم Firebase للحصول على صورة شاملة لاستخدام مشروعك عبر خدمات Firebase المتعددة.
- راجع قائمة التحقق من إطلاق Firebase .
هل تواجه مشكلة في Firebase ومشروع Unity الخاص بك؟ قم بزيارة Unity استكشاف الأخطاء وإصلاحها والأسئلة الشائعة .