Usa metadatos de archivos con Cloud Storage para Unity

Después de subir un archivo a la referencia de Cloud Storage, también puedes obtener y actualizar los metadatos del archivo (por ejemplo, para actualizar el tipo de contenido). Los archivos también pueden almacenar pares clave-valor personalizados con metadatos de archivo adicionales.

Obtén metadatos de archivos

Los metadatos de archivos contienen propiedades comunes como Name, SizeBytes y ContentType (a menudo, denominado tipo de MIME), además de otras menos comunes como ContentDisposition y CreationTimeMillis. Estos metadatos se pueden recuperar de una referencia de Cloud Storage con el método 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
    }
});

Actualiza metadatos de archivos

Para actualizar los metadatos del archivo en cualquier momento después de terminar de subirlo, puedes usar el método UpdateMetadataAsync, que lleva un objeto MetadataChange. Consulta la lista completa para obtener más información sobre qué propiedades se pueden actualizar. Solo se actualizan las propiedades especificadas en los metadatos y todas las demás quedan sin cambios.

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

Para borrar propiedades de metadatos que admiten escritura, puedes pasar la string vacía:

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

Soluciona errores

Existen diferentes motivos por los que pueden producirse errores cuando se quieren obtener o actualizar metadatos. Por ejemplo, es posible que el archivo no exista o que el usuario no tenga permiso para acceder al archivo deseado. Para obtener más información sobre los errores, consulta la sección de los documentos denominada Soluciona errores.

Metadatos personalizados

Puedes especificar metadatos personalizados como un Dictionary<string, string>.

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

// UpdateMetadataAsync

Puedes almacenar datos específicos de tu app para cada archivo en forma de metadatos personalizados, pero te recomendamos que uses una base de datos (como Firebase Realtime Database) para almacenar y sincronizar este tipo de datos.

Propiedades de los metadatos de archivos

A continuación, puedes ver una lista completa de las propiedades de metadatos de un archivo:

Propiedad	Tipo	Modificable en MetadataChange
Bucket	string	NO
Generation	string	NO
MetadataGeneration	string	NO
Path	string	NO
Name	string	NO
SizeBytes	long	NO
CreationTimeMillis	long	NO
UpdatedTimeMillis	long	NO
CacheControl	string	SÍ
ContentDisposition	string	SÍ
ContentEncoding	string	SÍ
ContentLanguage	string	SÍ
ContentType	string	SÍ
DownloadUrl	Uri	NO
DownloadUrls	IList<Uri>	NO
CustomMetadataKeys	IEnumerable<string>	SÍ

Pasos siguientes

Es importante subir, descargar y actualizar archivos, pero también lo es poder quitarlos. Veamos cómo borrar archivos de Cloud Storage.