# @capacitor-mlkit/image-labeling 中文文档

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

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

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

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

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

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

## 中文简介

在Android和iOS上的ML Kit图像标签的电容插件.

## 安装

```sh
npm install @capacitor-mlkit/image-labeling
```

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

## README

# 电容 ML Kit 图像标签插件

非官方电容插件 [ML Kit 图像标签](https://developers.google.com/ml-kit/vision/image-labeling)\[^1\]

[![Try Capawesome Cloud free for 14 days — iOS builds without a Mac](https://capawesome.io/assets/banners/cloud-free-trial-capacitor-apps.png)](https://capawesome.io/)

## 使用大小写

通常在应用程序需要了解图像内容时使用图像标签插件,例如:

-   **内容分类**: 按其包含的物体、地点或活动自动标记和组织相片.
-   **无障碍**: 生成图像的描述性标签,以支持屏幕阅读器和其他辅助技术.
-   **内容节制**:在图像发布前检测某些物体或场景的存在.
-   **搜索和发现**: 使一个图像库可以根据每个图像中检测到的标签进行搜索.

## 兼容性

| 插件版本 | 电容版本 | 状态 |
| --- | --- | --- |
| 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/image-labeling` plugin in my project.
```

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

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

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

### 机器人

#### 变量

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

-   `$mlkitImageLabelingVersion` 版本 `com.google.mlkit:image-labeling` (默认 : `17.0.9`(中文(简体) )

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

### iOS系统

#### 最低部署目标

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

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

## 配置

此插件不需要配置 .

## 演示

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

## 使用量

以下示例显示如何在图像中检测标签.

### 在图像中检测标签

在本地路径上检测图像中的标签 。 您可以配置信任阈值来控制返回的标签 。 仅在Android和iOS上提供:

```typescript
import { ImageLabeling } from '@capacitor-mlkit/image-labeling';

const processImage = async () => {
  const { labels } = await ImageLabeling.processImage({
    path: 'path/to/image.jpg',
    confidenceThreshold: 0.5,
  });
  return labels;
};
```

## API 密码

-   [`processImage(...)`](https://npmcn.com/package/%40capacitor-mlkit/image-labeling/#readme-processimage)
-   [接口](https://npmcn.com/package/%40capacitor-mlkit/image-labeling/#readme-interfaces)

### 进程图像(...)

```typescript
processImage(options: ProcessImageOptions) => Promise<ProcessImageResult>
```

在所提供的图像中检测标签 .

标签可以描述物体,地点,活动,动物物种,产品等.

仅在Android和iOS上提供.

| 参数 | 类型 |
| --- | --- |
| **`options`** | `[ProcessImageOptions](https://npmcn.com/package/%40capacitor-mlkit/image-labeling/#readme-processimageoptions)` |

**回返情况:** `Promise<[ProcessImageResult](https://npmcn.com/package/%40capacitor-mlkit/image-labeling/#readme-processimageresult)>`

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

* * *

### 接口

#### 进程图像结果

| Prop | 类型 | 说明 | 自兹 |
| --- | --- | --- | --- |
| **`labels`** | `ImageLabel[]` | 检测到的标签 . | 8.2.0 (中文(简体) ) |

#### 图像标签

代表图像中检测到的标签 .

| Prop | 类型 | 说明 | 自兹 |
| --- | --- | --- | --- |
| **`index`** | `number` | 模型内标签的索引. | 8.2.0 (中文(简体) ) |
| **`text`** | `string` | 标签的文字(如:. `Bicycle`) (中文(简体) ). 文本总是英文. | 8.2.0 (中文(简体) ) |
| **`confidence`** | `number` | 标签的信心。 该值介于 `0.0` 财务报告和审定财务报表 `1.0`。 。 。 . | 8.2.0 (中文(简体) ) |

#### 进程图像选项

| Prop | 类型 | 说明 | 默认 | 自兹 |
| --- | --- | --- | --- | --- |
| **`path`** | `string` | 图像文件的本地路径 . |  | 8.2.0 (中文(简体) ) |
| **`confidenceThreshold`** | `number` | 标签的置信阈值. 只有置信度大于或等于此值的标签才能返回. 值必须在 `0.0` 财务报告和审定财务报表 `1.0`。 。 。 . | `0.5` | 8.2.0 (中文(简体) ) |

## 财务问题

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

这个 `processImage(...)` 方法只在Android和iOS上可用. 网络平台不支持基础的ML Kit图像标签SDK.

### 插件使用哪种模式 ?

该插件使用底图象标签模型,与应用软件相捆绑并可以识别超过400个标签,覆盖对象,地点,活动,动物物种,产品等. 自定义 十进制花式 文学模型目前不支持.

### 信心阈值能做什么?

这个 `confidenceThreshold` 选项控件返回标签。 只有在置信度大于或等于阈值的标签才包括在结果中. 值必须在 `0.0` 财务报告和审定财务报表 `1.0` 默认为 `0.5`。 。 。 .

### 标签用哪种语言返回?

标签文本总是以英语返回. 使用 `index` 如果需要翻译标签,则标签属性与您本地化的查找表一起.

### 我能用这个插件吗? 有Ionic、React、Vue或Angular?

是的,插件是框架不可知的。 它在任意网络框架的Capacitor app中工作,包括有Angular,React,或Vue的Ionic,以及平版JavaScript等项目.

## 相关插件

-   [ML Kit 条码扫描](https://capawesome.io/docs/sdks/capacitor/mlkit/barcode-scanning/):用ML Kit条码扫描条码.
-   [ML Kit 面部检测](https://capawesome.io/docs/sdks/capacitor/mlkit/face-detection/):用 ML Kit Face 检测图像中的检测面孔.
-   [ML Kit 主题分割](https://capawesome.io/docs/sdks/capacitor/mlkit/subject-segmentation/): 以ML Kit主题片段从背景中分离出主题.
-   [ML Kit 文本识别](https://capawesome.io/docs/sdks/capacitor/mlkit/text-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/image-labeling/CHANGELOG.md)。 。 。 .

## 许可证

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

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

## 常见问题

### @capacitor-mlkit/image-labeling 是什么？

在Android和iOS上的ML Kit图像标签的电容插件\.

### 如何安装 @capacitor-mlkit/image-labeling？

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

### @capacitor-mlkit/image-labeling 支持 TypeScript 吗？

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

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

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

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

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

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

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

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

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