更新记录

1.0.0（2026-09-04）

• 首次发布：Android 端 FFmpeg 视频转码
• 支持自定义 ffmpeg 参数、实时进度回调、取消任务
• 默认硬件 H.264（h264_mediacodec），失败自动回退 mpeg4

平台兼容性

uni-app(4.56)

lab-ffmpegconvert

基于 FFmpegKit 的 uni-app UTS 视频转码插件。

可通过自定义 args 将视频转换成指定分辨率、帧率和码率（也支持仅改封装、自定义编码参数等）。

需自定义基座或云打包后才能在真机跑通。

目录结构

lab-ffmpegconvert
├─ js/index.js                     # JS Promise 封装
├─ utssdk
│  ├─ interface.uts                # 类型定义
│  ├─ index.uts                    # 非 App 空实现
│  └─ app-android
│     ├─ config.json               # Maven 依赖 + minSdk 24
│     └─ index.uts                 # Android 实现
└─ package.json

环境要求

使用示例

将本插件放入项目 uni_modules/lab-ffmpegconvert 后：

import { convertVideo, cancelConvert } from '@/uni_modules/lab-ffmpegconvert/js'

const output = await convertVideo({
  input: 'file:///storage/emulated/0/DCIM/input.mov',
  // output 不传 → 写入应用缓存 ffmpeg_output/
  // args 不传 → 默认硬件 H.264 + AAC（失败自动回退 mpeg4）
  : (p) => console.log(p.percent)
})

// cancelConvert()

ConvertOptions

常用 args 示例

不要默认写 libx264：当前 full 依赖里没有该编码器。