Cette page a été traduite par l'API Cloud Translation.

Utiliser les métadonnées de fichier avec Cloud Storage pour Unity

Après avoir importé un fichier dans la référence Cloud Storage, vous pouvez également obtenir et mettre à jour les métadonnées du fichier, par exemple pour mettre à jour le type de contenu. Les fichiers peuvent également stocker des paires clé/valeur personnalisées avec des métadonnées de fichier supplémentaires.

Obtenir les métadonnées du fichier

Les métadonnées de fichier contiennent des propriétés communes telles que Name , SizeBytes et ContentType (souvent appelées type MIME) en plus de propriétés moins courantes telles que ContentDisposition et CreationTimeMillis . Ces métadonnées peuvent être récupérées à partir d'une référence Cloud Storage à l'aide de la méthode 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
    }
});

Mettre à jour les métadonnées du fichier

Vous pouvez mettre à jour les métadonnées du fichier à tout moment une fois le téléchargement du fichier terminé en utilisant la méthode UpdateMetadataAsync qui prend un objet MetadataChange . Reportez-vous à la liste complète pour plus d'informations sur les propriétés pouvant être mises à jour. Seules les propriétés spécifiées dans les métadonnées sont mises à jour, toutes les autres restent inchangées.

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

Vous pouvez supprimer des propriétés de métadonnées inscriptibles en transmettant la chaîne vide :

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

Gérer les erreurs

Il existe un certain nombre de raisons pour lesquelles des erreurs peuvent se produire lors de l'obtention ou de la mise à jour des métadonnées, notamment le fait que le fichier n'existe pas ou que l'utilisateur n'a pas l'autorisation d'accéder au fichier souhaité. Vous trouverez plus d'informations sur les erreurs dans la section Gérer les erreurs de la documentation.

Métadonnées personnalisées

Vous pouvez spécifier des métadonnées personnalisées en tant que Dictionary<string, string> .

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

// UpdateMetadataAsync

Vous pouvez stocker des données spécifiques à l'application pour chaque fichier dans des métadonnées personnalisées, mais nous vous recommandons vivement d'utiliser une base de données (telle que Firebase Realtime Database ) pour stocker et synchroniser ce type de données.

Propriétés des métadonnées de fichier

Une liste complète des propriétés des métadonnées d'un fichier est disponible ci-dessous :

Propriété	Taper	Modifiable dans MetadataChange
`Bucket`	`string`	NON
`Generation`	`string`	NON
`MetadataGeneration`	`string`	NON
`Path`	`string`	NON
`Name`	`string`	NON
`SizeBytes`	`long`	NON
`CreationTimeMillis`	`long`	NON
`UpdatedTimeMillis`	`long`	NON
`CacheControl`	`string`	OUI
`ContentDisposition`	`string`	OUI
`ContentEncoding`	`string`	OUI
`ContentLanguage`	`string`	OUI
`ContentType`	`string`	OUI
`DownloadUrl`	`Uri`	NON
`DownloadUrls`	`IList<Uri>`	NON
`CustomMetadataKeys`	`IEnumerable<string>`	OUI

Prochaines étapes

Le téléchargement, le téléchargement et la mise à jour de fichiers sont importants, mais il est tout aussi important de pouvoir les supprimer. Apprenons à supprimer des fichiers de Cloud Storage.