Google 致力于为黑人社区推动种族平等。查看具体举措

调整图片的尺寸

Firebase
Firebase 制造

将上传到 Cloud Storage 的图片调整为指定尺寸,可选择保留或删除原始图片。

此扩展程序的运作方式

使用此扩展程序可为上传至 Cloud Storage 存储桶的图片创建其他尺寸的版本。

将图片文件上传到您指定的 Cloud Storage 存储桶时,此扩展程序执行以下操作:

  • 创建调整为您指定尺寸的图片。
  • 使用与原图片相同的名称为调整后的图片命名,以您指定的宽度和高度作为名称后缀。
  • 将调整后的图片存储在原图片所在的 Storage 存储桶内。

您甚至可以对此扩展程序进行配置,使其为每张上传的原始图片创建多张尺寸各不相同的调整后图片。举例来说,您需要的图片尺寸可能是 200x200、400x400 和 680x680 - 此扩展程序可以创建这三种调整后的图片,然后将它们存储在存储桶中。

该扩展程序会自动将以下元数据(如果有)从原始图片复制到调整后的图片:Cache-Control、Content-Disposition、Content-Encoding、Content-Language、Content-Type 和用户提供的元数据(如果原始元数据包含令牌,则会在调整后的图片上生成一个新的 Firebase 存储下载令牌)。请注意,您可以选择对此扩展程序进行配置,以覆盖调整后图片的"Cache-Control"值。

详细配置信息

要配置此扩展程序,您可以指定最大宽度和最大高度(以像素 (px) 为单位)。此扩展程序会保持上传图片的宽高比不变,然后缩小图片,直至调整后的图片尺寸不超过指定的最大高度和宽度。

举例来说,假如您指定的最大宽度为 200 px,最大高度为 100 px。您上传的图片宽度为 480 px,高度为 640 px,这意味着宽高比为 0.75。为了保持该宽高比且不超过指定的最大尺寸,最终图片的宽度将为 75 px,高度将为 100 px。

额外设置

在安装此扩展程序之前,请确保您已经在 Firebase 项目中设置了一个 Cloud Storage 存储桶

结算

若要安装扩展程序,您的项目必须采用 Blaze(随用随付)方案

  • 您需要为此扩展程序所需的 Firebase 资源支付少量费用(通常约为 $0.01/月),即使没有使用此扩展程序也要支付。
  • 此扩展程序用到了其他 Firebase 和 Google Cloud Platform 服务,如果超出这些服务的免费层级,可能会产生相关的费用:
  • Cloud Storage
  • Cloud Functions(Node.js 10+ 运行时。查看常见问题解答

如何安装此扩展程序

使用 Firebase 控制台

要安装和管理扩展程序,您可以使用 Firebase 控制台。

使用控制台安装

使用 Firebase CLI

要安装和管理扩展程序,您还可以使用 Firebase CLI:

步骤 1:运行以下 npm 命令来安装 CLI 或将 CLI 更新到最新版本。

npm install -g firebase-tools
不能运行?请参阅 Firebase CLI 参考文档或者更改您的 npm 权限

步骤 2:运行以下命令来安装此扩展程序

firebase ext:install firebase/storage-resize-images --project=projectId_or_alias
支持
Cloud Storage
作者
许可
Apache-2.0
版本
0.1.24