FFmpeg 저장소
설치 단계와 이 플러그인의 전체 마크다운 가이드를 포함한 설치 명령어를 복사할 수 있는 설정 명령어를 복사하세요.
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-Assisted Setup을 사용하여 플러그인을 설치할 수 있습니다. AI 도구에 다음 명령어를 사용하여 Capgo 기능을 추가하세요:
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.만약 Manual Setup을 선호한다면, 다음 명령어를 실행하고 아래의 플랫폼별 지침을 따르세요:
bun add @capgo/capacitor-ffmpegbunx cap syncImport
Import 섹션import { CapacitorFFmpeg } from '@capgo/capacitor-ffmpeg';API 개요
API 개요 섹션getCapabilities
Section titled “getCapabilities”현재 플랫폼의 기기 읽기 가능성 매트릭스를 반환합니다.
import { CapacitorFFmpeg } from '@capgo/capacitor-ffmpeg';
await CapacitorFFmpeg.getCapabilities();reencodeVideo
Section titled “reencodeVideo”비디오 재인코딩 작업을 큐에 넣습니다.
iOS에서 반환된 프로미스는 네이티브层가 작업을 수락할 때 해결됩니다.
최종 성공 또는 실패는 progress listener
현재 Android와 웹은 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
“convertAudio” 섹션오디오를 다른 컨테이너 또는 코덱으로 변환합니다.
현재 iOS는 m4a클립보드에 복사 UNIMPLEMENTED.
import { CapacitorFFmpeg } from '@capgo/capacitor-ffmpeg';
await CapacitorFFmpeg.convertAudio({} as ConvertAudioOptions);“Type Reference” 섹션
타입 참조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이 업스트림에서 변경될 때 다시 싱크를 실행하십시오.
시작하기
시작하기이 플러그인을 사용하여 시작하기 to plan dashboard and API operations, connect it with Using @capgo/capacitor-ffmpeg Using @capgo/capacitor-ffmpeg Using @API/__CAPGO_KEEP_1__-ffmpeg, API Overview 구현 세부 정보에 대한 API 소개 소개 구현 세부 정보에 대한 소개 API 키 구현 세부 정보에 대한 API 키, 및 장치 구현 세부 정보에 대한 장치.