הוסף את 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.10.0 ומעלה

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

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

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

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

    האם אתה רוצה להשתמש ב-Cloud Messaging?

    עבור העברת הודעות בענן ב-iOS או tvOS, להלן התנאים המוקדמים:

    • הגדר מכשיר פיזי .
    • השג מפתח אימות של Apple Push Notification עבור חשבון ה-Apple Developer שלך.
    • אפשר הודעות דחיפה ב-XCode תחת אפליקציה > יכולות .

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

   התאמה אישית של תצורה מרחוק בדיקת A/B של Firebase

   בחר חשבון Google Analytics קיים או כדי ליצור חשבון חדש.

   אם אתה יוצר חשבון חדש, בחר את מיקום הדיווח שלך ב-Analytics ולאחר מכן קבל את הגדרות שיתוף הנתונים ואת התנאים של Google Analytics עבור הפרויקט שלך.

5. לחץ על צור פרויקט (או הוסף Firebase , אם אתה משתמש בפרויקט קיים של Google Cloud).

Firebase מספקת משאבים אוטומטית עבור פרויקט Firebase שלך. בסיום התהליך, תועבר לדף הסקירה הכללית של פרויקט Firebase שלך ​​במסוף Firebase.

שלב 2 : רשום את האפליקציה שלך ב-Firebase

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

1. עבור אל מסוף Firebase .

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

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

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

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

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

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

   היכן אתה מוצא את תעודת הזהות של פרויקט Unity שלך?

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

   • עבור iOS - נווט אל הגדרות בנייה > iOS .

   • עבור אנדרואיד - נווט אל Android > הגדרות נגן > הגדרות אחרות .

   המזהה של פרויקט ה-Unity שלך הוא ערך מזהה החבילה (מזהה לדוגמא: com.yourcompany.yourproject ).

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

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

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

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

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

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

   מה אתה צריך לדעת על קובץ התצורה הזה?

   • קובץ התצורה של Firebase מכיל מזהים ייחודיים, אך לא סודיים עבור הפרויקט שלך. למידע נוסף על קובץ תצורה זה, בקר ב- Understand Firebase Projects .

   • תוכל להוריד שוב את קובץ התצורה של Firebase בכל עת.

   • ודא ששם קובץ התצורה אינו מצורף עם תווים נוספים, כמו (2) .

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 זמינות לנייד

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. לכן, אין צורך להדר קוד באופן מותנה כדי למקד לשולחן העבודה.

הצעדים הבאים

• גלה אפליקציות Firebase לדוגמה .

• היכונו להפעלת האפליקציה שלכם:

  • הגדר התראות תקציב עבור הפרויקט שלך ב-Google Cloud Console.
  • עקוב אחר לוח המחוונים של השימוש והחיובים במסוף Firebase כדי לקבל תמונה כוללת של השימוש בפרויקט שלך בשירותי Firebase מרובים.
  • עיין ברשימת המשימות להפעלת Firebase .

• נתקלת בבעיות עם Firebase ופרויקט Unity שלך? בקר בדף פתרון הבעיות והשאלות הנפוצות של Unity .