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

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

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

MechaHamster (GitHub)

MechaHamster (App Store)

MechaHamster (חנות Play)


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

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

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

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

  • (בפלטפורמות אפל בלבד) התקן את הדברים הבאים:

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

    • עבור iOS - מכוון ל-iOS 11 ומעלה
    • עבור tvOS - מכוון ל-tvOS 12 ומעלה
    • עבור אנדרואיד - מתמקד ברמת API 19 (KitKat) ומעלה
  • הגדר מכשיר פיזי או השתמש באמולטור כדי להפעיל את האפליקציה שלך.

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

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

הוסף את הדברים הבאים 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 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 זמינות לנייד

Firebase Unity SDK תומך במוצרי Firebase הבאים ב- Apple וב- Android :

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

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

הצעדים הבאים