更新记录

1.0.0（2026-09-11）

1.0.0（2026-09-11）

• 初始版本：基于 FFmpegKit 的 Android 视频转码插件
• 支持自定义 ffmpeg 参数、实时进度回调、任务取消

平台兼容性

uni-app(4.83)

lab-ffmpeg-convert

基于 FFmpegKit 的 uni-app UTS 转码插件。需自定义基座 / 云打包。

目录结构

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

环境要求

方法

options 参数

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

转码视频

不传 args 时默认硬件 H.264 + AAC；失败自动回退 mpeg4。

const path = await convertVideo({
  input: 'file:///.../input.mov',
  // output: '/storage/.../out.mp4',  // 可选
  // args: '-c:v h264_mediacodec -b:v 2M -c:a aac -b:a 128k',
  : (p) => console.log(p.percent)
})

视频常用 args

完整默认：-c:v h264_mediacodec -b:v 2M -c:a aac -b:a 128k。不要写 libx264（当前 full 包没有）。

转码音频

仍调用 convertVideo，传音频 args，并指定 .mp3 输出路径：

const path = await convertVideo({
  input: 'file:///.../input.m4a',
  output: '/storage/.../out.mp3',
  args: '-vn -c:a libmp3lame -b:a 192k -ar 44100 -ac 2'
})

音频常用 args

推荐：-vn -c:a libmp3lame -b:a 192k -ar 44100 -ac 2；失败可改 libshine。