更新记录

0.0.1（2025-08-21）

• init

平台兼容性

云端兼容性

uni-app(4.61)

uni-app x(4.72)

lime-video-thumb 视频缩略图插件

一个视频缩略图生成插件，用于获取视频文件的封面图或指定时间点的帧图像。支持本地视频文件。插件提供了简单易用的API，可以快速获取视频的缩略图。

文档链接

📚 插件详细文档请访问以下站点：

• 视频缩略图插件文档 - 站点1
• 视频缩略图插件文档 - 站点2
• 视频缩略图插件文档 - 站点3

安装方法

1. 在uni-app插件市场中搜索并导入lime-video-thumb
2. 导入后需要自定义基座才能运行
3. 在页面中使用相关API获取视频缩略图

代码演示

基础用法

最简单的视频缩略图获取用法，只需要提供视频文件路径即可。

// 如果是uniapp 非ts不需要引入type
import { getVideoThumb, type GetVideoThumbOptions } from '@/uni_modules/lime-video-thumb';

// 获取视频第一帧作为封面图
getVideoThumb({
  path: '/static/VID_20230101_120000.mp4',
  success: (coverPath) => {
    console.log('视频封面图路径:', coverPath);
    // 可以将coverPath设置为图片的src
    this.coverImage = coverPath;
  },
  fail: (error) => {
    console.error('获取视频封面失败:', error);
  }
// 如果是uniapp 非ts不需要 as GetVideoThumbOptions
} as GetVideoThumbOptions);

获取指定时间点的帧

可以指定获取视频中特定时间点的帧作为缩略图。

import { getVideoThumb , type GetVideoThumbOptions} from '@/uni_modules/lime-video-thumb';

// 获取视频第5秒的帧作为封面图
getVideoThumb({
  path: '/static/VID_20230101_120000.mp4',
  time: 5000, // 5000毫秒，即5秒
  success: (coverPath) => {
    console.log('视频5秒处的帧图像路径:', coverPath);
    this.coverImage = coverPath;
  },
  fail: (error) => {
    console.error('获取视频帧失败:', error);
  }
} as  GetVideoThumbOptions);

API文档

getVideoThumb 函数参数

GetVideoThumbOptions 配置选项

接口类型

/**
 * 获取视频缩略图的配置选项
 */
export type GetVideoThumbOptions = {
  /**
   * 视频文件路径
   */
  path: string;
  /**
   * 指定获取帧的时间点（单位：毫秒）
   */
  time?: number;
  /**
   * 成功回调
   */
  success?: (result: string) => void;
  /**
   * 失败回调
   */
  fail?: (error: any) => void;
  /**
   * 完成回调
   */
  complete?: (result: any) => void;
}

支持与赞赏

如果你觉得本插件解决了你的问题，可以考虑支持作者：

支付宝赞助	微信赞助