向 Cloud Storage 上传文件 (Unity)

Cloud Storage 可让开发者向 Firebase 提供和管理的 Google Cloud Storage 存储分区快速轻松地上传文件。

创建引用

要上传文件,请首先为要上传的文件创建一个 Cloud Storage 引用

您可以通过将子路径附加到存储根目录来创建引用,也可以从指向 Cloud Storage 中的对象的现有 gs://https:// 网址创建引用。

// Create a root reference
Firebase.Storage.StorageReference storage_ref = storage.Reference();

// Create a reference to "mountains.jpg"
Firebase.Storage.StorageReference mountains_ref = storage_ref.Child("mountains.jpg");

// Create a reference to 'images/mountains.jpg'
Firebase.Storage.StorageReference mountain_images_ref =
  storage_ref.Child("images/mountains.jpg");

// While the file names are the same, the references point to different files
mountains_ref.Name == mountain_images_ref.Name; // true
mountains_ref.Path == mountain_images_ref.Path; // false

您无法通过对您的 Google Cloud Storage 存储分区根目录的引用来上传数据。您的引用必须指向一个子网址。

上传文件

有了引用之后,您可以通过两种方式将文件上传到 Cloud Storage:

  1. 通过内存中的某个字节型数组上传
  2. 通过表示设备上文件的某个文件路径上传

通过内存中的数据上传

PutBytesAsync() 方法是将文件上传到 Cloud Storage 的最简单的方式。PutBytesAsync() 接受一个 byte[] 作为参数,并返回一个 System.Task<Firebase.Storage.StorageMetadata>,任务完成后,其中将包含该文件的相关信息。您可以选择使用一个 IProgress<UploadState>(通常为 StorageProgress<UploadState>)来监控您的上传状态。

// Data in memory
var custom_bytes = new byte[] { ... };

// Create a reference to the file you want to upload
Firebase.Storage.StorageReference rivers_ref = storage_ref.Child("images/rivers.jpg");

// Upload the file to the path "images/rivers.jpg"
rivers_ref.PutBytesAsync(custom_bytes)
  .ContinueWith ((Task<StorageMetadata> task) => {
    if (task.IsFaulted || task.IsCanceled) {
        Debug.Log(task.Exception.ToString());
        // Uh-oh, an error occurred!
    } else {
        // Metadata contains file metadata such as size, content-type, and download URL.
        Firebase.Storage.StorageMetadata metadata = task.Result;
        string download_url = metadata.DownloadUrl.ToString();
        Debug.Log("Finished uploading...");
        Debug.Log("download url = " + download_url);
    }
});

从本地文件上传

您可以使用 PutFileAsync() 方法上传设备上的本地文件,如相机中的照片和视频。PutFileAsync() 接受一个表示文件路径的 string 作为参数,并返回一个 System.Task<Firebase.Storage.StorageMetadata>,任务完成后,其中将包含该文件的相关信息。您可以选择使用一个 IProgress<UploadState>(通常为 StorageProgress<UploadState>)来监控您的上传状态。

// File located on disk
string local_file = ...

// Create a reference to the file you want to upload
Firebase.Storage.StorageReference rivers_ref = storage_ref.Child("images/rivers.jpg");

// Upload the file to the path "images/rivers.jpg"
rivers_ref.PutFileAsync(local_file)
  .ContinueWith ((Task<StorageMetadata> task) => {
    if (task.IsFaulted || task.IsCanceled) {
      Debug.Log(task.Exception.ToString());
      // Uh-oh, an error occurred!
    } else {
      // Metadata contains file metadata such as size, content-type, and download URL.
      Firebase.Storage.StorageMetadata metadata = task.Result;
      string download_url = metadata.DownloadUrl.ToString();
      Debug.Log("Finished uploading...");
      Debug.Log("download url = " + download_url);
    }
  });

如果您想主动监控上传进度,可以通过 PutFileAsync()PutBytesAsync() 方法使用 StorageProgress 类(或您自己用于实现 IProgress<UploadState> 的类)。如需了解详情,请参阅管理上传

添加文件元数据

在上传文件时,您还可以加入元数据。这些元数据包括常见的文件元数据属性,如 NameSizeContentType(通常称为 MIME 类型)。PutFileAsync() 方法会自动根据文件扩展名推断内容类型,但您可以通过在元数据中指定 ContentType 来覆盖自动检测到的类型。如果您未提供 ContentType,并且 Cloud Storage 无法从文件扩展名推断出默认值,Cloud Storage 将使用 application/octet-stream。如需了解文件元数据的详情,请参阅使用文件元数据部分。

// Create storage reference
Firebase.Storage.StorageReference mountains_ref = storage_ref.Child("images/mountains.jpg");

var custom_bytes = new byte[] { ... };

// Create file metadata including the content type
var new_metadata = new Firebase.Storage.MetadataChange();
new_metadata.ContentType = "image/jpeg";

// Upload data and metadata
mountains_ref.PutBytesAsync(custom_bytes, new_metadata, null,
                            CancellationToken.None, null);  // .ContinueWith(...
// Upload file and metadata
mountains_ref.PutFileAsync(local_file, new_metadata, null,
                           CancellationToken.None, null);  // .ContinueWith(...

监控上传进度

您可以将侦听器附加到上传操作中,以便监控上传的进度。侦听器会采用标准 System.IProgress<T> 接口。您可以使用 StorageProgress 类的一个实例,提供自己的 Action<T> 作为进度完成的回调。

// Start uploading a file
var task = storage_ref.Child("images/mountains.jpg")
    .PutFileAsync(local_file, null,
      new Firebase.Storage.StorageProgress<UploadState>(state => {
          // called periodically during the upload
          Debug.Log(String.Format("Progress: {0} of {1} bytes transferred.",
                             state.BytesTransferred, state.TotalByteCount));
      }), CancellationToken.None, null);

task.ContinueWith(resultTask => {
    if (!resultTask.IsFaulted && !resultTask.IsCancelled) {
        Debug.Log("Upload finished.");
    }
});

错误处理

导致上传时出现错误的原因有很多,包括本地文件不存在,或者用户不具备上传所需文件的权限。如需了解有关错误的详情,请参阅相关文档的处理错误部分。

后续步骤

现在您已经上传了文件,接下来,我们将学习如何从 Cloud Storage 下载文件

发送以下问题的反馈:

此网页
需要帮助?请访问我们的支持页面