# @capgo/capacitor-video-thumbnails 中文文档

规范地址：https://npmcn.com/package/%40capgo/capacitor-video-thumbnails/

版本：8\.1\.25
npm 元数据更新时间：2026-10-15T03:43:05.061Z
中文译文更新时间：2026-11-09T03:57:23.871Z
软件包许可：MPL-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40capgo/capacitor-video-thumbnails
原文对照：https://npmcn.com/package/%40capgo/capacitor-video-thumbnails/?lang=original
项目主页：https://capgo.app/docs/plugins/video-thumbnails/
源码仓库：https://github.com/Cap-go/capacitor-video-thumbnails

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：73.9 kB，24 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：@capacitor/core \>=8\.0\.0
- 首次发布：2026-01-04T17:25:47.528Z
- 最新版本发布：2026-10-15T03:43:04.746Z
- 近 30 天下载量：41161（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：25（近 12 个月 25 个）

## 中文简介

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

## 安装

```sh
npm install @capgo/capacitor-video-thumbnails
```

也可以使用：`pnpm add @capgo/capacitor-video-thumbnails`、`yarn add @capgo/capacitor-video-thumbnails`、`bun add @capgo/capacitor-video-thumbnails`

## README

# @ capgo/ 电容器- 视频- thumbnails

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

[![Capgo - Build Capacitor apps with AI, ship updates instantly](https://capgo.app/readme-banner.svg?repo=Cap-go/capacitor-video-thumbnails)](https://capgo.app/?ref=plugin_video_thumbnails)

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

## [\*免费开始\*](https://capgo.app/register/?ref=plugin_video_thumbnails)

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

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

![@capgo/capacitor-video-thumbnails for Capacitor apps](https://raw.githubusercontent.com/Cap-go/capacitor-video-thumbnails/main/assets/github-social-preview.png)

## 主要特点

-   **一通电话**数字 : `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/ (中文(简体) )](https://capgo.app/docs/plugins/video-thumbnails/)

## 兼容性

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

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

## 安装

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

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

然后使用下列提示:

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

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

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

## 所需资源

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

## API 密码

-   [`getThumbnail(...)`](https://npmcn.com/package/%40capgo/capacitor-video-thumbnails/#readme-getthumbnail)
-   [`getPluginVersion()`](https://npmcn.com/package/%40capgo/capacitor-video-thumbnails/#readme-getpluginversion)
-   [接口](https://npmcn.com/package/%40capgo/capacitor-video-thumbnails/#readme-interfaces)
-   [类型异名](https://npmcn.com/package/%40capgo/capacitor-video-thumbnails/#readme-type-aliases)

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

### 获取通布尼尔(...)

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

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

| 参数 | 类型 | 说明 |
| --- | --- | --- |
| **`options`** | `[VideoThumbnailsOptions](https://npmcn.com/package/%40capgo/capacitor-video-thumbnails/#readme-videothumbnailsoptions)` | \- 生成缩略图的选项 |

**回返情况:** `Promise<[VideoThumbnailsResult](https://npmcn.com/package/%40capgo/capacitor-video-thumbnails/#readme-videothumbnailsresult)>`

**自:** 8.0.0 (单位:千美元)

* * *

### 获取 PluginVersion ()

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

获取本地 Capacitor 插件版本 .

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

**自:** 8.0.0 (单位:千美元)

* * *

### 接口

#### 视频垃圾桶

缩略图生成的结果.

| Prop | 类型 | 说明 |
| --- | --- | --- |
| **`uri`** | `string` | 生成缩略图图像的本地 URI 路径 。 这可以直接用于img标记或Image组件. |
| **`width`** | `number` | 生成的缩略图以像素表示的宽度 . |
| **`height`** | `number` | 生成的缩略图在像素中的高度 . |

#### VideoThumbnails 选项

生成视频缩略图的选项 .

| Prop | 类型 | 说明 |
| --- | --- | --- |
| **`sourceUri`** | `string` | 视频文件的URI. 可以是本地文件路径或远程 URL 。 对于本地文件,使用文件://协议或绝对路径. 对于远程文件,请使用http://或https://协议. |
| **`time`** | `number` | 以毫秒为单位的取出缩略图的时间位置 。 默认为 0 (第一帧) . |
| **`quality`** | `number` | 生成图像的质量,从0.0(最低)到1.0(最高). 默认为1.0. |
| **`headers`** | `[Record](https://npmcn.com/package/%40capgo/capacitor-video-thumbnails/#readme-record)<string, string>` | 获取远程视频 URI时包含 HTTP 头条 。 仅适用于远程 URL . |

### 类型异名

#### 记录

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

`{ [P in K]: T; }`

## 贷项

这是来自(Expo SDK)\[[https://docs.expo.dev/versions/latest/sdk/video-thumbnails/ 页面存档备份,存于互联网档案馆](https://docs.expo.dev/versions/latest/sdk/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 和提交记录判断。