ffmpegPlus

executeCommand

executeCommandSync

stopCommand

audioMerge

videoMerge

getFileInfo

getFileInfoSync

模块接口

executeCommand

执行ffmpeg命令

executeCommand({params},callback(ret, err))

params

cmd：

  • 类型：字符串型
  • 描述：（必填项）需要执行的命令内容(文件支持fs:// cache:// box://)[对于命令中使用的文件是否存在的验证需要开发者调用接口前验证，否则会导致App崩溃]

callback(ret, err)

ret：

  • 类型：JSON对象
  • 内部字段：
{
    status: true,   //布尔型；true||false
    evenType : '',//onCompleted 转换完成
                   //onProgress 转换进度
                   //onCancel 退出转换
                   //onError 转换异常
    time : '',//onProgress事件时有值
    speed : '',//onProgress事件时有值
    fps : '',//onProgress事件时有值
}

err：

  • 类型：JSON对象
  • 内部字段：
{
    msg: "",
}

示例代码

var demo = api.require('ffmpegPlus');
demo.executeCommand({
    cmd: '-i concat:fs://aa.mp3|fs://bb.mp3 -acodec copy fs://cc.mp3'
    //cmd : '-allowed_extensions ALL -i fs://111/local.m3u8 -c copy fs://111/1.mp4' 加密的m3u8合并命令
},function(ret, err){
});

可用性

iOS、Android系统

可提供的1.0.0及更高版本

executeCommandSync

执行ffmpeg命令

executeCommandSync({params})

params

cmd：

  • 类型：字符串型
  • 描述：（必填项）需要执行的命令内容(文件支持fs:// cache:// box://)[对于命令中使用的文件是否存在的验证需要开发者调用接口前验证，否则会导致App崩溃]

ret：

  • 类型：JSON对象
  • 内部字段：
{
    status: true,   //布尔型；true||false
    evenType : '',//onCompleted 转换完成
                   //onProgress 转换进度
                   //onCancel 退出转换
                   //onError 转换异常
    time : '',//onProgress事件时有值
    speed : '',//onProgress事件时有值
    fps : '',//onProgress事件时有值
    msg : ''
}

示例代码

var demo = api.require('ffmpegPlus');
demo.executeCommandSync({
    cmd: '-i concat:fs://aa.mp3|fs://bb.mp3 -acodec copy fs://cc.mp3'
    //cmd : '-allowed_extensions ALL -i fs://111/local.m3u8 -c copy fs://111/1.mp4' 加密的m3u8合并命令
});

可用性

iOS、Android系统

可提供的1.0.0及更高版本

stopCommand

中断停止命令的执行

stopCommand(callback(ret, err))

callback(ret, err)

ret：

  • 类型：JSON对象
  • 内部字段：
{
    status: true   //布尔型；true||false
}

示例代码

var demo = api.require('ffmpegPlus');
demo.stopCommand();

可用性

iOS、Android系统

可提供的1.0.0及更高版本

audioMerge

音频的合并

audioMerge({params},callback(ret, err))

params

onePath：

  • 类型：字符串型
  • 描述：（必填项）需要合并的音频文件1(文件支持fs:// cache:// box://)

twoPath：

  • 类型：字符串型
  • 描述：（必填项）需要合并的音频文件2(文件支持fs:// cache:// box://)

targetPath：

  • 类型：字符串型
  • 描述：（必填项）合并后文件存放路径(文件支持fs:// cache:// box://)

callback(ret, err)

ret：

  • 类型：JSON对象
  • 内部字段：
{
    status: true,   //布尔型；true||false
   evenType : '',//onCompleted 转换完成
                   //onProgress 转换进度
                   //onCancel 退出转换
                   //onError 转换异常
    time : '',//onProgress事件时有值
    speed : '',//onProgress事件时有值
    fps : '',//onProgress事件时有值
}

err：

  • 类型：JSON对象
  • 内部字段：
{
    msg: "",
}

示例代码

var demo = api.require('ffmpegPlus');
demo.audioMerge({
    "onePath":"fs://aa.mp3",
    "twoPath":"fs://bb.mp3",
    "targetPath":"fs://cc1.mp3"
},function(ret, err){
});

可用性

iOS、Android系统

可提供的1.0.0及更高版本

videoMerge

视频和音频合并

videoMerge(callback(ret, err))

callback(ret, err)

ret：

  • 类型：JSON对象
  • 内部字段：
{
    status: true,   //布尔型；true||false
    evenType : '',//onCompleted 转换完成
                   //onProgress 转换进度
                   //onCancel 退出转换
                   //onError 转换异常
    time : '',//onProgress事件时有值
    speed : '',//onProgress事件时有值
    fps : '',//onProgress事件时有值
}

err：

  • 类型：JSON对象
  • 内部字段：
{
    msg: ""
}

示例代码

var demo = api.require('ffmpegPlus');
demo.videoMerge({
    "videoPath":"fs://aa.mp4",
    "audioPath":"fs://bb.mp3",
    "targetPath":"fs://cc.mp4"
},function(ret, err) {
});

可用性

iOS、Android系统

可提供的1.0.0及更高版本

getFileInfo

获取视频文件属性

getFileInfo(callback(ret, err))

callback(ret, err)

ret：

  • 类型：JSON对象
  • 内部字段：
{
    status: true,   //布尔型；true||false
   tags : '',
   allProperties : '',
   bitrate : '',
   duration : '',
   filename : '',
   format : '',
   longFormat : '',
   size : '',
}

err：

  • 类型：JSON对象
  • 内部字段：
{
    msg: ""
}

示例代码

var demo = api.require('ffmpegPlus');
demo.getFileInfo({
    "path":"fs://aa.mp4",
},function(ret, err) {
});

可用性

iOS、Android系统

可提供的1.0.0及更高版本

getFileInfoSync

获取视频文件属性

getFileInfoSync(callback(ret, err))

ret：

  • 类型：JSON对象
  • 内部字段：
{
    status: true,   //布尔型；true||false
    msg : '',
   tags : '',
   allProperties : '',
   bitrate : '',
   duration : '',
   filename : '',
   format : '',
   longFormat : '',
   size : '',
}

示例代码

var demo = api.require('ffmpegPlus');
var ret = demo.getFileInfoSync({
    "path":"fs://aa.mp4",
});

可用性

iOS、Android系统

可提供的1.0.0及更高版本

是否仍需要帮助？ 请保持联络！
最后更新于 2025/09/15