@capgo/capacitor-video-thumbnails

中文文档
8.1.25发布于 2026/10/15MPL-2.0TypeScriptESM + CJS零依赖构建来源已验证近 30 天下载 4.1万

从本地或远程视频文件生成视频缩略图

中文使用文档
文档目录13 节
  1. *免费开始*
  2. 主要特点
  3. 为什么是Capacitor视频缩略图?
  4. 文档
  5. 兼容性
  6. 安装
  7. 所需资源
  8. API 密码
  9. 获取通布尼尔(...)
  10. 获取 PluginVersion ()
  11. 接口
  12. 类型异名
  13. 贷项

@ capgo/ 电容器- 视频- thumbnails

在您的 Capacitor app 中创建本地或远程视频中的缩略图图像, 用于画廊、 上传预览和视频列表 .

Capgo - Build Capacitor apps with AI, ship updates instantly

队长:在几分钟内将修正推给您的 Capacitor 用户,在没有Mac的情况下构建已签名的iOS和Android apps,并在一击中回滚.

*免费开始*

14天无限自由审判. 不需要信用卡

🤖 建筑与AI编码代理? 安装 Capgo 技能 所以克劳德代码,代码,光标,副驾驶,或双子座CLI知道如何安装和使用 @capgo/capacitor-video-thumbnails 在您的电容应用程序中: npx skills add Cap-go/capgo-skills。然后问你的经纪人: 将@capgo/capor-video-thumbnails 添加到我的Capacitor app上并把它接上 代理设置指南 • 妇女 主机磁共振

@capgo/capacitor-video-thumbnails for Capacitor apps

主要特点

  • 一通电话数字 : getThumbnail() 返回视频框架的图像.
  • 选框数字 : time 设置以毫秒为单位的位置.
  • 质量: 设定图像 quality。 。 。 .
  • 远程视频: 通过 HTTP headers 用于iOS和Android上受保护的URL.
  • 平台:iOS,Android和Web. iOS使用AVFoundation,Android 使用 MediaMetadataRetriever,网页使用视频元素和画布.

为什么是Capacitor视频缩略图?

在特定时间位置从视频中提取缩略图图像 :

  • 本地远程视频( R) - 对文件://路径和http(s)://进行工作 URL( URL)
  • 自定义时间位置 - 在任何毫秒印出框架
  • 质量控制 - 可调整的JPEG压缩质量
  • HTTP 信头支持 - 认证视频来源的自定义信头
  • 跨平台 - 一致的API跨iOS,Android,和Web

适合视频画廊,媒体播放器,视频编辑,以及任何需要视频预览图像的应用程序.

文档

这里有最完整的医生: https://capgo.app/docs/plugins/video-thumbnails/ (中文(简体) )

兼容性

插件版本电容兼容性维护
联合国联合国✅
页:1页:1应要求
页:1页:1❌
页:1页:1❌

说明: 此插件的主要版本沿用了Capacitor的主要版本. 使用匹配您的 Capacitor 安装的版本( 如 Capacitor 8 的插件 v8) 。 只有最新的主要版本得到积极维护.

安装

您可以使用我们的 AI 辅助设置安装插件 。 使用以下命令将 Capgo 技能添加到您的 AI 工具 :

npx skills add https://github.com/cap-go/capacitor-skills --skill capacitor-plugins

然后使用下列提示:

Use the `capacitor-plugins` skill from `cap-go/capacitor-skills` to install the `@capgo/capacitor-video-thumbnails` plugin in my project.

如果您更喜欢手动设置,请通过运行以下命令来安装插件,并遵循下面的平台特定指令:

npm install @capgo/capacitor-video-thumbnails
npx cap sync

所需资源

  • iOS: iOS 15.0+ (英语)
  • Android:API 24+ (Android 7.0+) (英语)
  • Web: HTML5 视频支持的现代浏览器

API 密码

Capacitor 视频缩略图插件接口用于生成视频缩略图.

获取通布尼尔(...)

getThumbnail(options: VideoThumbnailsOptions) => Promise<VideoThumbnailsResult>

在特定时间位置从视频文件中生成缩略图图像 .

参数类型说明
optionsVideoThumbnailsOptions- 生成缩略图的选项

回返情况: Promise<VideoThumbnailsResult>

自: 8.0.0 (单位:千美元)


获取 PluginVersion ()

getPluginVersion() => Promise<{ version: string; }>

获取本地 Capacitor 插件版本 .

回返情况: Promise<{ version: string; }>

自: 8.0.0 (单位:千美元)


接口

视频垃圾桶

缩略图生成的结果.

Prop类型说明
uristring生成缩略图图像的本地 URI 路径 。 这可以直接用于img标记或Image组件.
widthnumber生成的缩略图以像素表示的宽度 .
heightnumber生成的缩略图在像素中的高度 .

VideoThumbnails 选项

生成视频缩略图的选项 .

Prop类型说明
sourceUristring视频文件的URI. 可以是本地文件路径或远程 URL 。 对于本地文件,使用文件://协议或绝对路径. 对于远程文件,请使用http://或https://协议.
timenumber以毫秒为单位的取出缩略图的时间位置 。 默认为 0 (第一帧) .
qualitynumber生成图像的质量,从0.0(最低)到1.0(最高). 默认为1.0.
headersRecord<string, string>获取远程视频 URI时包含 HTTP 头条 。 仅适用于远程 URL .

类型异名

记录

构造 T 类型 K 的一组属性类型

{ [P in K]: T; }

贷项

这是来自(Expo SDK)[https://docs.expo.dev/versions/latest/sdk/video-thumbnails/ 页面存档备份,存于互联网档案馆[ . ]

版本与发布记录

@capgo/capacitor-video-thumbnails 共发布 25 个版本,首次发布于 2026/01/05;过去 12 个月发布了 25 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
8.1.25latest2026/10/1525 天前
8.1.242026/10/1327 天前
8.1.232026/10/091 个月前
8.1.212026/10/081 个月前
8.1.222026/10/081 个月前
8.1.202026/09/161 个月前

关于 @capgo/capacitor-video-thumbnails 的常见问题

@capgo/capacitor-video-thumbnails 是什么?

从本地或远程视频文件生成视频缩略图

如何安装 @capgo/capacitor-video-thumbnails?

在项目目录运行 npm install @capgo/capacitor-video-thumbnails,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@capacitor/core(>=8.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@capgo/capacitor-video-thumbnails 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@capgo/capacitor-video-thumbnails 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@capgo/capacitor-video-thumbnails 可以商用吗?

@capgo/capacitor-video-thumbnails 使用 MPL-2.0 许可。弱 Copyleft:可以商用,也可以和闭源代码一起使用;但如果分发时修改了 MPL 授权的文件,这些文件的修改需以 MPL 开源。以上为概括,不构成法律意见,请以许可原文为准。

@capgo/capacitor-video-thumbnails 的下载量有多少?

根据 npm 官方下载统计,@capgo/capacitor-video-thumbnails 在 2026/10/09 – 2026/11/07 这 30 天内被下载 41,161 次,日均约 1,372 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@capgo/capacitor-video-thumbnails 还在维护吗?

最新版本 8.1.25 发布于 2026/10/15(25 天前);至今共发布 25 个版本,其中过去 12 个月发布了 25 个;首次发布于 2026/01/05。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。