# @capacitor-mlkit/language-identification 中文文档

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

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

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

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

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

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

## 中文简介

Android和iOS上的ML Kit语言识别的Capacittor插件.

## 安装

```sh
npm install @capacitor-mlkit/language-identification
```

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

## README

# ML Kit语言识别插件

非官方电容插件 [ML Kit 语言识别](https://developers.google.com/ml-kit/language/identification)\[^1\]

[![Thousands of teams ship faster with Capawesome Cloud Native Builds and Live Updates](https://capawesome.io/assets/banners/cloud-teams-ship-faster-with-capacitor.png)](https://capawesome.io/)

## 使用大小写

语言识别插件直接确定设备上一串文字的语言,例如:

-   **本地化**: 检测用户生成内容的语言以正确显示.
-   **翻译**:在翻译文本前确定源语言.
-   **内容路由**:根据自己的语言向正确的代理或bot传递消息.
-   **智能回复**: 在生成回复建议之前, 请检查对话是否使用支持的语言 .

## 兼容性

| 插件版本 | 电容版本 | 状态 |
| --- | --- | --- |
| 8.x.x (英语) | \>=8.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/language-identification` plugin in my project.
```

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

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

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

### 机器人

#### 变量

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

-   `$mlkitLanguageIdVersion` 版本 `com.google.mlkit:language-id` (默认 : `17.0.6`(中文(简体) )

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

### iOS系统

#### 最低部署目标

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

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

## 配置

此插件不需要配置 .

## 演示

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

## 使用量

配有SDK的语言识别模型船,因此不需要模型下载.

```typescript
import { LanguageIdentification } from '@capacitor-mlkit/language-identification';

const identifyLanguage = async () => {
  const { language } = await LanguageIdentification.identifyLanguage({
    text: 'Wie geht es dir?',
  });
  // `language` is a BCP-47 tag (e.g. `de`) or `und` if no language met the threshold.
  return language;
};

const identifyPossibleLanguages = async () => {
  const { identifiedLanguages } =
    await LanguageIdentification.identifyPossibleLanguages({
      text: 'Wie geht es dir?',
    });
  return identifiedLanguages;
};
```

返回的语言是 [BCP-47 语言标记](https://en.wikipedia.org/wiki/IETF_language_tag) 例如 `en`, (中文(简体) ), `de` 或者说 `zh`。如果没有足够自信地识别语言,价值 `und` (未确定)将返回.

## API 密码

-   [`identifyLanguage(...)`](https://npmcn.com/package/%40capacitor-mlkit/language-identification/#readme-identifylanguage)
-   [`identifyPossibleLanguages(...)`](https://npmcn.com/package/%40capacitor-mlkit/language-identification/#readme-identifypossiblelanguages)
-   [接口](https://npmcn.com/package/%40capacitor-mlkit/language-identification/#readme-interfaces)

### 识别语言(...)

```typescript
identifyLanguage(options: IdentifyLanguageOptions) => Promise<IdentifyLanguageResult>
```

确定给定文本中最可能的语言.

仅在Android和iOS上提供.

| 参数 | 类型 |
| --- | --- |
| **`options`** | `[IdentifyLanguageOptions](https://npmcn.com/package/%40capacitor-mlkit/language-identification/#readme-identifylanguageoptions)` |

**回返情况:** `Promise<[IdentifyLanguageResult](https://npmcn.com/package/%40capacitor-mlkit/language-identification/#readme-identifylanguageresult)>`

**自:** 8.2.0 (中文(简体) )

* * *

### 识别可能语言(...)

```typescript
identifyPossibleLanguages(options: IdentifyPossibleLanguagesOptions) => Promise<IdentifyPossibleLanguagesResult>
```

自信地确定特定文本的所有可能语文.

仅在Android和iOS上提供.

| 参数 | 类型 |
| --- | --- |
| **`options`** | `[IdentifyPossibleLanguagesOptions](https://npmcn.com/package/%40capacitor-mlkit/language-identification/#readme-identifypossiblelanguagesoptions)` |

**回返情况:** `Promise<[IdentifyPossibleLanguagesResult](https://npmcn.com/package/%40capacitor-mlkit/language-identification/#readme-identifypossiblelanguagesresult)>`

**自:** 8.2.0 (中文(简体) )

* * *

### 接口

#### 识别语言

| Prop | 类型 | 说明 | 自兹 |
| --- | --- | --- | --- |
| **`language`** | `string` | 最可能语言的BCP-47语言标记. 值为 `'und'` (未确定) 如果没有语言达到信任阈值. | 8.2.0 (中文(简体) ) |

#### 识别语言选项

| Prop | 类型 | 说明 | 默认 | 自兹 |
| --- | --- | --- | --- | --- |
| **`text`** | `string` | 文字以辨所用语言. |  | 8.2.0 (中文(简体) ) |
| **`confidenceThreshold`** | `number` | 信心阈值( C)`0.0` 改为 `1.0`一种语言必须满足才能返回。 如果没有语言达到阈值 `language` 将会是 `'und'` (未定). | `0.5` | 8.2.0 (中文(简体) ) |

#### 识别可能语言

| Prop | 类型 | 说明 | 自兹 |
| --- | --- | --- | --- |
| **`identifiedLanguages`** | `IdentifiedLanguage[]` | 以信心下降来命令识别语言。 数组包含一个带有语言的条目 `'und'` (未确定) 如果没有语言达到信任阈值. | 8.2.0 (中文(简体) ) |

#### 识别语言

| Prop | 类型 | 说明 | 自兹 |
| --- | --- | --- | --- |
| **`language`** | `string` | 被识别语言的BCP-47语言标记. | 8.2.0 (中文(简体) ) |
| **`confidence`** | `number` | 信心(`0.0` 改为 `1.0`(a) 确定的语言. | 8.2.0 (中文(简体) ) |

#### 识别可能语言选项

| Prop | 类型 | 说明 | 默认 | 自兹 |
| --- | --- | --- | --- | --- |
| **`text`** | `string` | 用于识别语言的文本. |  | 8.2.0 (中文(简体) ) |
| **`confidenceThreshold`** | `number` | 信心阈值( C)`0.0` 改为 `1.0`一种语言必须满足才能返回. | `0.01` | 8.2.0 (中文(简体) ) |

## 财务问题

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

插件可以在Android和iOS上找到. 这个 `identifyLanguage(...)` 财务报告和审定财务报表 `identifyPossibleLanguages(...)` 方法只在Android和iOS上可用,因此没有网络执行.

### 支持哪些语言?

模型可以识别 [100种以上语言](https://developers.google.com/ml-kit/language/identification/langid-support)。返回的值是一个BCP-47语言标记.

### 怎么样 `und` 是吗?

`und` 代表着 _未确定_。当无法识别超过所配置阈值的语句时返回.

### 我需要下载一个模型吗?

没有 语言识别模型与SDK相捆绑,因此不需要模型下载或管理.

### 我怎么能改变信心门槛?

两种方法都接受可选 `confidenceThreshold` (介于 `0.0` 财务报告和审定财务报表 `1.0`) (中文(简体) ). 默认是 `0.5` 页:1 `identifyLanguage(...)` 财务报告和审定财务报表 `0.01` 页:1 `identifyPossibleLanguages(...)`。 。 。 .

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

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

## 相关插件

-   [翻译](https://capawesome.io/docs/sdks/capacitor/mlkit/translation/): 一旦其语言被确定,就翻译出文本.
-   [智能回复](https://capawesome.io/docs/sdks/capacitor/mlkit/smart-reply/): 生成对话的回复建议.
-   [ML Kit 数字墨水识别](https://capawesome.io/docs/sdks/capacitor/mlkit/digital-ink-recognition/):识别笔迹,然后识别被识别文本的语言.
-   [GenAI 语音识别](https://capawesome.io/docs/sdks/capacitor/mlkit/genai-speech-recognition/):转录口语,再识别笔录的语言.

## 术语和隐私

此插件使用 [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/language-identification/CHANGELOG.md)。 。 。 .

## 许可证

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

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

## 常见问题

### @capacitor-mlkit/language-identification 是什么？

Android和iOS上的ML Kit语言识别的Capacittor插件\.

### 如何安装 @capacitor-mlkit/language-identification？

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

### @capacitor-mlkit/language-identification 支持 TypeScript 吗？

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

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

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

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

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

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

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

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

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