Menggunakan metadata file dengan Cloud Storage untuk Unity

Setelah mengupload file ke referensi Cloud Storage, Anda juga dapat mengambil dan mengupdate metadata file, misalnya untuk mengupdate jenis konten. File juga dapat menyimpan key-value pair kustom dengan metadata file tambahan.

Mengambil Metadata File

Metadata file berisi properti umum, seperti Name, SizeBytes, dan ContentType (sering disebut jenis MIME), serta beberapa properti yang jarang digunakan, seperti ContentDisposition dan CreationTimeMillis. Metadata ini dapat diambil dari referensi Cloud Storage menggunakan metode 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
    }
});

Memperbarui Metadata File

Anda dapat memperbarui metadata file kapan saja setelah selesai mengupload file menggunakan metode UpdateMetadataAsync yang mengambil objek MetadataChange. Lihat daftar lengkap untuk mengetahui informasi lebih lanjut mengenai properti yang dapat diperbarui. Hanya properti yang ditetapkan dalam metadata yang akan diperbarui, sedangkan yang lainnya tidak berubah.

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

Anda dapat menghapus properti metadata yang dapat ditulis dengan meneruskan string kosong:

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

Menangani Error

Ada sejumlah alasan terjadinya error saat mengambil atau memperbarui metadata, termasuk tidak adanya file atau pengguna tidak memiliki izin untuk mengakses file yang diinginkan. Informasi lebih lanjut mengenai error bisa dilihat di bagian Menangani Error pada dokumentasi.

Metadata Kustom

Anda dapat menentukan metadata kustom sebagai Dictionary<string, string>.

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

// UpdateMetadataAsync

Anda dapat menyimpan data khusus aplikasi untuk setiap file dalam metadata kustom, tetapi kami sangat menyarankan penggunaan database (seperti Firebase Realtime Database) untuk menyimpan dan menyinkronkan jenis data ini.

Properti Metadata File

Daftar lengkap properti metadata pada file tercantum di bawah ini:

Properti	Jenis	Dapat Diubah di MetadataChange
Bucket	string	TIDAK
Generation	string	BUKAN
MetadataGeneration	string	BUKAN
Path	string	BUKAN
Name	string	BUKAN
SizeBytes	long	BUKAN
CreationTimeMillis	long	BUKAN
UpdatedTimeMillis	long	TIDAK
CacheControl	string	YA
ContentDisposition	string	YA
ContentEncoding	string	YA
ContentLanguage	string	YA
ContentType	string	YA
DownloadUrl	Uri	TIDAK
DownloadUrls	IList<Uri>	TIDAK
CustomMetadataKeys	IEnumerable<string>	YA

Langkah Berikutnya

Mengupload, mendownload, dan memperbarui file itu penting, tetapi kita juga harus bisa menghapusnya. Mari pelajari cara menghapus file dari Cloud Storage.