UniApp视频封面高清提取神器

下载地址：https://ext.dcloud.net.cn/plugin?id=26629

💎 插件介绍

muzi-video-cover 是一款专为 UniApp 开发的高性能视频封面提取组件。它完美解决了原生 uni.chooseVideo 在部分 Android 机型及 H5 环境下 thumbTempFilePath 返回为空的顽疾。

本插件采用 RenderJS 异步截帧技术 + 原生 Bitmap 转换方案，确保在 Android 8.0+ 和 iOS 12.0+ 上都能稳定、高清地获取视频第一帧，并自动转换为可直接上传的本地临时路径。

🌟 核心特性

• 高兼容性：支持 App (Android/iOS) 及 H5 平台，解决官方 API 封面丢失问题。
• 高性能：基于 RenderJS 渲染，不占用主逻辑线程，操作流畅不掉帧。
• 一键转存：自动将 Base64 封面图转换为 _doc 临时文件路径，支持 uni.uploadFile 直接上传。
• 精美 UI：采用专业蓝色系科技感设计，内置骨架屏加载状态。
• 暗黑模式：完美适配系统暗黑主题，视效统一。
• 纯净代码：基于 Vue3 Options API，无任何第三方插件依赖，轻量化部署。

🛠️ 使用指南

1. 引入插件

本插件符合 uni_modules 规范，下载后直接放入项目根目录的 uni_modules 文件夹即可，无需手动 import。

2. 基本用法

<template>
<view>
<muzi-video-cover @confirm="onVideoReady" />
</view>
</template>

<script>
export default {
methods: {
onVideoReady(res) {
console.log('视频元数据：', res);
// res 包含以下字段：
// cover: "data:image/jpeg;base64,…" (用于预览)
// tempFilePath: "_doc/uniapp_temp/…" (用于上传)
// width: 视频宽度
// height: 视频高度
// size: 视频大小(Byte)
// duration: 视频时长(s)

// 示例：执行上传
uni.uploadFile({
url: '你的上传接口',
filePath: res.tempFilePath,
name: 'file',
success: (uploadRes) => {
uni.showToast({ title: '封面上传成功' });
}
});
}
}
}
</script>

📋 API 说明

事件 (Events)

返回参数详情 (Result Object)

⚠️ 注意事项

• iOS: NSPhotoLibraryUsageDescription
• Android: android.permission.READ_EXTERNAL_STORAGE

🤝 联系与反馈

如果您在使用过程中有任何问题，欢迎在插件市场评价区留言。 兄弟们开发不易，给个好评呗！