Unity için Cloud Storage ile dosya meta verilerini kullanma

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

Dosya meta verilerini alma

Dosya meta verileri, Name, SizeBytes ve ContentType (genellikle MIME türü olarak adlandırılır) gibi yaygın özelliklerin yanı sıra ContentDisposition ve CreationTimeMillis gibi daha az yaygın olan bazı özellikleri içerir. Bu meta veriler, GetMetadataAsync yöntemi kullanılarak 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, UpdateMetadataAsync nesnesi alan MetadataChange yöntemini kullanarak dosya meta verilerini istediğiniz zaman 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ğ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ş dizeyi ileterek 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ı İşleme

Dosyanın mevcut olmaması veya kullanıcının istenen dosyaya erişim izninin olmaması gibi nedenlerle, meta verileri alma veya güncelleme sırasında hatalar oluşabilir. Hatalar hakkında daha fazla bilgiyi dokümanların Hataları İşleme 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 dosya için uygulamaya özel verileri özel meta verilerde depolayabilirsiniz. Ancak bu tür verileri depolamak ve senkronize etmek için bir veritabanı (ör. Firebase Realtime Database) kullanmanızı önemle tavsiye ederiz.

Dosya meta verileri özellikleri

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

Özellik	Tür	MetadataChange içinde 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ırabilmek de önemlidir. Cloud Storage'dan dosyaları nasıl sileceğinizi öğrenelim.