更新记录

1.2.10（2025-08-07）

修复问题

1.2.9（2025-08-06）

测试编译

1.2.8（2025-08-06）

测试打包

平台兼容性

uni-app(4.61)

paulxia-aiface

使用

在页面引入

1.重要：使用前先勾选文件读取权限，具体步骤：打开manifest.json,选择App权限配置,勾选,iOS隐私摄像头信息填写具体信息

<paulxia-aiface ref="aiFaceRef" @snap="snapResult" @submit="submitResult"></paulxia-aiface>

引入依赖

import { ref } from 'vue'
import PaulxiaAiface from "@/uni_modules/paulxia-aiface"
import { faceStartType } from '@/uni_modules/paulxia-aiface/global'

执行操作

const aiFaceRef = ref<{start: faceStartType}>()

const start = () => {
  aiFaceRef.value.start({
    // 唤起交互的动画，支持"slide-in-right" | "none" | "auto" | "slide-in-left" | "slide-in-top" | "slide-in-bottom" | "fade-in" | "zoom-out" | "zoom-fade-out" | "flip-x" | "flip-rx" | "flip-y" | "flip-ry" | "page-forward" | "pop-in"， 默认"slide-in-right"
    animation: 'slide-in-right',
    // 动画时间，默认200
    duration: 200,
    // 视图是否可以滚动，默认true
    viewerScroll: true,
    // 引导人像的封面图标，传入路径会覆盖默认
    coverIcon: '',
    // 照相图标，传入路径会覆盖默认
    shutterIcon: '',
    // 切换前后摄像头图标，传入路径会覆盖默认
    flipIcon: '',
    // 关闭照相结果图标，传入路径会覆盖默认
    closeIcon: '',
    // 确认照相结果图标，传入路径会覆盖默认
    confirmIcon: '',
    // 水印文字，目前只支持文字
    watermark: 'watermark',
    // 视图宽度，默认100vw
    width: '100vw',
    // 视图高度，默认100vw
    height: '100vh',
    // 期望摄像宽度，支持number | (arg0: number[]) => number
    idealWidth: null,
    // 期望摄像高度，支持number | (arg0: number[]) => number
    idealHeight: null,
    // 自定义模型路径，不传可默认使用插件内部自带
    modelsFolder: '',
    // 前后摄像头参数，支持user | environment，user为前置摄像头，environment为后置摄像头
    initMode: 'user',
    // 拍照后是否需要确认，默认true，传入false拍照后直接返回
    needConfirm: true,
    // 拍照后返回参数类型，支持base64 | doc，base64为图片base64，可直接显示，doc为本地doc目录
    resultType: 'base64',
    // 拍照后返回图片质量，默认为0.9，传入参数范围0~1
    resultImageQuality: 0.9,
    // 是否人脸检测，以下AI模型参数均依赖此参数为true，传入false不加载模型检测人脸
    faceDetect: true,
    // 是否绘制人脸方框，默认false
    drawBoxes: false,
    // 是否绘制人脸信息，默认true
    landmark: true,
    // 是否识别表情，默认false
    expressions: false,
    // 表情识别阈值，默认0.1，传入参数范围0~1
    expressionMinConfidence: 0.1,
    // 是否识别年龄信息，默认false
    ageGender: false,
    // 是否计算人脸特征向量，默认false
    descriptor: false,
    // 人脸检测图片尺寸(必须是32的倍数)， 值越大精度越高,但速度越慢,建议范围:224~640
    inputSize: 512,
    // 人脸检测阈值，默认0.5，传入参数范围0~1
    scoreThreshold: 0.5,
    // 人脸检绘制方法，默认不绘制
    drawDetectText: (result) => {
      return [
        `${result.age} years`,
        `${result.gender} (${result.genderProbability})`,
        ...result.expresses.map(s => `${s.expression}(${s.probability})`)
      ]
    }
  })
}

兼容性说明

目前测试了 安卓13.0， 14.0，15.0 、ios13+ ，其他系统版本兼容性未知，请自行测试，或QQ联系我进行调试