更新记录

1.0.0（2026-07-19）

首发：基于系统内置多媒体引擎的视频工具箱：视频缩略图 / 帧提取 / 元信息读取（路径进/路径出）+ 裁剪 / 拼接 / 转码 / 水印 / 场景切分 / 音频提取。

平台兼容性

uni-app x(5.14)

nex-video —— 高性能视频缩略图 / 帧提取

免额外原生库：能力基于系统内置多媒体引擎实现——无需附带任何第三方库，包体零负担、云打包无额外依赖。 仅支持 App 端（Android / iOS），H5 / 小程序无对应系统多媒体能力。

同一份 utssdk 插件同时支持 uni-app x（uvue） 与 经典 uni-app（vue3），无需分叉。 全部「路径进 / 路径出」：读视频文件路径，缩略图写 JPEG 到目标路径，元信息直接返回结构体。

API

本插件共 9 个 JS API（2 个同步「路径进出」+ 7 个异步剪辑/分析）：

异步 API（trim/concat/transcode/watermark/detectScenes/detectFaces/extractAudio）入参为具名 options 对象（含可选 onProgress(percent) 回调），返回 Promise，签名与类型以 interface.uts 契约为准。

类型

// 缩略图结果（字段 camelCase）
type VideoThumbResult = { width: number; height: number; sizeBytes: number; costMs: number };

// 视频元信息（字段 camelCase）
type VideoInfo = {
  durationMs: number; width: number; height: number;
  rotation: number; frameRate: number; hasAudio: boolean;
};

• videoThumbnail：timeMs（毫秒）取帧；maxWidth / maxHeight 为等比缩放上限框，只缩不放；输出固定 JPEG（质量 90）。取帧失败抛 Error。
• videoInfo：durationMs 时长（毫秒）；rotation ∈ 0 / 90 / 180 / 270；frameRate 帧率（fps）；hasAudio 是否含音轨。

用法

import { videoThumbnail, videoInfo } from "@/uni_modules/nex-video";

// 选视频拿到 tempFilePath 作 src（uni.chooseVideo）
const dest = "_doc/nex-video/thumb.jpg";
const thumb = videoThumbnail(src, dest, 1000, 320, 320); // 取第 1 秒帧，缩到 ≤320×320
// thumb: { width, height, sizeBytes, costMs }

const info = videoInfo(src);
// info: { durationMs, width, height, rotation, frameRate, hasAudio }

限制

• 仅 App 端（Android / iOS）；H5 / 各家小程序不支持。
• 只读本地文件路径：src 须为可读本地视频路径（如 uni.chooseVideo 的 tempFilePath），不支持远程 URL / buffer。
• 缩略图固定存 JPEG（质量 90）；timeMs 超时长时平台 codec 取最接近帧。

平台与调试边界

• 仅 app-android / app-ios；H5、各家小程序不支持。
• Android 真机调试需 HBuilderX ≥ 4.26（自定义调试基座）。
• 最终 App 打包由 HBuilderX / @dcloudio CLI 完成。