@ capgo/ 容器- 文件- 压缩器

在上传前在设备上压缩并调整图像大小,并在JPEG,PNG和WebP之间转换. 更小的文件意味着更快地上传并降低存储成本.

🤖 建筑与AI编码代理? 安装 Capgo 技能 所以克劳德代码,代码,光标,副驾驶,或双子座CLI知道如何安装和使用 @capgo/capacitor-file-compressor 在您的电容应用程序中: npx skills add Cap-go/capgo-skills。然后问你的经纪人: 添加@capgo/capor-file-compressor到我的Capacitor应用软件上并把它接通" 代理设置指南 • 妇女 主机磁共振

主要特点

• 一通电话数字 : compressImage() 以宽度、高度和质量来调整和压缩大小.
• 格式转换:在Android和网络上输出JPEG,PNG或WebP. iOS增加了HEIF或HEIC,而WebP需要iOS 14或后期.
• 智能尺寸: 保持宽度比并永不提升.
• 最佳尺寸:如果结果大于来源,则损失格式的质量会降低。 PNG没有质量设置,因此输出仍然可以更大.
• 隐私: EXIF元数据在压缩时被删除.
• 平台:iOS,Android和Web. iOS使用图像IO,Android使用 Bitmap,网络使用画布.

为什么是文件压缩机?

用于 客户端图像压缩数字 :

• 格式转换 - 将HEIF、PNG、WebP、GIF以及更多的数据转换为JPEG、PNG、WebP或HEIF
• 多种格式 - 以平台特定产出格式提供广泛的投入支持
• 质量控制 - 可调整压缩质量(0.0-1.0)
• 智能调整大小 - 自动维护宽比而不扩大
• 跨平台 - 一致的API跨iOS,Android,和Web
• 无后端 - 所有压缩都发生在设备上

对于需要优化图像上传,减少存储,或改善性能而不进行服务器侧处理的应用程序来说,至关重要.

文档

这里有最完整的医生: https://capgo.app/docs/plugins/file-compressor/ 互联网档案馆的存檔,存档日期2013-12-12

兼容性

说明: 此插件的主要版本沿用了Capacitor的主要版本. 使用匹配您的 Capacitor 安装的版本( 如 Capacitor 8 的插件 v8) 。 只有最新的主要版本得到积极维护.

安装

您可以使用我们的 AI 辅助设置安装插件 。 使用以下命令将 Capgo 技能添加到您的 AI 工具 :

npx skills add https://github.com/cap-go/capacitor-skills --skill capacitor-plugins

然后使用下列提示:

Use the `capacitor-plugins` skill from `cap-go/capacitor-skills` to install the `@capgo/capacitor-file-compressor` plugin in my project.

如果您更喜欢手动设置,请通过运行以下命令来安装插件,并遵循下面的平台特定指令:

npm install @capgo/capacitor-file-compressor
npx cap sync

格式转换

插件接受通用图像格式作为输入,并将其转换为 mimeType 你请求.

import { FileCompressor } from '@capgo/capacitor-file-compressor';

// Convert an iPhone HEIF photo to JPEG before upload
const result = await FileCompressor.compressImage({
  path: heifFileUri,
  width: 1920,
  height: 1080,
  quality: 0.7,
  mimeType: 'image/jpeg',
});

注意: EXIF元数据在所有平台的压缩过程中被删除.

API 密码

• compressImage(...)
• getPluginVersion()
• 接口

用于图像压缩的电容文件压缩器插件接口.

压缩图像(...)

compressImage(options: CompressImageOptions) => Promise<CompressImageResult>

压缩带有指定尺寸和质量设置的图像文件.

这种方法在保持可接受质量的同时压缩图像以缩小文件大小. 它支持跨通用图像格式的再大小和格式转换.

支持的输入格式( 平台解码器依赖性): JPEG、PNG、WebP、GIF、BMP、TIFF、HEIF/HEIC

支持的输出格式 :

• iOS: (英语) image/jpeg, (中文(简体) ), image/png, (中文(简体) ), image/heif, (中文(简体) ), image/heic, (中文(简体) ), image/webp (iOS 14+) (中文(简体) )
• 机器人: image/jpeg, (中文(简体) ), image/png, (中文(简体) ), image/webp
• 网络 : image/jpeg, (中文(简体) ), image/png, (中文(简体) ), image/webp

重要注释 :

• 在压缩所有平台时删除 EXIF 元数据
• 如果只提供1个维,则自动保持光谱比
• 当提供宽度和高度时,图像可以放在盒子内而无需缩放
• 压缩后的文件保存到本地平台的临时目录
• 如果被编码的输出会大于源文件,则在保持所请求的输出格式的同时会自动降低质量

回返情况: Promise<CompressImageResult>

自: 7.0.0 (单位:千美元)

获取 PluginVersion ()

getPluginVersion() => Promise<{ version: string; }>

获取本地 Capacitor 插件版本 .

返回本地插件执行版本 . 用于调试和确保兼容性 .

回返情况: Promise<{ version: string; }>

自: 7.0.0 (单位:千美元)

接口

压缩图像

压缩一相之结果.

包含文件路径( 本地平台) 或 Blob( 网络平台) 取决于压缩在哪里进行.

压缩图像选项

压缩图像的选项.

配置压缩行为,包括质量、尺寸和输出格式. 路径(本土)和blob(网络)都有特定平台选项.