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

قم بتعزيز ألعاب Unity الخاصة بك باستخدام حزم Firebase Unity SDK الخاصة بنا.

لإظهار مدى سهولة توصيل Firebase بمشروع Unity الخاص بك، قمنا بإنشاء نموذج للعبة، MechaHamster. إذا كنت تريد تجربة إضافة Firebase إلى إحدى الألعاب، فاستخدم الإصدار المبدئي الموجود على GitHub . إذا كنت تريد إصدارًا مكتملاً، فاطلع على الإصدارات في App Store أو متجر Google Play .

ميكا هامستر (جيثب)

ميكاهامستر (متجر التطبيقات)

MechaHamster (متجر Play)


اكتشف المزيد من المعلومات حول تشغيل ألعابك باستخدام Firebase على صفحة ألعاب Firebase الخاصة بنا.

هل أضفت Firebase بالفعل إلى مشروع Unity الخاص بك؟ تأكد من أنك تستخدم أحدث إصدار من Firebase Unity SDK .

المتطلبات الأساسية

  • قم بتثبيت Unity 2019.1 أو الأحدث. قد تكون الإصدارات السابقة متوافقة أيضًا ولكنها لن تكون مدعومة بشكل فعال. يعتبر دعم Unity 2019.1 مهملاً، ولن يتم دعمه بشكل نشط بعد الإصدار الرئيسي التالي.

  • (أنظمة Apple الأساسية فقط) قم بتثبيت ما يلي:

    • Xcode 13.3.1 أو أعلى
    • CocoaPods 1.12.0 أو أعلى
  • تأكد من أن مشروع Unity الخاص بك يلبي هذه المتطلبات:

    • لنظام التشغيل iOS - يستهدف نظام التشغيل iOS 11 أو أعلى
    • بالنسبة إلى tvOS - يستهدف tvOS 12 أو أعلى
    • لنظام Android - يستهدف مستوى API 19 (KitKat) أو أعلى
  • قم بإعداد جهاز فعلي أو استخدم محاكيًا لتشغيل تطبيقك.

    • لمنصات Apple - قم بإعداد جهاز فعلي أو استخدم محاكي iOS أو tvOS.

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

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

الخطوة 1 : إنشاء مشروع Firebase

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

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

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

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

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

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

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

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

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

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

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

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

الخطوة 3 : إضافة ملفات تكوين Firebase

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

    • لنظام التشغيل iOS - انقر على تنزيل GoogleService-Info.plist .

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

  2. افتح نافذة المشروع لمشروع Unity الخاص بك، ثم انقل ملف (ملفات) التكوين الخاصة بك إلى مجلد 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.

أضف ما يلي using بيان ورمز التهيئة في بداية التطبيق الخاص بك. يمكنك التحقق من خدمات Google Play وتحديثها اختياريًا إلى الإصدار المطلوب بواسطة Firebase Unity SDK قبل استدعاء أي طرق أخرى في 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 وعلى الأنظمة الأساسية لسطح المكتب أولاً، ثم نشرها واختبارها على الأجهزة المحمولة لاحقًا في مرحلة التطوير. لدعم سير العمل هذا، نقدم مجموعة فرعية من حزم Firebase Unity SDK التي يمكن تشغيلها على أنظمة التشغيل Windows وmacOS وLinux ومن داخل محرر Unity.

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

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

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

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

    1. عند إنشاء تطبيق FirebaseApp يستخدمه المحرر، لا تستخدم المثيل الافتراضي.

    2. بدلاً من ذلك، قم بتوفير اسم فريد لاستدعاء FirebaseApp.Create() .

      يعد هذا أمرًا مهمًا لتجنب التعارض في الخيارات بين المثيل الذي يستخدمه Unity IDE والمثيل الذي يستخدمه مشروع Unity الخاص بك.

منتجات Firebase المدعومة

تعرف على المزيد حول مكتبات Unity Firebase في الوثائق المرجعية .

مكتبات Firebase المتاحة للجوال

تدعم Firebase Unity SDK منتجات Firebase التالية على Apple و Android :

منتج فايربيس حزمة الوحدة
ادموب يتم توزيعها بشكل منفصل في AdMob Unity Plugin
التحليلات FirebaseAnalytics.unitypackage
فحص التطبيق FirebaseAppCheck.unitypackage
المصادقة FirebaseAuth.unitypackage
سحابة فايرستور 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 (سطح المكتب) حزمة الوحدة
فحص التطبيق FirebaseAppCheck.unitypackage
المصادقة FirebaseAuth.unitypackage
وظائف السحابة FirebaseFunctions.unitypackage
سحابة فايرستور FirebaseFirestore.unitypackage
سحابة التخزين FirebaseStorage.unitypackage
قاعدة بيانات الوقت الحقيقي FirebaseDatabase.unitypackage
التكوين عن بعد FirebaseRemoteConfig.unitypackage

يوفر Firebase مكتبات سطح المكتب المتبقية كتطبيقات أساسية (غير وظيفية) لتوفير الراحة عند الإنشاء لنظام التشغيل Windows، وmacOS، وLinux. لذلك، لا تحتاج إلى ترجمة التعليمات البرمجية بشكل مشروط لاستهداف سطح المكتب.

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