@capacitor-mlkit/image-labeling

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

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

中文使用文档
文档目录23 节
  1. 使用大小写
  2. 兼容性
  3. 安装
  4. 机器人
  5. iOS系统
  6. 配置
  7. 演示
  8. 使用量
  9. 在图像中检测标签
  10. API 密码
  11. 进程图像(...)
  12. 接口
  13. 财务问题
  14. 此插件支持哪些平台 ?
  15. 插件使用哪种模式 ?
  16. 信心阈值能做什么?
  17. 标签用哪种语言返回?
  18. 我能用这个插件吗? 有Ionic、React、Vue或Angular?
  19. 相关插件
  20. 术语和隐私
  21. 通讯
  22. 更改日志
  23. 许可证

电容 ML Kit 图像标签插件

非官方电容插件 ML Kit 图像标签[^1]

使用大小写

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

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

兼容性

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

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

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

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

机器人

变量

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

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

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

iOS系统

最低部署目标

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

platform :ios, '15.5'

配置

此插件不需要配置 .

演示

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

使用量

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

在图像中检测标签

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

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(options: ProcessImageOptions) => Promise<ProcessImageResult>

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

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

仅在Android和iOS上提供.

参数类型
optionsProcessImageOptions

回返情况: Promise<ProcessImageResult>

自: 8.2.0 (中文(简体) )


接口

进程图像结果

Prop类型说明自兹
labelsImageLabel[]检测到的标签 .8.2.0 (中文(简体) )

图像标签

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

Prop类型说明自兹
indexnumber模型内标签的索引.8.2.0 (中文(简体) )
textstring标签的文字(如:. Bicycle) (中文(简体) ). 文本总是英文.8.2.0 (中文(简体) )
confidencenumber标签的信心。 该值介于 0.0 财务报告和审定财务报表 1.0。 。 。 .8.2.0 (中文(简体) )

进程图像选项

Prop类型说明默认自兹
pathstring图像文件的本地路径 .8.2.0 (中文(简体) )
confidenceThresholdnumber标签的置信阈值. 只有置信度大于或等于此值的标签才能返回. 值必须在 0.0 财务报告和审定财务报表 1.0。 。 。 .0.58.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等项目.

术语和隐私

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

通讯

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

更改日志

见 变动情况。 。 。 .

许可证

见 自由主义。 。 。 .

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

版本与发布记录

@capacitor-mlkit/image-labeling 共发布 4 个版本,首次发布于 2026/07/11;过去 12 个月发布了 4 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
8.2.2latest2026/10/319 天前
8.2.12026/09/101 个月前
8.2.02026/07/173 个月前
8.1.02026/07/113 个月前

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

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