השתמש במטא נתונים של קבצים עם Cloud Storage for Unity

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

קבל מטא נתונים של קבצים

מטא נתונים של קבצים מכילים מאפיינים נפוצים כגון Name , SizeBytes ו- ContentType (המכונה לעתים קרובות סוג MIME) בנוסף לכמה פחות נפוצים כמו ContentDisposition ו- CreationTimeMillis . ניתן לאחזר מטא נתונים אלה מהפניה של Cloud Storage באמצעות שיטת GetMetadataAsync .

// Create reference to the file whose metadata we want to retrieve
StorageReference forestRef =
    storageRef.Child("images/forest.jpg");

// Get metadata properties
forestRef.GetMetadataAsync().ContinueWithOnMainThread(task => {
    if (!task.IsFaulted && !task.IsCanceled) {
        StorageMetadata meta = task.Result;
        // do stuff with meta
    }
});

עדכן מטא נתונים של קובץ

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

// Create reference to the file whose metadata we want to change
StorageReference forestRef = storageRef.Child("images/forest.jpg");

// Create file metadata to update
var newMetadata = new MetadataChange();
newMetadata.CacheControl = "public,max-age=300";
newMetadata.ContentType = "image/jpeg";

// Update metadata properties
forestRef.UpdateMetadataAsync(newMetadata).ContinueWithOnMainThread(task => {
    if (!task.IsFaulted && !task.IsCanceled) {
        // access the updated meta data
        StorageMetadata meta = task.Result;
    }
});

אתה יכול למחוק מאפייני מטא נתונים הניתנים לכתיבה על ידי העברת המחרוזת הריקה:

// Create file metadata to update
var newMetadata = new MetadataChange();
newMetadata.ContentType = "";

// Update metadata properties
forestRef.UpdateMetadataAsync(newMetadata).ContinueWithOnMainThread(task => {
    if (!task.IsFaulted && !task.IsCanceled) {
        StorageMetadata meta = task.Result;
        // meta.ContentType should be an empty string now
    }
});

טיפול בשגיאות

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

מטא נתונים מותאמים אישית

אתה יכול לציין מטא נתונים מותאמים אישית Dictionary<string, string> .

var newMetadata = new MetadataChange {
    CustomMetadata = new Dictionary<string, string> {
        {"location", "Yosemite, CA, USA"},
        {"activity", "Hiking"}
    }
};

// UpdateMetadataAsync

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

מאפייני מטא נתונים של קובץ

רשימה מלאה של מאפייני מטא נתונים בקובץ זמינה להלן:

תכונה	סוּג	ניתן לשינוי ב- MetadataChange
Bucket	string	לא
Generation	string	לא
MetadataGeneration	string	לא
Path	string	לא
Name	string	לא
SizeBytes	long	לא
CreationTimeMillis	long	לא
UpdatedTimeMillis	long	לא
CacheControl	string	כן
ContentDisposition	string	כן
ContentEncoding	string	כן
ContentLanguage	string	כן
ContentType	string	כן
DownloadUrl	Uri	לא
DownloadUrls	IList<Uri>	לא
CustomMetadataKeys	IEnumerable<string>	כן

הצעדים הבאים

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