Unity için Cloud Storage ile dosya meta verilerini kullanma

Bulut depolama referansına bir dosya yükledikten sonra, örneğin içerik türünü güncellemek için dosya meta verilerini alıp güncelleyebilirsiniz. Dosyalar ayrıca ek dosya meta verileri ile özel anahtar/değer çiftlerini de depolayabilir.

Dosya Meta Verileri Alın

Dosya meta verileri, ContentDisposition ve CreationTimeMillis gibi daha az yaygın olanlara ek olarak Name , SizeBytes ve ContentType (genellikle mime türü olarak adlandırılır) gibi ortak özellikler içerir. Bu meta veriler, GetMetadataAsync yöntemi kullanılarak bir bulut depolama referansından alınabilir.

// 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
    }
});

Dosya meta verilerini güncelleyin

Dosya Yüklemesi tamamlandıktan sonra herhangi bir zamanda, MetadataChange nesnesini alan UpdateMetadataAsync yöntemini kullanarak dosya meta verilerini güncelleyebilirsiniz. Hangi özelliklerin güncellenebileceği hakkında daha fazla bilgi için tam listeye bakın. Yalnızca meta verilerde belirtilen özellikler güncellenir, diğerleri değiştirilmez.

// 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;
    }
});

Boş dizeyi geçerek yazılabilir meta veri özelliklerini silebilirsiniz:

// 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
    }
});

Hataları İşle

Meta verileri almanın veya güncellemede, mevcut olmayan dosya veya kullanıcının istenen dosyaya erişme izni olmaması için hataların oluşmasının veya güncellenmesinin birkaç nedeni vardır. Hatalarla ilgili daha fazla bilgiyi dokümanların Hataları İşleme bölümünde bulabilirsiniz.

Özel Meta Veriler

Özel meta verileri bir Dictionary<string, string> .

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

// UpdateMetadataAsync

Her dosya için uygulamaya özgü verileri özel meta verilerde depolayabilirsiniz, ancak bu tür verileri depolamak ve senkronize etmek için bir veritabanı ( Firebase RealTime veritabanı gibi) kullanmanızı şiddetle tavsiye ederiz.

Dosya Meta Veri Özellikleri

Bir dosyadaki meta veri özelliklerinin tam listesi aşağıda mevcuttur:

Mülk Tip MetaDatachange'de Değiştirilebilir
Bucket string HAYIR
Generation string HAYIR
MetadataGeneration string HAYIR
Path string HAYIR
Name string HAYIR
SizeBytes long HAYIR
CreationTimeMillis long HAYIR
UpdatedTimeMillis long HAYIR
CacheControl string EVET
ContentDisposition string EVET
ContentEncoding string EVET
ContentLanguage string EVET
ContentType string EVET
DownloadUrl Uri HAYIR
DownloadUrls IList<Uri> HAYIR
CustomMetadataKeys IEnumerable<string> EVET

Sonraki adımlar

Dosyaları yüklemek, indirmek ve güncellemek önemlidir, ancak bunları kaldırabilmektedir. Dosyaları bulut depolama alanından nasıl sileceğinizi öğrenelim.