Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

התחל בעבודה עם אחסון ענן לאחדות

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

לפני שאתה מתחיל

לפני שתוכל להשתמש באחסון ענן , עליך:

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

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

    • אם אין לך פרויקט Unity, תוכל להוריד אפליקציה לדוגמה .

  • הוסף את SDK Firebase Unity (במיוחד FirebaseStorage.unitypackage ) לפרויקט Unity שלך.

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

צור דלי ברירת מחדל של ענן אחסון

  1. מחלונית הניווט של מסוף Firebase , בחר אחסון ולאחר מכן לחץ על התחל בעבודה .

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

  3. בחר מיקום עבור דלי ברירת המחדל של אחסון בענן.

    • הגדרת מיקום זו היא מיקום המשאב המשמש כברירת מחדל של Google Cloud Platform (GCP) של הפרויקט שלך. שים לב שמיקום זה ישמש עבור שירותי GCP בפרויקט שלך הדורשים הגדרת מיקום, במיוחד מסד הנתונים של Cloud Firestore ואפליקציית App Engine שלך (דבר הנדרש אם אתה משתמש ב- Cloud Scheduler).

    • אם אינך מצליח לבחור מיקום, לפרויקט שלך כבר יש מיקום ברירת מחדל למשאבי GCP. הוא הוגדר במהלך יצירת הפרויקט או בעת הגדרת שירות אחר הדורש הגדרת מיקום.

    אם אתה מתכנן את תוכנית Blaze, אתה יכול ליצור מספר דליים , כל אחד עם המיקום שלו.

  4. לחץ על סיום .

הגדר גישה ציבורית

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

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

גש FirebaseStorage

Firebase.Storage.FirebaseStorage הוא נקודת הכניסה ל- SDK אחסון בענן.

// Get a reference to the storage service, using the default Firebase App
FirebaseStorage storage = FirebaseStorage.DefaultInstance;

אתה מוכן להתחיל להשתמש בענן אחסון!

ראשית, בואו ללמוד כיצד ליצור הפניה לאחסון בענן .

התקנה מתקדמת

ישנם כמה מקרי שימוש שדורשים הגדרה נוספת:

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

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

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

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

השתמש במספר דליים של אחסון בענן

אם ברצונך להשתמש בדלי אחסון בענן שאינו ברירת המחדל שצוינה לעיל, או להשתמש בדליים אחסון בענן באפליקציה אחת, תוכל ליצור מופע של FirebaseStorage המפנה לדלי המותאם אישית שלך:

// Get a non-default Storage bucket
var storage = FirebaseStorage.GetInstance("gs://my-custom-bucket");

עבודה עם דליים מיובאים

בעת ייבוא ​​דלי אחסון ענן קיימים ל- Firebase, יהיה עליך להעניק ל- Firebase את האפשרות לגשת לקבצים אלה באמצעות הכלי gsutil , הכלול ב- SDK של Google Cloud :

gsutil -m acl ch -r -u service-<project number>@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://<your-cloud-storage-bucket>

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

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

השתמש באפליקציית Firebase מותאמת אישית

אם אתה בונה אפליקציה מסובכת יותר באמצעות FirebaseApp מותאם אישית, תוכל ליצור מופע של FirebaseStorage שאותחל מאותה יישום:

// Get the default bucket from a custom FirebaseApp
FirebaseStorage storage = FirebaseStorage.GetInstance(customApp);

// Get a non-default bucket from a custom FirebaseApp
FirebaseStorage storageCustom = FirebaseStorage.GetInstance(customApp, "gs://my-custom-bucket");

הצעדים הבאים