Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

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

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

لاظهار كم هو سهل للسد Firebase في مشروع الوحدة الخاصة بك، قدمنا مباراة عينة، MechaHamster، والتي يمكن تنزيلها من جيثب، المتجر، ومتجر Google Play.

MechaHamster (جيثب)

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

MechaHamster (متجر Play)


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

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

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

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

  • (دائرة الرقابة الداخلية فقط) تثبيت ما يلي:

    • Xcode 9.4.1 أو أعلى
    • CocoaPods 1.10.0 أو أعلى
  • تأكد من أن مشروع الوحدة الخاص بك يلبي هذه المتطلبات:

    • لدائرة الرقابة الداخلية - يستهدف دائرة الرقابة الداخلية 10 أو أعلى
    • لالروبوت - مستوى الأهداف API 16 (جيلي فول) أو أعلى

  • قم بإعداد جهاز مادي أو استخدام محاكي لتشغيل تطبيقك.

    • لدائرة الرقابة الداخلية - إعداد جهاز دائرة الرقابة الداخلية البدني أو استخدام جهاز محاكاة دائرة الرقابة الداخلية.

    • لالروبوت - المحاكيات يجب استخدام صورة المحاكي مع جوجل اللعب.

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

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

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

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

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

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

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

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

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

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

    • لدائرة الرقابة الداخلية - أدخل مشروع الوحدة الخاص بك ID دائرة الرقابة الداخلية في ID حزمة دائرة الرقابة الداخلية المجال.

    • لالروبوت - أدخل مشروع الوحدة الخاصة بك الروبوت ID في اسم الحزمة الروبوت المجال.
      اسم حيث حزمة ومعرف التطبيق وغالبا ما تستخدم بالتبادل.

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

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

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

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

    • لدائرة الرقابة الداخلية - انقر فوق تحميل GoogleService-Info.plist.

    • لالروبوت - انقر على تنزيل Google-services.json.

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

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

الخطوة 4: إضافة Firebase الوحدة تطوير البرامج

  1. في وحدة تحكم Firebase، انقر فوق تحميل Firebase الوحدة SDK، ثم بفك في SDK مريحة في مكان ما.

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

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

  2. في مشروعك مفتوحة الوحدة، انتقل إلى الأصول> استيراد حزمة> حزمة مخصص.

  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: تاكيد جوجل متطلبات الخدمات اللعب نسخة

وFirebase الوحدة SDK لالروبوت يتطلب خدمات 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 وعلى الأنظمة الأساسية لسطح المكتب أولاً ، ثم نشرها واختبارها على الأجهزة المحمولة لاحقًا في مرحلة التطوير. ولدعم هذا العمل، ونحن نقدم مجموعة فرعية من Firebase الوحدة تطوير البرامج التي يمكن أن تعمل على ويندوز، ماك، لينكس، ومن داخل محرر الوحدة.

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

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

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

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

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

    2. بدلا من ذلك، توفير اسم فريد إلى FirebaseApp.Create() المكالمة.

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

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

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

وFirebase الوحدة SDK تدعم المنتجات Firebase التالية على دائرة الرقابة الداخلية والروبوت:

منتج 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 الوحدة SDK سطح المكتب دعم سير العمل لمجموعة فرعية من المنتجات، مما أجزاء معينة من Firebase لاستخدامها في محرر الوحدة وفي سطح المكتب مستقل يبني على ويندوز، ماك، ولينوكس.

منتج Firebase (سطح المكتب) حزمة الوحدة
المصادقة FirebaseAuth.unitypackage
وظائف السحابة FirebaseFunctions.unitypackage
سحابة Firestore FirebaseFirestore.unitypackage
سحابة التخزين FirebaseStorage.unitypackage
قاعدة بيانات الوقت الفعلي FirebaseDatabase.unitypackage
التكوين عن بعد FirebaseRemoteConfig.unitypackage

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

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