通过 Unity 版 Cloud Storage 使用文件元数据

在将文件上传到 Cloud Storage 引用之后，您还可以获取和更新文件元数据，例如更新内容类型。文件还可以使用额外的文件元数据来存储自定义键值对。

注意：默认情况下，需要经过 Firebase Authentication 身份验证才能对 Cloud Storage for Firebase 存储桶中的数据或文件执行操作。您可以更改 Cloud Storage 的 Firebase Security Rules，以允许在特定情况下进行未经身份验证的访问。不过，在大多数情况下，我们强烈建议限制访问权限并设置稳健的安全规则（尤其是对于生产应用）。请注意，如果您使用 Google App Engine 且有默认的 Cloud Storage 存储桶，其名称格式为 *.appspot.com，则可能需要考虑安全规则对 App Engine 文件的访问有何影响。

获取文件元数据

文件元数据包含 Name、SizeBytes 和 ContentType（通常称为 MIME 类型）等常用属性；以及 ContentDisposition 和 CreationTimeMillis 等不太常用的属性。您可以使用 GetMetadataAsync 方法从 Cloud Storage 引用中检索此元数据。

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

更新文件元数据

文件上传完成后，您可以使用接受 MetadataChange 对象的 UpdateMetadataAsync 方法随时更新文件元数据。请参考完整清单，详细了解什么属性可以更新。只有元数据中指定的属性才会更新，所有其他属性不会被修改。

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

您可以通过传递空字符串来删除可写元数据属性：

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

处理错误

获取或更新元数据时，有很多原因会引发错误，包括文件不存在或者用户无权访问相关的文件。如需了解有关错误的详细信息，请参阅文档的处理错误部分。

自定义元数据

您可以将自定义元数据指定为 Dictionary<string, string>。

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

// UpdateMetadataAsync

您可以在自定义元数据中为每个文件存储特定于应用的数据，不过我们强烈建议您使用数据库（例如 Firebase Realtime Database）来存储和同步这种类型的数据。

文件元数据属性

文件元数据属性的完整列表如下：

属性	类型	是否可在 MetadataChange 中修改
Bucket	string	否
Generation	string	否
MetadataGeneration	string	否
Path	string	否
Name	string	否
SizeBytes	long	否
CreationTimeMillis	long	否
UpdatedTimeMillis	long	否
CacheControl	string	是
ContentDisposition	string	是
ContentEncoding	string	是
ContentLanguage	string	是
ContentType	string	是
DownloadUrl	Uri	否
DownloadUrls	IList<Uri>	否
CustomMetadataKeys	IEnumerable<string>	是

后续步骤

上传、下载和更新文件很重要，但能够将其移除也同样重要。请了解如何从 Cloud Storage 中删除文件。