Join us in person and online for Firebase Summit on October 18, 2022. Learn how Firebase can help you accelerate app development, release your app with confidence, and scale with ease. Register now

הוסף את Firebase לפרויקט Unity שלך

קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

הפעל את משחקי Unity שלך עם ערכות Firebase Unity שלנו.

כדי להראות כמה קל לחבר את Firebase לפרויקט Unity שלך, הכנו משחק לדוגמה, MechaHamster, שתוכל להוריד מ- GitHub , מחנות האפליקציות ומחנות Google Play .

MechaHamster (GitHub)

MechaHamster (App Store)

MechaHamster (חנות Play)


קבל מידע נוסף על הפעלת המשחקים שלך עם Firebase בדף משחקי Firebase שלנו.

כבר הוספת את Firebase לפרויקט Unity שלך? ודא שאתה משתמש בגרסה העדכנית ביותר של Firebase Unity SDK .

דרישות מוקדמות

  • התקן את Unity 2018.4 ואילך. גרסאות קודמות עשויות להיות גם תואמות אך לא ייתמכו באופן פעיל. התמיכה ב-Unity 2018.4 נחשבת שהוצאה משימוש, ולא תהיה עוד תמיכה פעילה לאחר המהדורה הגדולה הבאה.

  • (iOS בלבד) התקן את הדברים הבאים:

    • Xcode 13.3.1 ומעלה
    • CocoaPods 1.10.0 ומעלה
  • ודא שפרויקט Unity שלך עומד בדרישות הבאות:

    • עבור iOS - מכוון ל-iOS 10 ומעלה
    • עבור אנדרואיד - מתמקד ברמת API 19 (KitKat) ומעלה

  • הגדר מכשיר פיזי או השתמש באמולטור כדי להפעיל את האפליקציה שלך.

    • עבור iOS - הגדר מכשיר iOS פיזי או השתמש בסימולטור iOS.

    • עבור אנדרואיד - אמולטורים חייבים להשתמש בתמונת אמולטור עם 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.

    • עבור אנדרואיד - הזן את מזהה האנדרואיד של פרויקט Unity שלך בשדה שם החבילה של Android.
      המונחים שם חבילה ומזהה יישום משמשים לעתים קרובות לסירוגין.

  5. (אופציונלי) הזן את הכינוי/כינויים הספציפיים לפלטפורמה של פרויקט Unity שלך.
    הכינויים האלה הם מזהי נוחות פנימיים והם גלויים רק לך במסוף Firebase.

  6. לחץ על הרשמה אפליקציה .

שלב 3 : הוסף קובצי תצורה של Firebase

  1. השג את קובצי התצורה של Firebase הספציפיים לפלטפורמה בזרימת העבודה של הגדרת מסוף Firebase.

    • עבור iOS - לחץ על הורד GoogleService-Info.plist .

    • עבור אנדרואיד - לחץ על הורד google-services.json .

  2. פתח את חלון הפרויקט של פרויקט Unity שלך, ולאחר מכן העבר את קבצי התצורה שלך לתיקיית Assets .

  3. בחזרה במסוף Firebase, בזרימת העבודה של ההגדרה, לחץ על הבא .

שלב 4 : הוסף ערכות SDK של Firebase Unity

  1. במסוף Firebase, לחץ על הורד Firebase Unity SDK ולאחר מכן פתח את ה-SDK במקום נוח.

    • אתה יכול להוריד שוב את Firebase Unity SDK בכל עת.

    • ה-SDK של Firebase Unity אינו ספציפי לפלטפורמה.

  2. בפרויקט Unity הפתוח שלך, נווט אל נכסים > ייבוא ​​חבילה > חבילה מותאמת אישית .

  3. מה-SDK הפתוח, בחר את מוצרי Firebase הנתמכים שבהם ברצונך להשתמש באפליקציה שלך.

    אנליטיקס מופעל

    • הוסף את חבילת Firebase עבור Google Analytics: FirebaseAnalytics.unitypackage
    • הוסף את החבילות עבור כל מוצר אחר של Firebase שאתה רוצה להשתמש באפליקציה שלך. לדוגמה, כדי להשתמש ב-Firebase Authentication וב-Firebase Realtime Database:
      FirebaseAuth.unitypackage ו- FirebaseDatabase.unitypackage

    Analytics לא מופעל

    הוסף את החבילות עבור מוצרי Firebase שאתה רוצה להשתמש באפליקציה שלך. לדוגמה, כדי להשתמש ב-Firebase Authentication וב-Firebase Realtime Database:
    FirebaseAuth.unitypackage ו- FirebaseDatabase.unitypackage

  4. בחלון ייבוא ​​חבילת אחדות , לחץ על ייבוא ​​.

  5. בחזרה במסוף Firebase, בזרימת העבודה של ההגדרה, לחץ על הבא .

שלב 5 : אשר את דרישות גרסת שירותי Google Play

ה-SDK של Firebase Unity לאנדרואיד דורש שירותי 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.
  }
});

אתה מוכן! פרויקט Unity שלך רשום ומוגדר לשימוש ב-Firebase.

אם אתה מתקשה להתקין, בקר בדף פתרון הבעיות והשאלות הנפוצות של Unity .

הגדר זרימת עבודה בשולחן העבודה ( בטא )

כאשר אתה יוצר משחק, לעתים קרובות הרבה יותר קל לבדוק את המשחק שלך בעורך Unity ובפלטפורמות שולחניות תחילה, ואז לפרוס ולבדוק במכשירים ניידים מאוחר יותר בפיתוח. כדי לתמוך בזרימת עבודה זו, אנו מספקים תת-קבוצה של Firebase Unity SDKs שיכולים לפעול ב-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 Unity SDK תומך במוצרי Firebase הבאים ב- iOS וב- Android :

מוצר Firebase חבילת Unity
AdMob מופץ בנפרד בתוסף AdMob Unity
ניתוח FirebaseAnalytics.unitypackage
אימות FirebaseAuth.unitypackage
Cloud 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 (שולחן עבודה) חבילת Unity
אימות FirebaseAuth.unitypackage
פונקציות ענן FirebaseFunctions.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
אחסון בענן FirebaseStorage.unitypackage
מסד נתונים בזמן אמת FirebaseDatabase.unitypackage
תצורה מרחוק FirebaseRemoteConfig.unitypackage

Firebase מספקת את ספריות שולחן העבודה הנותרות כהטמעות סטאב (לא פונקציונליות) לצורך נוחות בעת בנייה עבור Windows, macOS ו-Linux. לכן, אין צורך להדר קוד באופן מותנה כדי למקד לשולחן העבודה.

הצעדים הבאים