Vai alla console

适用于 Unity 的 Cloud Storage 使用入门

使用 Cloud Storage for Firebase,您可以上传和共享用户生成的内容(如图片和视频),以便将富媒体内容融入到您的应用中。您的数据存储在 Google Cloud Storage 存储分区中,这是一种 EB 级对象存储解决方案,不仅可用性高,还能实现全局冗余。使用 Cloud Storage,您可以直接从移动设备和网络浏览器安全上传这些文件,轻松应对网络时好时坏的问题。

准备工作

在使用 Cloud Storage 之前,您需要:

  • 注册 Unity 项目并将其配置为使用 Firebase。

    • 如果您的 Unity 项目已在使用 Firebase,那么您就已注册该 Unity 项目并已将其配置为使用 Firebase。

    • 如果您没有 Unity 项目,则可以下载示例应用

  • Firebase Unity SDK(具体而言是 FirebaseStorage.unitypackage)添加到您的 Unity 项目中。

请注意,将 Firebase 添加到 Unity 项目需要在 Firebase 控制台中和打开的 Unity 项目中执行若干任务(例如,从控制台下载 Firebase 配置文件,然后将配置文件移动到 Unity 项目中)。

创建默认 Storage 存储分区

  1. Firebase 控制台的导航窗格中,选择 Storage,然后点击开始

  2. 查看有关使用安全规则保护 Storage 数据的消息。在开发过程中,请考虑设置您的公共访问规则

  3. 选择一个位置作为您的默认 Storage 存储分区。

    • 此位置设置是您项目的默认 Google Cloud Platform (GCP) 资源位置。请注意,此位置将用于项目中需要位置设置的 GCP 服务,具体来讲是 Cloud Firestore 数据库和 App Engine 应用(如果您使用 Cloud Scheduler,就需要该应用)。

    • 如果您无法选择位置,则表示您的项目已具有默认 GCP 资源位置。它可能是在项目创建期间设置的,也可能是在设置需要位置设置的其他服务时设置的。

    如果您使用的是 Blaze 方案,则可以创建多个存储分区,每个存储分区都有自己的位置

  4. 点击完成

设置公共访问

Cloud Storage for Firebase 提供了一种声明式规则语言,可用于定义数据的组织结构方式、将数据编入索引的方式,以及何时可以读取和写入数据。默认情况下,对 Storage 的读写权限是有限制的,只有通过身份验证的用户才能读写数据。要在不设置身份验证的情况下开始使用 Storage,您可以将您的规则配置为允许公共访问

这会使得 Storage 向所有人开放,包括不使用您的应用的用户,因此在设置身份验证时,请务必重新限制对 Storage 的访问。

访问 FirebaseStorage

Firebase.Storage.FirebaseStorage 是 Cloud Storage Unity SDK 的入口点。

// Get a reference to the storage service, using the default Firebase App
FirebaseStorage storage = FirebaseStorage.DefaultInstance;

现在可以开始使用 Cloud Storage 了!

首先,我们来了解如何创建 Cloud Storage 引用

高级设置

以下几种使用情形需要进行额外的设置:

如果您的用户遍布世界各地,并且您希望将他们的数据存储在各自所在地附近,则非常适合参考第一种使用情形。例如,您可以在美国、欧洲和亚洲创建存储分区,用于为这些区域的用户存储数据,以减少延迟时间。

如果您的数据有不同的访问模式,则适合第二种使用情形。例如,您可以设置一个多区域或单区域存储分区来存储照片或其他经常访问的内容,并设置一个 Nearline 或 Coldline 存储分区以存储用户备份或其他不常访问的内容。

在这两种使用情形下,您都需要使用多个存储分区

如果您要构建一个允许用户登录多个帐号(例如,一个个人帐号和一个工作帐号)的应用(例如 Google 云端硬盘),则适合第三种使用情形。您可以使用自定义 Firebase 应用实例来对额外的每个帐号进行身份验证。

使用多个存储分区

如果要使用除上文介绍的默认存储分区以外的其他存储分区,或在单个应用中使用多个存储分区,您可以创建一个引用您的自定义存储分区的 FirebaseStorage 实例:

// Get a non-default Storage bucket
var storage = FirebaseStorage.GetInstance("gs://my-custom-bucket");

使用导入的存储分区

将现有 Cloud Storage 存储分区导入 Firebase 时,您必须使用 Google Cloud SDK 中包含的 gsutil 工具授予 Firebase 访问这些文件的权限:

gsutil -m acl ch -r -u firebase-storage@system.gserviceaccount.com:O gs://<your-cloud-storage-bucket>

这不会影响新建的存储分区,因为其已默认设置为允许 Firebase 访问。这是一项临时措施,将来会自动执行。

使用自定义 Firebase 应用

如果您要使用自定义 FirebaseApp 构建更复杂的应用,可以创建使用该应用初始化的 FirebaseStorage 实例:

// Get the default bucket from a custom FirebaseApp
FirebaseStorage storage = FirebaseStorage.GetInstance(customApp);

// Get a non-default bucket from a custom FirebaseApp
FirebaseStorage storage = FirebaseStorage.GetInstance(customApp, "gs://my-custom-bucket");