更新记录

1.0.0（2026-11-05）

• 首发：音视频处理管线（压缩/剪辑/播放/缩略图），链式 API，付费闸门，原生硬解适配层（MediaCodec/AVAsset），零上传合规。

平台兼容性

uni-app(4.0)

zl-media-pipe 音视频处理管线 Pro

uni-app 音视频处理管线：原生硬解压缩 + 简易剪辑 + 播放器 + 首帧/缩略图，链式 API 一条龙。 版本：v1.0.0 ｜ 类型：UTS 插件（component-uts）｜ 授权：普通授权版 + 源码授权版

功能特性

• 压缩：等比/码率/帧率/分辨率参数化；高清/标清/低清三档预设；进度回调可取消；原生硬解降耗。
• 剪辑：裁剪（时间区间）、拼接、变速（0.5x–2x）、静音；预览后导出。
• 播放器：预加载、断点续播、倍速；视频元素内置 controls。
• 缩略图/首帧：poster 兜底 + 原生抓帧；批量队列。
• 链式 API：buildPipeline（compress→clip→thumbnail）进度贯穿。
• 付费闸门：压缩/批量管线为 Pro（enablePro/licenseKey/licenseApi 三级校验）。

快速上手

<zl-media :enable-pro="true" @done="onDone" @buy="onBuy" />

或调用编排 API（utils/media.ts）：

import { compressVideo, clipVideo, buildPipeline, estimateSize, savedPercent, formatDuration } from '@/uni_modules/zl-media-pipe/utils/media'
const r = await buildPipeline(src, { compress: { quality: 'sd' }, clip: { start: 0, end: 30, speed: 1.5 } }, onTask)

API

原生硬解接入（真机）

• Android：utssdk/app-android 接入 MediaCodec + MediaMuxer（系统硬解），实现 nativeCompress/nativeClip 后置 getCapability().ready=true。
• iOS：utssdk/app-ios 接入 AVAssetExportSession + AVMutableComposition（系统硬解），实现同接口后置 ready=true。
• 未接入引擎：压缩走 uni.compressVideo（内置）兜底；剪辑提示需接入原生适配（管线演示保留）。

合规声明

• 全部媒体处理在设备本地完成，零上传；用户主动选择视频后处理。
• 系统硬解编码（MediaCodec/AVAsset），无三方 SDK，规避 LGPL/GPL 传染；本地文件系统沙盒内读写。
• 不采集、不存储用户数据。

性能目标（真机验收）

压缩 ≥2x 实时｜首帧 ≤200ms｜播放首帧 ≤500ms｜4K 转码内存 ≤250MB 无 OOM｜缩略图 60 张 ≤3s。

变更记录

见 CHANGELOG.md。