Unity için Cloud Storage ile dosya meta verilerini kullanma

Cloud Storage referansına bir dosya yükledikten sonra, dosya meta verilerini de alıp güncelleyebilirsiniz (ör. içerik türünü güncellemek için). Dosyalar, ek dosya meta verileriyle özel anahtar/değer çiftleri de depolayabilir.

Dosya meta verilerini alma

Dosya meta verileri, ContentDisposition ve CreationTimeMillis gibi daha az yaygın olan özelliklerin yanı sıra Name, SizeBytes ve ContentType (genellikle MIME türü olarak adlandırılır) gibi yaygın özellikleri içerir. Bu meta veriler, GetMetadataAsync yöntemi kullanılarak bir Cloud Storage 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üncelleme

Dosya yükleme işlemi tamamlandıktan sonra dilediğiniz zaman MetadataChange nesnesi alan UpdateMetadataAsync yöntemini kullanarak dosya meta verilerini güncelleyebilirsiniz. Hangi mülklerin güncellenebileceği hakkında daha fazla bilgi için tam listeye bakın. Yalnızca meta verilerde belirtilen özellikler güncellenir, diğer tüm özellikler değiştirilmeden bırakılır.

// 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ş dize göndererek 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ı işleme

Meta verileri alma veya güncelleme sırasında hataların oluşmasının çeşitli nedenleri vardır. Örneğin, dosyanın mevcut olmaması veya kullanıcının istenen dosyaya erişme izninin olmaması bu nedenler arasındadır. Hatalarla ilgili daha fazla bilgiyi dokümanların Hataları ele alma bölümünde bulabilirsiniz.

Özel Meta Veriler

Özel meta verileri Dictionary<string, string> olarak belirtebilirsiniz.

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

// UpdateMetadataAsync

Her dosyanın uygulamaya özgü verilerini özel meta verilerde saklayabilirsiniz ancak bu tür verileri depolamak ve senkronize etmek için bir veritabanı (ör. Firebase Realtime Database) kullanmanızı önemle tavsiye ederiz.

Dosya Meta Veri Özellikleri

Bir dosyadaki meta veri özelliklerinin tam listesini aşağıda bulabilirsiniz:

Özellik	Tür	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

Dosya yükleme, indirme ve güncelleme kadar dosyaları kaldırabilmek de önemlidir. Cloud Storage'den dosyaları nasıl sileceğinizi öğrenelim.