更新记录

1.0.1（2026-07-22）

-Android 鸿蒙 IOS 三端ffmpeg

1.0.0（2026-07-22）

-Android 鸿蒙 IOS 三端ffmpeg

平台兼容性

uni-app(4.18)

其他

👉 下载体验

---

ly028-FFMpeg

基于 FFmpeg 的全功能视频音频处理 UTS 插件（Android / iOS / HarmonyOS）

少配置、分层清晰：日常能力最少参数即可成功；进阶与命令留给需要精细控制的场景。

安装

在 HBuilderX 中导入插件，或放置到 uni_modules/ly028-FFMpeg/。

快速开始（推荐）

import {
  compressVideoAsync,
  cancelJob,
  getMediaInfoAsync
} from '@/uni_modules/ly028-FFMpeg'

// 压缩：只需路径 + 可选档位
const jobId = compressVideoAsync({
  inputPath: '/path/to/input.mp4',
  outputPath: '/path/to/output.mp4',
  quality: 'medium',      // low | medium | high → CRF
  resolution: '720p'      // 360p | 480p | 720p | 1080p | 1280x720
}, (pct) => {
  console.log('进度:', pct + '%')   // "0"…"100"
}, (json) => {
  const result = JSON.parse(json)
  if (result.code === 0) {
    console.log('完成', result.data)
  } else {
    console.log('失败', result.msg)  // 已 i18n，可直接 toast
  }
})

// 取消（任意任务类型）
cancelJob(jobId)

API 分层

日常（优先用这些）

语义（人话参数，无需写滤镜字符串）

控制

高级（最后手段）

语义 API 示例

import { rotateVideoAsync, adjustVolumeAsync, exportGifAsync } from '@/uni_modules/ly028-FFMpeg'

rotateVideoAsync({
  inputPath, outputPath, degrees: 90
}, , onComplete)

adjustVolumeAsync({
  inputPath, outputPath, volume: 1.5
}, , onComplete)

exportGifAsync({
  inputPath, outputPath, fps: 10, width: 320
}, , onComplete)

拼接（推荐 inputs）

concatAsync({
  inputs: ['/a.mp4', '/b.mp4'],
  outputPath: '/out.mp4'
}, , onComplete)

仍支持旧写法：{ inputPath: concatListFile, outputPath }。

统一响应信封 FFmpegResult

进度回调：onProgress 收到 "0"–"100" 字符串。

Demo 说明

测试页底栏：基础 | 进阶 | 命令。基础只露日常能力；进阶含编码器条与滤镜类；命令为原始 CLI。

平台

许可

本插件遵循 LGPL/GPL。FFmpeg 为 LGPL/GPL 开源项目。

👉 下载体验