התחל בעבודה עם Cloud Storage for Unity

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

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

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

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

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

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

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

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

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

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

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

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

    • הגדרת המיקום זהו הפרויקט שלך בפלטפורמת הענן של Google מחדל מיקום משאב (GCP) . שים לב שמיקום זה ישמש עבור שירותים GCP בפרויקט שלך הדורשים הגדרת המיקום, במיוחד, שלך ענן Firestore מסד הנתונים שלך מנוע יישום האפליקציה (נדרש אם אתה משתמש ענן מתזמן).

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

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

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

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

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

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

גש FirebaseStorage בכיתה

Firebase.Storage.FirebaseStorage היא נקודת הכניסה עבור SDK אחדות Cloud Storage.

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

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

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

התקנה מתקדמת

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

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

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

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

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

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

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

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

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

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

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");

הצעדים הבאים