أضف 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 11 أو أعلى

  • لنظام التشغيل 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.

أنشئ مشروع Firebase

1. في وحدة تحكم Firebase ، انقر على إضافة مشروع .

   • لإضافة موارد Firebase إلى مشروع Google Cloud موجود ، أدخل اسم المشروع أو حدده من القائمة المنسدلة.

   • لإنشاء مشروع جديد ، أدخل اسم المشروع المطلوب. يمكنك أيضًا تعديل معرّف المشروع المعروض أسفل اسم المشروع اختياريًا.

2. راجع شروط Firebase واقبلها ، إذا طُلب منك ذلك.

3. انقر فوق متابعة .

4. (اختياري) قم بإعداد Google Analytics لمشروعك ، مما يتيح لك الحصول على تجربة مثالية باستخدام أي من منتجات Firebase التالية:

   Firebase Crashlytics Firebase Cloud Messaging

   المراسلة داخل تطبيق Firebase تهيئة Firebase عن بُعد

   التخصيص عن بعد اختبار Firebase A / B

   حدد إما حساب Google Analytics موجود أو لإنشاء حساب جديد.

   إذا أنشأت حسابًا جديدًا ، فحدد موقع تقارير Analytics ، ثم اقبل إعدادات مشاركة البيانات وشروط Google Analytics لمشروعك.

5. انقر على إنشاء مشروع (أو إضافة Firebase ، إذا كنت تستخدم مشروع Google Cloud موجودًا).

يوفر Firebase الموارد تلقائيًا لمشروع Firebase. عند اكتمال العملية ، سيتم نقلك إلى صفحة النظرة العامة لمشروع Firebase في وحدة تحكم Firebase.

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

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

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

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

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

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

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

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

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

   أين تجد معرف مشروع الوحدة الخاص بك؟

   افتح مشروع Unity الخاص بك في Unity IDE الخاص بك ، ثم انتقل إلى قسم الإعدادات لكل نظام أساسي:

   • لنظام iOS - انتقل إلى إنشاء الإعدادات> iOS .

   • لنظام Android - انتقل إلى Android> إعدادات المشغل> إعدادات أخرى .

   معرف مشروع الوحدة الخاص بك هو قيمة معرف الحزمة (معرف المثال: com.yourcompany.yourproject ).

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

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

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

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

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

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

   ماذا تريد أن تعرف عن ملف التكوين هذا؟

   • يحتوي ملف تهيئة Firebase على معرّفات فريدة ولكنها غير سرية لمشروعك. لمعرفة المزيد حول ملف التكوين هذا ، تفضل بزيارة فهم مشاريع Firebase .

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

   • تأكد من عدم إلحاق اسم ملف التكوين بأحرف إضافية ، مثل (2) .

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

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

• استكشف نماذج تطبيقات Firebase .

• استعد لإطلاق تطبيقك:

  • قم بإعداد تنبيهات الميزانية لمشروعك في Google Cloud Console.
  • راقب لوحة معلومات الاستخدام والفوترة في وحدة تحكم Firebase للحصول على صورة شاملة لاستخدام مشروعك عبر خدمات Firebase المتعددة.
  • راجع قائمة التحقق من إطلاق Firebase .

• هل تواجه مشكلة في Firebase ومشروع Unity الخاص بك؟ قم بزيارة Unity استكشاف الأخطاء وإصلاحها والأسئلة الشائعة .