أضف Firebase إلى مشروع الوحدة الخاص بك

عزز ألعاب Unity الخاصة بك باستخدام مجموعات Firebase Unity SDK.

لإظهار مدى سهولة توصيل Firebase بمشروع Unity الخاص بك ، صممنا لعبة نموذجية ، MechaHamster ، يمكنك تنزيلها من GitHub ومتجر التطبيقات ومتجر Google Play .

MechaHamster (جيثب)

MechaHamster (متجر التطبيقات)

MechaHamster (متجر 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.

    • لنظام Android - يجب أن تستخدم المحاكيات صورة المحاكي مع Google Play.

إذا لم يكن لديك بالفعل مشروع Unity وترغب فقط في تجربة أحد منتجات Firebase ، فيمكنك تنزيل إحدى عينات البدء السريع الخاصة بنا.

الخطوة 1 : أنشئ مشروع Firebase

قبل أن تتمكن من إضافة Firebase إلى مشروع Unity الخاص بك ، تحتاج إلى إنشاء مشروع Firebase للاتصال بمشروع Unity الخاص بك. تفضل بزيارة فهم مشاريع Firebase لمعرفة المزيد حول مشاريع Firebase.

الخطوة 2 : تسجيل تطبيقك في Firebase

يمكنك تسجيل تطبيق أو لعبة واحدة أو أكثر للتواصل مع مشروع Firebase.

  1. انتقل إلى وحدة تحكم Firebase .

  2. في وسط صفحة نظرة عامة على المشروع ، انقر فوق أيقونة الوحدة ( ) لبدء سير عمل الإعداد.

    إذا كنت قد أضفت بالفعل تطبيقًا إلى مشروع Firebase ، فانقر فوق إضافة تطبيق لعرض خيارات النظام الأساسي.

  3. حدد أي هدف بناء لمشروع الوحدة الخاص بك الذي ترغب في تسجيله ، أو يمكنك حتى تحديد تسجيل كلا الهدفين الآن في نفس الوقت.

  4. أدخل المعرف (المعرفات) الخاص بالنظام الأساسي لمشروع الوحدة الخاص بك.

    • لنظام iOS - أدخل معرف iOS لمشروع Unity الخاص بك في حقل معرف حزمة iOS .

    • لنظام Android - أدخل معرف Android الخاص بمشروع Unity في حقل اسم حزمة Android .
      غالبًا ما يتم استخدام المصطلحين اسم الحزمة ومعرف التطبيق بالتبادل.

  5. (اختياري) أدخل الألقاب الخاصة بالنظام الأساسي لمشروع الوحدة الخاص بك.
    هذه الأسماء المستعارة هي معرفات داخلية وملائمة ولا تظهر إلا لك في وحدة تحكم Firebase.

  6. انقر فوق تسجيل التطبيق .

الخطوة 3 : أضف ملفات تهيئة Firebase

  1. احصل على ملف (ملفات) تكوين Firebase الخاص بالنظام الأساسي في سير عمل إعداد وحدة تحكم Firebase.

    • لنظام iOS - انقر فوق تنزيل GoogleService-Info.plist .

    • لنظام التشغيل Android - انقر فوق تنزيل google-services.json .

  2. افتح نافذة المشروع في مشروع الوحدة الخاص بك ، ثم انقل ملف (ملفات) التكوين إلى مجلد Assets .

  3. مرة أخرى في وحدة تحكم Firebase ، في سير عمل الإعداد ، انقر فوق " التالي ".

الخطوة 4 : أضف حزم Firebase Unity SDK

  1. في وحدة تحكم Firebase ، انقر على تنزيل Firebase Unity SDK ، ثم قم بفك ضغط SDK في مكان مناسب.

    • يمكنك تنزيل Firebase Unity SDK مرة أخرى في أي وقت.

    • إن حزمة Firebase Unity SDK ليست خاصة بالنظام الأساسي.

  2. في مشروع Unity المفتوح ، انتقل إلى Assets > Import Package > Custom Package .

  3. من حزمة SDK غير المضغوطة ، حدد منتجات Firebase المدعومة التي تريد استخدامها في تطبيقك.

    تم تمكين التحليلات

    • أضف حزمة Firebase لبرنامج Google Analytics: FirebaseAnalytics.unitypackage
    • أضف الحزم لأي من منتجات Firebase الأخرى التي تريد استخدامها في تطبيقك. على سبيل المثال ، لاستخدام مصادقة Firebase وقاعدة بيانات Firebase Realtime:
      FirebaseAuth.unitypackage و FirebaseDatabase.unitypackage

    لم يتم تمكين التحليلات

    أضف حزم منتجات Firebase التي تريد استخدامها في تطبيقك. على سبيل المثال ، لاستخدام مصادقة Firebase وقاعدة بيانات Firebase Realtime:
    FirebaseAuth.unitypackage و FirebaseDatabase.unitypackage

  4. في نافذة استيراد حزمة الوحدة ، انقر فوق استيراد .

  5. مرة أخرى في وحدة تحكم 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.

  1. قم بإعداد مشروع Unity الخاص بالنظام الأساسي لسطح المكتب باتباع نفس التعليمات الخاصة بمنصة الأجهزة المحمولة (ابدأ بخطوة تسجيل تطبيقك باستخدام Firebase أعلاه).

  2. قم بتشغيل مشروع Unity الخاص بك في Unity IDE أو حدد إنشاء مشروع Unity الخاص بك لسطح المكتب .

  3. (اختياري) قم بتشغيل مشروع الوحدة في وضع التحرير.

    يمكن أيضًا تشغيل Firebase Unity SDK في وضع تحرير Unity ، مما يسمح باستخدامه في مكونات المحرر الإضافية.

    1. عندما تنشئ FirebaseApp يستخدمه المحرر ، لا تستخدم النسخة الافتراضية.

    2. بدلاً من ذلك ، قم بتوفير اسم فريد لاستدعاء 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. لذلك ، لا تحتاج إلى ترجمة التعليمات البرمجية بشكل مشروط لاستهداف سطح المكتب.

الخطوات التالية