Catch up on everthing we announced at this year's Firebase Summit. Learn more

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

טעינת חשמל שלך האחדות משחקים עם ערכות SDK אחדות Firebase שלנו.

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

MechaHamster (GitHub)

MechaHamster (App Store)

MechaHamster (חנות Play)


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

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

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

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

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

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

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

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

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

    • עבור אנדרואיד - אמולטורים חייב להשתמש בתמונת אמולטור השימוש ב- Google Play.

אם עדיין אין לך פרויקט האחדות ואת רק רוצה לנסות את מוצר Firebase, אתה יכול להוריד אחד שלנו דגימות QuickStart .

שלב 1: יצירת פרויקט Firebase

לפני שתוכל להוסיף את Firebase לפרויקט Unity שלך, עליך ליצור פרויקט Firebase כדי להתחבר לפרויקט Unity שלך. בקר להבין Firebase פרוייקטים כדי ללמוד עוד על פרויקטים Firebase.

שלב 2: רשמו את האפליקציה שלכם עם Firebase

אתה יכול לרשום אפליקציה או משחק אחד או יותר כדי להתחבר לפרויקט Firebase שלך.

  1. עבור אל קונסולת Firebase .

  2. במרכז דף סקירת הפרויקט, לחץ על סמל האחדות ( ) כדי להפעיל את זרימת עבודת ההתקנה.

    אם כבר הוסיף יישום לפרויקט Firebase שלך, לחץ על הוסף אפליקציה להצגת אפשרויות הפלטפורמה.

  3. בחר איזה יעד בנייה של פרויקט Unity שלך תרצה לרשום, או שאתה יכול אפילו לבחור לרשום את שני היעדים עכשיו בו זמנית.

  4. הזן את המזהים הספציפיים לפלטפורמה של פרויקט Unity שלך.

    • עבור iOS - זן מזהה iOS של פרויקט האחדות שלכם זיהוי חבילת iOS השדה.

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

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

  6. לחץ אפליקצית רישום.

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

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

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

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

  2. פתח בחלון הפרויקט של פרויקט האחדות שלך, ולאחר מכן להעביר קובץ config שלך (הים) לתוך Assets התיקייה.

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

שלב 4: הוספת Firebase אחדות ערכות SDK

  1. במסוף Firebase, לחץ על הורדה Firebase האחדות SDK, אז unzip ב- SDK איפשהו נוח.

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

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

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

  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 עבור אנדרואיד דורש שירותים של 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 ובפלטפורמות שולחניות תחילה, ואז לפרוס ולבדוק במכשירים ניידים מאוחר יותר בפיתוח. כדי לתמוך זרימת עבודה זו, אנו מספקים משנה מערכות ה- SDK אחדות Firebase שיכול לרוץ על Windows, MacOS, לינוקס, ומתוך עורך האחדות.

  1. הגדרת פרויקט אחדות השולחני פלטפורמות ידי ביצוע אותן הפעולות שמפורטות עבור פלטפורמה ניידת (להתחיל עם לרשום את האפליקציה עם Firebase צעד לעיל).

  2. הפעל פרויקט האחדות שלכם ב- IDE אחדות או בחר לבנות פרויקט האחדות שלך עבור שולחן העבודה.

  3. (אופציונלי) הפעל פרויקט האחדות שלכם במצב עריכה.

    ניתן להפעיל את Firebase Unity SDK גם במצב העריכה של Unity, מה שמאפשר שימוש בו בתוספי עורך.

    1. בעת יצירת FirebaseApp ששמש את העורך, אל תשתמשו למשל ברירת המחדל.

    2. במקום, לתת שם ייחודי FirebaseApp.Create() שיחה.

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

מוצרי Firebase נתמכים

למידע נוסף על ספריות Firebase האחדות של תיעוד הפניה .

ה- SDK אחדות Firebase תומכת במוצרי 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 נתמכים (מחשב שולחני)

ה- SDK אחדות Firebase כוללת תמיכת זרימת שולחן עבודה עבור קבוצת משנה של מוצרים, המאפשר חלקים מסוימים של Firebase לשמש עורך האחדות ועל שולחן עבודה עצמאי בונה על Windows, MacOS ו- Linux.

מוצר Firebase (שולחן עבודה) חבילת Unity
אימות FirebaseAuth.unitypackage
פונקציות ענן FirebaseFunctions.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
אחסון בענן FirebaseStorage.unitypackage
מסד נתונים בזמן אמת FirebaseDatabase.unitypackage
תצורה מרחוק FirebaseRemoteConfig.unitypackage

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

הצעדים הבאים