更新记录

1.2.4（2026-05-21）

新增stopFFprobeCommand接口。

1.2.3（2026-05-18）

新增音频裁剪、尺寸裁剪、视频调速、图片去水印、时长裁剪、视频压缩、视频滤镜、视频不透明度、视频画中画、视频特效接口。

1.2.2（2026-05-05）

优化鸿蒙版本代码逻辑。

查看更多

平台兼容性

uni-app(4.73)

Vue2 Vue2插件版本 Vue3 Vue3插件版本 Chrome Safari app-vue app-nvue Android Android插件版本 iOS iOS插件版本 鸿蒙
√ 1.1.3 √ 1.1.3 × × × × 5.0 1.1.3 12 1.1.3 5.0.0
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟
× × × × × × × × × - × ×

uni-app x(4.73)

Chrome Safari Android Android插件版本 iOS iOS插件版本 鸿蒙 微信小程序
× × 5.0 1.1.3 12 1.1.3 5.0.0 ×

概述

XF-ffmpegPlusUTS封装了在Android、iOS和鸿蒙系统中执行ffmpeg的命令对进行音视频处理的逻辑

插件接口

executeCommand

执行ffmpeg命令

uni-app项目中（nvue）调用示例：

import { executeCommand } from "@/uni_modules/XF-ffmpegPlusUTS"

executeCommand({
  cmd: "",
  complete: (res) => {
        console.log(res)
  }
});

uni-app x项目（uvue）中调用示例：

import { executeCommand } from "@/uni_modules/XF-ffmpegPlusUTS";
import { CommandOptions } from "@/uni_modules/XF-ffmpegPlusUTS/utssdk/interface.uts";

let options = {
  cmd: "",
  complete: (res : any) => {
    console.log(res)
  }
} as CommandOptions;
executeCommand(options);

可用性

iOS、Android、Harmony系统

可提供的1.0.0及更高版本

executeCommandSync

执行ffmpeg命令

uni-app项目中（nvue）调用示例：

import { executeCommandSync } from "@/uni_modules/XF-ffmpegPlusUTS"

executeCommandSync("");

uni-app x项目（uvue）中调用示例：

import { executeCommandSync } from "@/uni_modules/XF-ffmpegPlusUTS";
executeCommandSync("");

可用性

iOS、Android系统

可提供的1.0.0及更高版本

stopCommand

停止执行ffmpeg命令

uni-app项目中（nvue）调用示例：

import { stopCommand } from "@/uni_modules/XF-ffmpegPlusUTS"

stopCommand({
  sessionId : 1,
  complete: (res) => {
        console.log(res)
  }
});

uni-app x项目（uvue）中调用示例：

import { stopCommand } from "@/uni_modules/XF-ffmpegPlusUTS";
import { StopCommandOptions } from "@/uni_modules/XF-ffmpegPlusUTS/utssdk/interface.uts";

let options = {
  sessionId : 1,
  complete: (res : any) => {
    console.log(res)
  }
} as StopCommandOptions;
stopCommand(options);

可用性

iOS、Android、Harmony系统

可提供的1.0.0及更高版本

start

音乐合成

uni-app项目中（nvue）调用示例：

import { audioMerge } from "@/uni_modules/XF-ffmpegPlusUTS"

audioMerge({
  onePath : "",
  twoPath : "",
  targetPath : "",
  complete: (res) => {
        console.log(res)
  }
});

uni-app x项目（uvue）中调用示例：

import { audioMerge } from "@/uni_modules/XF-ffmpegPlusUTS";
import { AudioMergeOptions } from "@/uni_modules/XF-ffmpegPlusUTS/utssdk/interface.uts";

let options = {
  onePath : "",
  twoPath : "",
  targetPath : "",
  complete: (res : any) => {
    console.log(res)
  }
} as AudioMergeOptions;
audioMerge(options);

可用性

iOS、Android、Harmony系统

可提供的1.0.0及更高版本

videoMerge

视频合成

uni-app项目中（nvue）调用示例：

import { videoMerge } from "@/uni_modules/XF-ffmpegPlusUTS"

videoMerge({
  videoPath : "",
  audioPath : "",
  targetPath : "",
  complete: (res) => {
        console.log(res)
  }
});

uni-app x项目（uvue）中调用示例：

import { videoMerge } from "@/uni_modules/XF-ffmpegPlusUTS";
import { VideoMergeOptions } from "@/uni_modules/XF-ffmpegPlusUTS/utssdk/interface.uts";

let options = {
  videoPath : "",
  audioPath : "",
  targetPath : "",
  complete: (res : any) => {
    console.log(res)
  }
} as VideoMergeOptions;
videoMerge(options);

可用性

iOS、Android、Harmony系统

可提供的1.0.0及更高版本

audioClip

音频裁剪

uni-app项目中（nvue）调用示例：

import { audioClip } from "@/uni_modules/XF-ffmpegPlusUTS"

audioClip({
  audioPath : "",
  startTime : "0",
  duration : "5",
  targetPath : "",
  complete: (res) => {
        console.log(res)
  }
});

uni-app x项目（uvue）中调用示例：

import { audioClip } from "@/uni_modules/XF-ffmpegPlusUTS";
import { AudioClipOptions } from "@/uni_modules/XF-ffmpegPlusUTS/utssdk/interface.uts";

let options = {
  audioPath : "",
  startTime : "0",
  duration : "5",
  targetPath : "",
  complete: (res : any) => {
    console.log(res)
  }
} as AudioClipOptions;
audioClip(options);

可用性

iOS、Android、Harmony系统

可提供的1.2.3及更高版本

videoCrop

尺寸裁剪

uni-app项目中（nvue）调用示例：

import { videoCrop } from "@/uni_modules/XF-ffmpegPlusUTS"

videoCrop({
  videoPath : "",
  x : 0,
  y : 0,
  width : 720,
  height : 720,
  targetPath : "",
  complete: (res) => {
        console.log(res)
  }
});

uni-app x项目（uvue）中调用示例：

import { videoCrop } from "@/uni_modules/XF-ffmpegPlusUTS";
import { VideoCropOptions } from "@/uni_modules/XF-ffmpegPlusUTS/utssdk/interface.uts";

let options = {
  videoPath : "",
  x : 0,
  y : 0,
  width : 720,
  height : 720,
  targetPath : "",
  complete: (res : any) => {
    console.log(res)
  }
} as VideoCropOptions;
videoCrop(options);

可用性

iOS、Android、Harmony系统

可提供的1.2.3及更高版本

videoSpeed

视频调速

uni-app项目中（nvue）调用示例：

import { videoSpeed } from "@/uni_modules/XF-ffmpegPlusUTS"

videoSpeed({
  videoPath : "",
  speed : 1.25,
  targetPath : "",
  complete: (res) => {
        console.log(res)
  }
});

uni-app x项目（uvue）中调用示例：

import { videoSpeed } from "@/uni_modules/XF-ffmpegPlusUTS";
import { VideoSpeedOptions } from "@/uni_modules/XF-ffmpegPlusUTS/utssdk/interface.uts";

let options = {
  videoPath : "",
  speed : 1.25,
  targetPath : "",
  complete: (res : any) => {
    console.log(res)
  }
} as VideoSpeedOptions;
videoSpeed(options);

可用性

iOS、Android、Harmony系统

可提供的1.2.3及更高版本

imageRemoveWatermark

图片去水印

uni-app项目中（nvue）调用示例：

import { imageRemoveWatermark } from "@/uni_modules/XF-ffmpegPlusUTS"

imageRemoveWatermark({
  imagePath : "",
  x : 0,
  y : 0,
  width : 100,
  height : 100,
  targetPath : "",
  complete: (res) => {
        console.log(res)
  }
});

uni-app x项目（uvue）中调用示例：

import { imageRemoveWatermark } from "@/uni_modules/XF-ffmpegPlusUTS";
import { ImageRemoveWatermarkOptions } from "@/uni_modules/XF-ffmpegPlusUTS/utssdk/interface.uts";

let options = {
  imagePath : "",
  x : 0,
  y : 0,
  width : 100,
  height : 100,
  targetPath : "",
  complete: (res : any) => {
    console.log(res)
  }
} as ImageRemoveWatermarkOptions;
imageRemoveWatermark(options);

可用性

iOS、Android、Harmony系统

可提供的1.2.3及更高版本

durationClip

时长裁剪

uni-app项目中（nvue）调用示例：

import { durationClip } from "@/uni_modules/XF-ffmpegPlusUTS"

durationClip({
  path : "",
  startTime : "0",
  duration : "5",
  targetPath : "",
  complete: (res) => {
        console.log(res)
  }
});

uni-app x项目（uvue）中调用示例：

import { durationClip } from "@/uni_modules/XF-ffmpegPlusUTS";
import { DurationClipOptions } from "@/uni_modules/XF-ffmpegPlusUTS/utssdk/interface.uts";

let options = {
  path : "",
  startTime : "0",
  duration : "5",
  targetPath : "",
  complete: (res : any) => {
    console.log(res)
  }
} as DurationClipOptions;
durationClip(options);

可用性

iOS、Android、Harmony系统

可提供的1.2.3及更高版本

videoCompress

视频压缩

uni-app项目中（nvue）调用示例：

import { videoCompress } from "@/uni_modules/XF-ffmpegPlusUTS"

videoCompress({
  videoPath : "",
  videoBitrate : "1000k",
  width : 720,
  height : 1280,
  targetPath : "",
  complete: (res) => {
        console.log(res)
  }
});

uni-app x项目（uvue）中调用示例：

import { videoCompress } from "@/uni_modules/XF-ffmpegPlusUTS";
import { VideoCompressOptions } from "@/uni_modules/XF-ffmpegPlusUTS/utssdk/interface.uts";

let options = {
  videoPath : "",
  videoBitrate : "1000k",
  width : 720,
  height : 1280,
  targetPath : "",
  complete: (res : any) => {
    console.log(res)
  }
} as VideoCompressOptions;
videoCompress(options);

可用性

iOS、Android、Harmony系统

可提供的1.2.3及更高版本

videoFilter

视频滤镜

uni-app项目中（nvue）调用示例：

import { videoFilter } from "@/uni_modules/XF-ffmpegPlusUTS"

videoFilter({
  videoPath : "",
  filter : "hue=s=0",
  targetPath : "",
  complete: (res) => {
        console.log(res)
  }
});

uni-app x项目（uvue）中调用示例：

import { videoFilter } from "@/uni_modules/XF-ffmpegPlusUTS";
import { VideoFilterOptions } from "@/uni_modules/XF-ffmpegPlusUTS/utssdk/interface.uts";

let options = {
  videoPath : "",
  filter : "hue=s=0",
  targetPath : "",
  complete: (res : any) => {
    console.log(res)
  }
} as VideoFilterOptions;
videoFilter(options);

可用性

iOS、Android、Harmony系统

可提供的1.2.3及更高版本

videoOpacity

视频不透明度

uni-app项目中（nvue）调用示例：

import { videoOpacity } from "@/uni_modules/XF-ffmpegPlusUTS"

videoOpacity({
  videoPath : "",
  opacity : 0.5,
  targetPath : "",
  complete: (res) => {
        console.log(res)
  }
});

uni-app x项目（uvue）中调用示例：

import { videoOpacity } from "@/uni_modules/XF-ffmpegPlusUTS";
import { VideoOpacityOptions } from "@/uni_modules/XF-ffmpegPlusUTS/utssdk/interface.uts";

let options = {
  videoPath : "",
  opacity : 0.5,
  targetPath : "",
  complete: (res : any) => {
    console.log(res)
  }
} as VideoOpacityOptions;
videoOpacity(options);

可用性

iOS、Android、Harmony系统

可提供的1.2.3及更高版本

videoPictureInPicture

视频画中画

uni-app项目中（nvue）调用示例：

import { videoPictureInPicture } from "@/uni_modules/XF-ffmpegPlusUTS"

videoPictureInPicture({
  videoPath : "",
  overlayPath : "",
  x : 20,
  y : 20,
  width : 240,
  height : 135,
  targetPath : "",
  complete: (res) => {
        console.log(res)
  }
});

uni-app x项目（uvue）中调用示例：

import { videoPictureInPicture } from "@/uni_modules/XF-ffmpegPlusUTS";
import { VideoPictureInPictureOptions } from "@/uni_modules/XF-ffmpegPlusUTS/utssdk/interface.uts";

let options = {
  videoPath : "",
  overlayPath : "",
  x : 20,
  y : 20,
  width : 240,
  height : 135,
  targetPath : "",
  complete: (res : any) => {
    console.log(res)
  }
} as VideoPictureInPictureOptions;
videoPictureInPicture(options);

可用性

iOS、Android、Harmony系统

可提供的1.2.3及更高版本

videoEffect

视频特效

uni-app项目中（nvue）调用示例：

import { videoEffect } from "@/uni_modules/XF-ffmpegPlusUTS"

videoEffect({
  videoPath : "",
  effect : "grayscale",
  targetPath : "",
  complete: (res) => {
        console.log(res)
  }
});

uni-app x项目（uvue）中调用示例：

import { videoEffect } from "@/uni_modules/XF-ffmpegPlusUTS";
import { VideoEffectOptions } from "@/uni_modules/XF-ffmpegPlusUTS/utssdk/interface.uts";

let options = {
  videoPath : "",
  effect : "grayscale",
  targetPath : "",
  complete: (res : any) => {
    console.log(res)
  }
} as VideoEffectOptions;
videoEffect(options);

可用性

iOS、Android、Harmony系统

可提供的1.2.3及更高版本

getMediaFileInfo

获取文件信息

uni-app项目中（nvue）调用示例：

import { getMediaFileInfo } from "@/uni_modules/XF-ffmpegPlusUTS"

getMediaFileInfo({
  path : "",
  complete: (res) => {
        console.log(res)
  }
});

uni-app x项目（uvue）中调用示例：

import { getMediaFileInfo } from "@/uni_modules/XF-ffmpegPlusUTS";
import { FileOptions } from "@/uni_modules/XF-ffmpegPlusUTS/utssdk/interface.uts";

let options = {
  path : "",
  complete: (res : any) => {
    console.log(res)
  }
} as FileOptions;
getMediaFileInfo(options);

可用性

iOS、Android系统

可提供的1.0.0及更高版本

getMediaFileInfoSync

获取文件信息

uni-app项目中（nvue）调用示例：

import { getMediaFileInfoSync } from "@/uni_modules/XF-ffmpegPlusUTS"

getMediaFileInfoSync("");

uni-app x项目（uvue）中调用示例：

import { getMediaFileInfoSync } from "@/uni_modules/XF-ffmpegPlusUTS";

getMediaFileInfoSync("");

可用性

iOS、Android系统

可提供的1.0.0及更高版本

executeFFprobeCommand

执行ffprobe命令

uni-app项目中（nvue）调用示例：

import { executeFFprobeCommand } from "@/uni_modules/XF-ffmpegPlusUTS"

executeFFprobeCommand({
  cmd: "",
  complete: (res) => {
        console.log(res)
  }
});

uni-app x项目（uvue）中调用示例：

import { executeFFprobeCommand } from "@/uni_modules/XF-ffmpegPlusUTS";
import { CommandOptions } from "@/uni_modules/XF-ffmpegPlusUTS/utssdk/interface.uts";

let options = {
  cmd: "",
  complete: (res : any) => {
    console.log(res)
  }
} as CommandOptions;
executeFFprobeCommand(options);

可用性

iOS、Android、Harmony系统

可提供的1.0.0及更高版本

stopFFprobeCommand

停止执行ffprobe命令

uni-app项目中（nvue）调用示例：

import { stopFFprobeCommand } from "@/uni_modules/XF-ffmpegPlusUTS"

stopFFprobeCommand({
  sessionId : 1,
  complete: (res) => {
        console.log(res)
  }
});

uni-app x项目（uvue）中调用示例：

import { stopFFprobeCommand } from "@/uni_modules/XF-ffmpegPlusUTS";
import { StopCommandOptions } from "@/uni_modules/XF-ffmpegPlusUTS/utssdk/interface.uts";

let options = {
  sessionId : 1,
  complete: (res : any) => {
    console.log(res)
  }
} as StopCommandOptions;
stopFFprobeCommand(options);

可用性

iOS、Android、Harmony系统

可提供的1.0.0及更高版本

隐私、权限声明

1. 本插件需要申请的系统权限列表：

无

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明：

无

3. 本插件是否包含广告，如包含需详细说明广告表达方式、展示频率：

无

评论列表 撰写评论 向官方投诉
加载更多...