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上提供.
| 参数 | 类型 |
|---|---|
options | DeleteDownloadedModelOptions |
自: 0.0.1 资源
下载模式(...)
downloadModel(options: DownloadModel) => Promise<void>
下载离线翻译的语言模型 .
语言模型大小在 30MB 左右, 所以确定只下载所需的模型 除非用户另有说明,否则只能使用WiFi连接下载.
仅在Android和iOS上提供.
| 参数 | 类型 |
|---|---|
options | DownloadModel |
自: 0.0.1 资源
获得下载模式( C)
getDownloadedModels() => Promise<GetDownloadedModelsResult>
获取一个模型被下载的语言 .
仅在Android和iOS上提供.
回返情况: Promise<GetDownloadedModelsResult>
自: 0.0.1 资源
翻译(...)
translate(options: TranslateOptions) => Promise<TranslateResult>
翻译给定的文字.
如果不下载给定源和目标语言的语言模型,
将自动下载,这可能需要一些时间.
如果你想避免这种情况,请使用 downloadModel(...) 首先下载模型的方法.
仅在Android和iOS上提供.
| 参数 | 类型 |
|---|---|
options | TranslateOptions |
回返情况: Promise<TranslateResult>
自: 0.0.1 资源
接口
删除已下载的模式选项
| Prop | 类型 | 说明 | 自兹 |
|---|---|---|---|
language | Language | 用于删除模型的语言 . | 0.0.1 资源 |
下载模式
| Prop | 类型 | 说明 | 自兹 |
|---|---|---|---|
language | Language | 用于下载模型的语言. | 0.0.1 资源 |
下载模型
| Prop | 类型 | 说明 |
|---|---|---|
languages | Language[] | 已下载模型所用的语言 . |
翻译结果
| Prop | 类型 | 说明 | 自兹 |
|---|---|---|---|
text | string | 所译文字. | 0.0.1 资源 |
翻译选项
| Prop | 类型 | 说明 | 自兹 |
|---|---|---|---|
text | string | 译出之文. | 0.0.1 资源 |
sourceLanguage | Language | 出文之源语言. 如果你不知道源语言,你可以使用 Language</a> Identification 检测它的插件 . | 0.0.1 资源 |
targetLanguage | 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 密码 区域.
翻译工作离线吗?
是的,翻译使用下载的语言模型在设备上进行。 使用 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或其任何子公司或子公司,也不获得其认可、支持、赞助或批准.