更新记录

1.0.0（2026-01-29） 下载此版本

新增

• 初始版本发布
• 支持主体分割功能
• 基于华为 Core Vision Kit 实现
• 支持多主体检测
• 支持前景图输出（PNG透明背景）
• 支持主体位置信息返回

平台兼容性

uni-app(4.81)

jack-subject-segment

主体分割插件，基于华为 Core Vision Kit，支持 HarmonyOS 平台。

功能特性

• ✅ 支持主体分割（抠图）
• ✅ 支持背景替换
• ✅ 支持多主体检测
• ✅ 返回前景图（PNG格式，透明背景）
• ✅ 返回主体位置信息

平台支持

安装

将插件导入到项目的 uni_modules 目录即可。

使用方法

使用 import 导入（推荐）

<script>
// #ifdef APP-HARMONY
import { segmentationInit, doSegmentation, segmentationRelease } from '@/uni_modules/jack-subject-segment'
// #endif

export default {
  onLoad() {
    // 初始化主体分割
    // #ifdef APP-HARMONY
    segmentationInit({
      success: (res) => {
        console.log('初始化成功', res)
      },
      fail: (err) => {
        console.error('初始化失败', err)
      }
    })
    // #endif
  },

  methods: {
    segmentImage() {
      // 执行主体分割
      // #ifdef APP-HARMONY
      doSegmentation({
        imagePath: '/path/to/image.jpg',
        maxCount: 1,
        enableSubjectForegroundImage: true,
        success: (res) => {
          console.log('分割成功')
          console.log('主体数量:', res.subjectCount)
          console.log('前景图:', res.foregroundImage) // base64 格式
        },
        fail: (err) => {
          console.error('分割失败', err)
        }
      })
      // #endif
    }
  },

  onUnload() {
    // 释放资源
    // #ifdef APP-HARMONY
    segmentationRelease({
      success: (res) => {
        console.log('释放成功', res)
      }
    })
    // #endif
  }
}
</script>

API 说明

segmentationInit(options)

初始化主体分割服务。

参数说明：

doSegmentation(options)

执行主体分割。

参数说明：

success 返回参数：

segmentationRelease(options)

释放主体分割服务资源。

参数说明：

错误码

注意事项

1. 使用前必须先调用 segmentationInit 初始化服务
2. 页面销毁时建议调用 segmentationRelease 释放资源
3. 主体分割某个物体占比不小于原图大小的千分之五才会被认定为"主体"
4. 不建议用于处理包含较多文字内容的图片
5. 建议图片分辨率：720p 以上
6. 图片尺寸限制：20px < 高度 < 9000px，20px < 宽度 < 9000px
7. 高宽比例建议 3:1 以下

应用场景

• 证件照换底色
• 主体贴纸制作
• 背景替换
• 显著性检测
• 辅助图片编辑

许可证

MIT