@capacitor-mlkit/translation

中文文档
8.2.2发布于 2026/10/31Apache-2.0TypeScriptESM + CJS零依赖构建来源已验证近 30 天下载 7082

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

中文使用文档
文档目录31 节
  1. 使用大小写
  2. 兼容性
  3. 安装
  4. 机器人
  5. iOS系统
  6. 配置
  7. 演示
  8. 使用量
  9. 翻译文本
  10. 下载语言模型
  11. 列出已下载的语言模式
  12. 删除已下载的语言模式
  13. API 密码
  14. 删除已下载的模型(...)
  15. 下载模式(...)
  16. 获得下载模式( C)
  17. 翻译(...)
  18. 接口
  19. 数字
  20. 财务问题
  21. 此插件支持哪些平台 ?
  22. 支持哪些语言?
  23. 翻译工作离线吗?
  24. 语言模型需要多少存储量?
  25. 如果我不知道文字的来源语言呢?
  26. 我能使用 Swift 包管理器安装这个插件吗 ?
  27. 相关插件
  28. 术语和隐私
  29. 通讯
  30. 更改日志
  31. 许可证

ML Kit 翻译插件

非官方电容插件 ML Kit 翻译[^1]

使用大小写

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

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

兼容性

插件版本电容版本状态
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 辅助设置 以安装插件. 添加数据 超级技能 至您的 AI 工具,使用以下命令:

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.

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

npm install @capacitor-mlkit/translation
npx cap sync

请注意: 此插件 只支持可口可乐Pods iOS的依赖性管理。 Swift 软件包管理器( SPM) 不支持 ML Kit SDK, 参见 本评论。 。 。 .

机器人

变量

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

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

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

iOS系统

最低部署目标

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

platform :ios, '15.5'

配置

此插件不需要配置 .

演示

这里有一个实例: robingenz/电容-mlkit-plugin-demo

使用量

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

翻译文本

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

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上提供:

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

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

列出已下载的语言模式

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

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

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

删除已下载的语言模式

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

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

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

API 密码

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

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

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

仅在Android和iOS上提供.

参数类型
optionsDeleteDownloadedModelOptions

自: 0.0.1 资源


下载模式(...)

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

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

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

仅在Android和iOS上提供.

参数类型
optionsDownloadModel

自: 0.0.1 资源


获得下载模式( C)

getDownloadedModels() => Promise<GetDownloadedModelsResult>

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

仅在Android和iOS上提供.

回返情况: Promise<GetDownloadedModelsResult>

自: 0.0.1 资源


翻译(...)

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

翻译给定的文字.

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

仅在Android和iOS上提供.

参数类型
optionsTranslateOptions

回返情况: Promise<TranslateResult>

自: 0.0.1 资源


接口

删除已下载的模式选项

Prop类型说明自兹
languageLanguage用于删除模型的语言 .0.0.1 资源

下载模式

Prop类型说明自兹
languageLanguage用于下载模型的语言.0.0.1 资源

下载模型

Prop类型说明
languagesLanguage[]已下载模型所用的语言 .

翻译结果

Prop类型说明自兹
textstring所译文字.0.0.1 资源

翻译选项

Prop类型说明自兹
textstring译出之文.0.0.1 资源
sourceLanguageLanguage出文之源语言. 如果你不知道源语言,你可以使用 Language</a> Identification 检测它的插件 .0.0.1 资源
targetLanguageLanguage将文本翻译为的目标语言 .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 密码 区域.

翻译工作离线吗?

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

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

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

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

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

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

不,这个插件只支持CocoaPods用于iOS依赖性管理,因为ML Kit SDK本身不支持Swift包管理器. 确定部署目标 ios/App/Podfile 至少改为 15.5 (见 安装) (中文(简体) ).

  • 语音识别:将语音转换为文本,例如之后将其翻译.
  • 综合发言:从文本中合成语音,例如可以高声读取翻译的文本.
  • App 语言:管理应用程序自己的语言覆盖,独立于设备语言.
  • ML Kit实体提取器: 从文本翻译前或翻译后提取地址和日期等实体.

术语和隐私

此插件使用 Google ML Kit (Google ML Kit) 页面存档备份,存于互联网档案馆数字 :

通讯

随时更新有关卡帕韦索姆、Capacitor和Ionic生态系统的最新消息和最新消息,因为我们 《卡帕索克通讯》。 。 。 .

更改日志

见 变动情况。 。 。 .

许可证

见 自由主义。 。 。 .

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

版本与发布记录

@capacitor-mlkit/translation 共发布 34 个版本,首次发布于 2023/02/25;过去 12 个月发布了 9 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
8.2.2latest2026/10/319 天前
8.2.12026/09/101 个月前
8.1.12026/08/312 个月前
8.1.02026/05/076 个月前
8.0.12026/02/198 个月前
8.0.02025/12/1710 个月前

其他发布通道:next → 7.0.0-next.4,dev → 7.0.0-dev.1765885034。

关于 @capacitor-mlkit/translation 的常见问题

@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 和提交记录判断。