更新记录

1.0.0（2026-07-29）

1. 初版本发布，Android、iOS获取视频封面

平台兼容性

uni-app(5.12)

hy-videoPoster

视频封面抽取插件，支持从本地视频文件中截取指定时间点的一帧作为封面图片。

平台支持

API

extractVideoFrame(options)

从本地视频文件中提取指定时间点的一帧图片。

参数 (ExtractVideoFrameOptions):

成功返回 (ExtractVideoFrameResult):

错误码:

使用示例

import {
  extractVideoFrame
} from '@/uni_modules/hy-videoPoster'

const VIDEO_POSTER_TIME_MS = 0
const VIDEO_POSTER_QUALITY = 50

function extractPosterWithPlugin(videoPath) {
  if (typeof extractVideoFrame !== 'function') {
    return Promise.resolve('')
  }
  return new Promise((resolve) => {
    extractVideoFrame({
      filePath: videoPath,
      timeMs: VIDEO_POSTER_TIME_MS,
      quality: VIDEO_POSTER_QUALITY,
      success: (res) => {
        resolve(String(res?.imagePath || '').trim())
      },
      fail: () => resolve('')
    })
  })
}

开发文档

• UTS 语法
• UTS API插件
• UTS uni-app兼容模式组件
• UTS 标准模式组件
• Hello UTS