Save the date - Google I/O returns May 18-20. Register to get the most out of the digital experience: Build your schedule, reserve space, participate in Q&As, earn Google Developer profile badges, and more. Register now
דף זה תורגם על ידי Cloud Translation API.
Switch to English

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

הפעל את משחקי ה- Unity שלך באמצעות ה- SDK של Firebase Unity.

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

MechaHamster (GitHub)

MechaHamster (App Store)

MechaHamster (חנות Play)


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

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

תנאים מוקדמים

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

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

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

    • עבור iOS - מכוון ל- iOS 10 ואילך
    • לאנדרואיד - מכוון לממשק API ברמה 16 (Jelly Bean) ואילך
  • הגדר מכשיר פיזי או השתמש באמולטור להפעלת האפליקציה שלך.

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

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

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

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

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

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

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

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

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

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

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

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

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

    • עבור Android - הזן את מזהה ה- Android של פרויקט 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

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

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

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

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

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

    ניתוח מופעל

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

    ניתוח לא מופעל

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

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

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

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

Firebase Unity SDK עבור Android דורש שירותי 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 .

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

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

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

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

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

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

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

    2. במקום זאת, ספק שם ייחודי לשיחת FirebaseApp.Create() .

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

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

למידע נוסף על ספריות Unity Firebase בתיעוד הפניה .

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

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

מוצרי Firebase נתמכים (שולחן עבודה)

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

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

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

הצעדים הבאים