# @capacitor-mlkit/translation 中文文档

规范地址：https://npmcn.com/package/%40capacitor-mlkit/translation/

版本：8\.2\.2
npm 元数据更新时间：2026-10-31T07:04:15.915Z
中文译文更新时间：2026-11-09T05:28:32.472Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40capacitor-mlkit/translation
原文对照：https://npmcn.com/package/%40capacitor-mlkit/translation/?lang=original
项目主页：https://capawesome.io/docs/sdks/capacitor/mlkit/translation/
源码仓库：https://github.com/capawesome-team/capacitor-mlkit

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

- 包体积（解压后）：125 kB，32 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：@capacitor/core \>=8\.0\.0
- 首次发布：2023-02-25T08:11:28.036Z
- 最新版本发布：2026-10-31T07:04:15.533Z
- 近 30 天下载量：7082（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：34（近 12 个月 9 个）

## 中文简介

Android和iOS上的ML Kit翻译的电容插件.

## 安装

```sh
npm install @capacitor-mlkit/translation
```

也可以使用：`pnpm add @capacitor-mlkit/translation`、`yarn add @capacitor-mlkit/translation`、`bun add @capacitor-mlkit/translation`

## README

# ML Kit 翻译插件

非官方电容插件 [ML Kit 翻译](https://developers.google.com/ml-kit/language/translation)\[^1\]

[![Ship a fix in one command with Capawesome Cloud Live Updates, no store review](https://capawesome.io/assets/banners/cloud-ship-a-fix-in-one-command.png)](https://capawesome.io/)

## 使用大小写

翻译插件通常用于直接翻译设备上的文本,例如:

-   **聊天翻译**:将收到的信件翻译为用户语言.
-   **内容翻译**:让用户翻译用户生成的内容,如评论,评论或帖子.
-   **离线翻译**:提前下载语言模型,这样用户就可以在没有互联网连接的情况下翻译文本.
-   **旅行应用程序**:帮助行人翻译行走时的文字,即使漫游时没有数据连接.

## 兼容性

| 插件版本 | 电容版本 | 状态 |
| --- | --- | --- |
| 8.x.x (英语) | \>=8.x.x | 积极支持 |
| 7.x.x (中文(简体) ) | 7.x.x (中文(简体) ) | 折旧 |
| 6.x.x (中文(简体) ) | 6.x.x (中文(简体) ) | 折旧 |
| 5.x.x (中文(简体) ) | 5.x.x (中文(简体) ) | 折旧 |

## 安装

你可以用我们的 **AI 辅助设置** 以安装插件. 添加数据 [超级技能](https://github.com/capawesome-team/skills) 至您的 AI 工具,使用以下命令:

```bash
npx skills add capawesome-team/skills --skill capacitor-plugins
```

然后使用下列提示:

```
Use the `capacitor-plugins` skill from `capawesome-team/skills` to install the `@capacitor-mlkit/translation` plugin in my project.
```

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

```bash
npm install @capacitor-mlkit/translation
npx cap sync
```

**请注意**: 此插件 **只支持可口可乐Pods** iOS的依赖性管理。 Swift 软件包管理器( SPM) 不支持 ML Kit SDK, 参见 [本评论](https://github.com/googlesamples/mlkit/issues/180#issuecomment-1298964099)。 。 。 .

### 机器人

#### 变量

如果需要, 您可以在您的应用程序中定义以下工程变量 `variables.gradle` 要更改依赖的默认版本的文件 :

-   `$mlkitTranslateVersion` 版本 `com.google.mlkit:translate` (默认 : `17.0.3`(中文(简体) )

如果您在工程中遇到其它插件的依赖性冲突, 这会有所帮助 .

### iOS系统

#### 最低部署目标

确定部署目标 `ios/App/Podfile` 至少改为 `15.5`数字 :

```ruby
platform :ios, '15.5'
```

## 配置

此插件不需要配置 .

## 演示

这里有一个实例: [robingenz/电容-mlkit-plugin-demo](https://github.com/robingenz/capacitor-mlkit-plugin-demo)

## 使用量

以下例子显示如何翻译文本,下载语言模型,列出已下载语言模型,并删除已下载语言模型.

### 翻译文本

使用 `translate(...)` 将文本从源语言翻译为目标语言的方法。 如果给定语言的语言模型尚未下载,将自动下载,这可能需要一些时间. 仅在Android和iOS上提供:

```typescript
import { Translation, Language } from '@capacitor-mlkit/translation';

const translate = async () => {
  const { text } = await Translation.translate({
    text: 'Good morning!',
    sourceLanguage: Language.English,
    targetLanguage: Language.German,
  });
  return text;
};
```

### 下载语言模型

提前下载一个语言模型,以便进行离线翻译。 语言模型大小在30MB左右,所以要确定只下载需要的模型,并且只使用WiFi连接来下载,除非用户另有说明. 仅在Android和iOS上提供:

```typescript
import { Translation, Language } from '@capacitor-mlkit/translation';

const downloadModel = async () => {
  await Translation.downloadModel({
    language: Language.English,
  });
};
```

### 列出已下载的语言模式

获取一个模型已经下载到设备的语言 。 仅在Android和iOS上提供:

```typescript
import { Translation } from '@capacitor-mlkit/translation';

const getDownloadedModels = async () => {
  const { languages } = await Translation.getDownloadedModels();
  return languages;
};
```

### 删除已下载的语言模式

删除特定语言的语言模型,例如可以腾出设备上的存储空间. 仅在Android和iOS上提供:

```typescript
import { Translation, Language } from '@capacitor-mlkit/translation';

const deleteDownloadedModel = async () => {
  await Translation.deleteDownloadedModel({
    language: Language.English,
  });
};
```

## API 密码

-   [`deleteDownloadedModel(...)`](https://npmcn.com/package/%40capacitor-mlkit/translation/#readme-deletedownloadedmodel)
-   [`downloadModel(...)`](https://npmcn.com/package/%40capacitor-mlkit/translation/#readme-downloadmodel)
-   [`getDownloadedModels()`](https://npmcn.com/package/%40capacitor-mlkit/translation/#readme-getdownloadedmodels)
-   [`translate(...)`](https://npmcn.com/package/%40capacitor-mlkit/translation/#readme-translate)
-   [接口](https://npmcn.com/package/%40capacitor-mlkit/translation/#readme-interfaces)
-   [数字](https://npmcn.com/package/%40capacitor-mlkit/translation/#readme-enums)

### 删除已下载的模型(...)

```typescript
deleteDownloadedModel(options: DeleteDownloadedModelOptions) => Promise<void>
```

删除给定语言的语言模型.

仅在Android和iOS上提供.

| 参数 | 类型 |
| --- | --- |
| **`options`** | `[DeleteDownloadedModelOptions](https://npmcn.com/package/%40capacitor-mlkit/translation/#readme-deletedownloadedmodeloptions)` |

**自:** 0.0.1 资源

* * *

### 下载模式(...)

```typescript
downloadModel(options: DownloadModel) => Promise<void>
```

下载离线翻译的语言模型 .

语言模型大小在 30MB 左右, 所以确定只下载所需的模型 除非用户另有说明,否则只能使用WiFi连接下载.

仅在Android和iOS上提供.

| 参数 | 类型 |
| --- | --- |
| **`options`** | `[DownloadModel](https://npmcn.com/package/%40capacitor-mlkit/translation/#readme-downloadmodel)` |

**自:** 0.0.1 资源

* * *

### 获得下载模式( C)

```typescript
getDownloadedModels() => Promise<GetDownloadedModelsResult>
```

获取一个模型被下载的语言 .

仅在Android和iOS上提供.

**回返情况:** `Promise<[GetDownloadedModelsResult](https://npmcn.com/package/%40capacitor-mlkit/translation/#readme-getdownloadedmodelsresult)>`

**自:** 0.0.1 资源

* * *

### 翻译(...)

```typescript
translate(options: TranslateOptions) => Promise<TranslateResult>
```

翻译给定的文字.

如果不下载给定源和目标语言的语言模型, 将自动下载,这可能需要一些时间. 如果你想避免这种情况,请使用 `downloadModel(...)` 首先下载模型的方法.

仅在Android和iOS上提供.

| 参数 | 类型 |
| --- | --- |
| **`options`** | `[TranslateOptions](https://npmcn.com/package/%40capacitor-mlkit/translation/#readme-translateoptions)` |

**回返情况:** `Promise<[TranslateResult](https://npmcn.com/package/%40capacitor-mlkit/translation/#readme-translateresult)>`

**自:** 0.0.1 资源

* * *

### 接口

#### 删除已下载的模式选项

| Prop | 类型 | 说明 | 自兹 |
| --- | --- | --- | --- |
| **`language`** | `[Language](https://npmcn.com/package/%40capacitor-mlkit/translation/#readme-language)` | 用于删除模型的语言 . | 0.0.1 资源 |

#### 下载模式

| Prop | 类型 | 说明 | 自兹 |
| --- | --- | --- | --- |
| **`language`** | `[Language](https://npmcn.com/package/%40capacitor-mlkit/translation/#readme-language)` | 用于下载模型的语言. | 0.0.1 资源 |

#### 下载模型

| Prop | 类型 | 说明 |
| --- | --- | --- |
| **`languages`** | `Language[]` | 已下载模型所用的语言 . |

#### 翻译结果

| Prop | 类型 | 说明 | 自兹 |
| --- | --- | --- | --- |
| **`text`** | `string` | 所译文字. | 0.0.1 资源 |

#### 翻译选项

| Prop | 类型 | 说明 | 自兹 |
| --- | --- | --- | --- |
| **`text`** | `string` | 译出之文. | 0.0.1 资源 |
| **`sourceLanguage`** | `[Language](https://npmcn.com/package/%40capacitor-mlkit/translation/#readme-language)` | 出文之源语言. 如果你不知道源语言,你可以使用 [`Language</a> Identification` 检测它的插件 .](https://npmcn.com/package/%40capacitor-mlkit/translation/#readme-language) | 0.0.1 资源 |
| **`targetLanguage`** | `[Language](https://npmcn.com/package/%40capacitor-mlkit/translation/#readme-language)` | 将文本翻译为的目标语言 . | 0.0.1 资源 |

### 数字

#### 语言

| 成员 | 数值 | 自兹 |
| --- | --- | --- |
| **`Afrikaans`** | `'af'` | 0.0.1 资源 |
| **`Arabic`** | `'ar'` | 0.0.1 资源 |
| **`Belarusian`** | `'be'` | 0.0.1 资源 |
| **`Bulgarian`** | `'bg'` | 0.0.1 资源 |
| **`Bengali`** | `'bn'` | 0.0.1 资源 |
| **`Catalan`** | `'ca'` | 0.0.1 资源 |
| **`Czech`** | `'cs'` | 0.0.1 资源 |
| **`Welsh`** | `'cy'` | 0.0.1 资源 |
| **`Danish`** | `'da'` | 0.0.1 资源 |
| **`German`** | `'de'` | 0.0.1 资源 |
| **`Greek`** | `'el'` | 0.0.1 资源 |
| **`English`** | `'en'` | 0.0.1 资源 |
| **`Esperanto`** | `'eo'` | 0.0.1 资源 |
| **`Spanish`** | `'es'` | 0.0.1 资源 |
| **`Estonian`** | `'et'` | 0.0.1 资源 |
| **`Persian`** | `'fa'` | 0.0.1 资源 |
| **`Finnish`** | `'fi'` | 0.0.1 资源 |
| **`French`** | `'fr'` | 0.0.1 资源 |
| **`Irish`** | `'ga'` | 0.0.1 资源 |
| **`Galician`** | `'gl'` | 0.0.1 资源 |
| **`Gujarati`** | `'gu'` | 0.0.1 资源 |
| **`Hebrew`** | `'he'` | 0.0.1 资源 |
| **`Hindi`** | `'hi'` | 0.0.1 资源 |
| **`Croatian`** | `'hr'` | 0.0.1 资源 |
| **`Haitian`** | `'ht'` | 0.0.1 资源 |
| **`Hungarian`** | `'hu'` | 0.0.1 资源 |
| **`Indonesian`** | `'id'` | 0.0.1 资源 |
| **`Icelandic`** | `'is'` | 0.0.1 资源 |
| **`Italian`** | `'it'` | 0.0.1 资源 |
| **`Japanese`** | `'ja'` | 0.0.1 资源 |
| **`Georgian`** | `'ka'` | 0.0.1 资源 |
| **`Kannada`** | `'kn'` | 0.0.1 资源 |
| **`Korean`** | `'ko'` | 0.0.1 资源 |
| **`Lithuanian`** | `'lt'` | 0.0.1 资源 |
| **`Latvian`** | `'lv'` | 0.0.1 资源 |
| **`Macedonian`** | `'mk'` | 0.0.1 资源 |
| **`Marathi`** | `'mr'` | 0.0.1 资源 |
| **`Malay`** | `'ms'` | 0.0.1 资源 |
| **`Maltese`** | `'mt'` | 0.0.1 资源 |
| **`Dutch`** | `'nl'` | 0.0.1 资源 |
| **`Norwegian`** | `'no'` | 0.0.1 资源 |
| **`Polish`** | `'pl'` | 0.0.1 资源 |
| **`Portuguese`** | `'pt'` | 0.0.1 资源 |
| **`Romanian`** | `'ro'` | 0.0.1 资源 |
| **`Russian`** | `'ru'` | 0.0.1 资源 |
| **`Slovak`** | `'sk'` | 0.0.1 资源 |
| **`Slovenian`** | `'sl'` | 0.0.1 资源 |
| **`Albanian`** | `'sq'` | 0.0.1 资源 |
| **`Swedish`** | `'sv'` | 0.0.1 资源 |
| **`Swahili`** | `'sw'` | 0.0.1 资源 |
| **`Tamil`** | `'ta'` | 0.0.1 资源 |
| **`Telugu`** | `'te'` | 0.0.1 资源 |
| **`Thai`** | `'th'` | 0.0.1 资源 |
| **`Tagalog`** | `'tl'` | 0.0.1 资源 |
| **`Turkish`** | `'tr'` | 0.0.1 资源 |
| **`Ukrainian`** | `'uk'` | 0.0.1 资源 |
| **`Urdu`** | `'ur'` | 0.0.1 资源 |
| **`Vietnamese`** | `'vi'` | 0.0.1 资源 |
| **`Chinese`** | `'zh'` | 0.0.1 资源 |

## 财务问题

### 此插件支持哪些平台 ?

插件可以在Android和iOS上找到. 所有方法都只能在Android和iOS上使用,因此没有网络执行.

### 支持哪些语言?

该插件支持英语,德语,西班牙语,法语,汉语,日语等50多种语言. 见 `Language` 语句 [API 密码](https://npmcn.com/package/%40capacitor-mlkit/translation/#readme-api) 区域.

### 翻译工作离线吗?

是的,翻译使用下载的语言模型在设备上进行。 使用 `downloadModel(...)` 预先下载语言模型的方法,例如当设备连接到WiFi网络时。 否则,该模型在第一次呼叫时自动下载到 `translate(...)`,这可能需要一些时间.

### 语言模型需要多少存储量?

语言模型大小在30MB左右,所以确定只下载需要的模型. 您可以删除不再需要的模型 `deleteDownloadedModel(...)` 方法.

### 如果我不知道文字的来源语言呢?

这个 `translate(...)` 方法需要源语言。 您可以使用 ML Kit 语言识别插件在翻译前检测文本的语言.

### 我能使用 Swift 包管理器安装这个插件吗 ?

不,这个插件只支持CocoaPods用于iOS依赖性管理,因为ML Kit SDK本身不支持Swift包管理器. 确定部署目标 `ios/App/Podfile` 至少改为 `15.5` (见 [安装](https://npmcn.com/package/%40capacitor-mlkit/translation/#readme-installation)) (中文(简体) ).

## 相关插件

-   [语音识别](https://capawesome.io/docs/sdks/capacitor/speech-recognition/):将语音转换为文本,例如之后将其翻译.
-   [综合发言](https://capawesome.io/docs/sdks/capacitor/speech-synthesis/):从文本中合成语音,例如可以高声读取翻译的文本.
-   [App 语言](https://capawesome.io/docs/sdks/capacitor/app-language/):管理应用程序自己的语言覆盖,独立于设备语言.
-   [ML Kit实体提取器](https://capawesome.io/docs/sdks/capacitor/mlkit/entity-extraction/): 从文本翻译前或翻译后提取地址和日期等实体.

## 术语和隐私

此插件使用 [Google ML Kit (Google ML Kit) 页面存档备份,存于互联网档案馆](https://developers.google.com/ml-kit)数字 :

-   [术语和隐私](https://developers.google.com/ml-kit/terms)
-   [Android 数据披露](https://developers.google.com/ml-kit/android-data-disclosure)
-   [iOS 数据披露](https://developers.google.com/ml-kit/ios-data-disclosure)

## 通讯

随时更新有关卡帕韦索姆、Capacitor和Ionic生态系统的最新消息和最新消息,因为我们 [《卡帕索克通讯》](https://cloud.capawesome.io/newsletter/)。 。 。 .

## 更改日志

见 [变动情况](https://github.com/capawesome-team/capacitor-mlkit/blob/main/packages/translation/CHANGELOG.md)。 。 。 .

## 许可证

见 [自由主义](https://github.com/capawesome-team/capacitor-mlkit/blob/main/packages/translation/LICENSE)。 。 。 .

\[^1\]: 这个项目不附属于Google LLC或其任何子公司或子公司,也不获得其认可、支持、赞助或批准.

## 常见问题

### @capacitor-mlkit/translation 是什么？

Android和iOS上的ML Kit翻译的电容插件\.

### 如何安装 @capacitor-mlkit/translation？

在项目目录运行 npm install @capacitor-mlkit/translation，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@capacitor/core（\>=8\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @capacitor-mlkit/translation 支持 TypeScript 吗？

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

### @capacitor-mlkit/translation 支持 ESM 还是 CommonJS？

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

### @capacitor-mlkit/translation 可以商用吗？

@capacitor-mlkit/translation 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @capacitor-mlkit/translation 的下载量有多少？

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

### @capacitor-mlkit/translation 还在维护吗？

最新版本 8\.2\.2 发布于 2026/10/31（9 天前）；至今共发布 34 个版本，其中过去 12 个月发布了 9 个；首次发布于 2023/02/25。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。