开始
复制一个包含安装步骤和本插件的完整Markdown指南的设置命令。
Set up this Capacitor plugin in the project.
Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-ffmpeg`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/ffmpeg/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.
您可以使用我们的AI辅助设置来安装插件。使用以下命令将Capgo技能添加到您的AI工具中:
npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins然后使用以下提示:
Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-ffmpeg` plugin in my project.如果您更喜欢手动设置,请运行以下命令安装插件,并按照以下平台特定的说明进行操作:
bun add @capgo/capacitor-ffmpegbunx cap sync导入
导入import { CapacitorFFmpeg } from '@capgo/capacitor-ffmpeg';getCapabilities
Section titled “getCapabilities”获取当前平台的机器可读能力矩阵。
import { CapacitorFFmpeg } from '@capgo/capacitor-ffmpeg';
await CapacitorFFmpeg.getCapabilities();reencodeVideo
Section titled “reencodeVideo”排队一个视频重编码任务。
在 iOS 上,返回的 promise 在本机层接受任务时解析。
最终成功或失败将通过 progress 监听器
Android 和 web 当前拒绝 UNIMPLEMENTED.
import { CapacitorFFmpeg } from '@capgo/capacitor-ffmpeg';
await CapacitorFFmpeg.reencodeVideo({} as ReencodeVideoOptions);convertImage
Section titled “convertImage”将静态图像转换为另一种格式。
iOS 当前支持 jpeg 和 .png安卓目前支持 .webp, jpeg, 和 .png复制到剪贴板 UNIMPLEMENTED.
import { CapacitorFFmpeg } from '@capgo/capacitor-ffmpeg';
await CapacitorFFmpeg.convertImage({} as ConvertImageOptions);convertAudio
将音频转换为另一种容器或编解码器。安卓目前支持
安卓和 web 目前拒绝 m4a复制到剪贴板 UNIMPLEMENTED.
import { CapacitorFFmpeg } from '@capgo/capacitor-ffmpeg';
await CapacitorFFmpeg.convertAudio({} as ConvertAudioOptions);标题:类型参考
__CAPGO_KEEP_0__FFmpegCapabilitiesResult
FFmpeg功能支持结果export interface FFmpegCapabilitiesResult { platform: string; features: FFmpegCapabilitiesFeatures;}ReencodeVideoOptions
重编码视频选项export interface ReencodeVideoOptions { inputPath: string; outputPath: string; width: number; height: number; bitrate?: number;}FFmpegAcceptedJob
FFmpeg接受的工作export interface FFmpegAcceptedJob { jobId: string; status: 'queued';}ConvertImageOptions
转换图像选项export interface ConvertImageOptions { inputPath: string; outputPath: string; format: ImageOutputFormat; /** * Compression quality in the inclusive range `0.0..1.0`. * * Native platforms reject values outside that range. */ quality?: number;}ConvertImageResult
转换图像结果export interface ConvertImageResult { outputPath: string; format: ImageOutputFormat;}ConvertAudioOptions
转换音频选项export interface ConvertAudioOptions { inputPath: string; outputPath: string; format: AudioOutputFormat;}ConvertAudioResult
Section titled “音频转换结果”export interface ConvertAudioResult { outputPath: string; format: AudioOutputFormat;}FFmpegProgressEvent
Section titled “FFmpeg进度事件”export interface FFmpegProgressEvent { jobId: string; /** * Normalized progress as a floating-point value in the inclusive range `0.0..1.0`. */ progress: number; state: FFmpegProgressState; message?: string; outputPath?: string; /** * Legacy alias kept for compatibility while callers migrate to `jobId`. */ fileId?: string;}PluginVersionResult
Section titled “插件版本结果”export interface PluginVersionResult { version: string;}FFmpegCapabilitiesFeatures
Section titled “FFmpeg功能特性”export interface FFmpegCapabilitiesFeatures { getPluginVersion: FFmpegCapability; getCapabilities: FFmpegCapability; reencodeVideo: FFmpegCapability; convertImage: FFmpegCapability; convertAudio?: FFmpegCapability; progressEvents: FFmpegCapability; probeMedia: FFmpegCapability; generateThumbnail: FFmpegCapability; extractAudio: FFmpegCapability; remux: FFmpegCapability; trim: FFmpegCapability;}ImageOutputFormat
Section titled “图像输出格式”export type ImageOutputFormat = '.webp' | 'jpeg' | '.png';AudioOutputFormat
Section titled “音频输出格式”export type AudioOutputFormat = 'm4a';真实数据来源
真实数据来源本页面由插件的 src/definitions.ts当公共API在上游发生变化时,请重新运行同步。
继续从开始
继续从开始如果您正在使用 开始 来规划仪表板和API操作,请将其与 使用@capgo/capacitor-ffmpeg 为在使用@capgo/capacitor-ffmpeg中native能力的 API概述 为 API 概述的实现细节 简介 为简介的实现细节 API 密钥 为 API 密钥的实现细节,以及 设备 为设备的实现细节。