更新记录

1.0.0（2025-03-13） 下载此版本

1.0.0

平台兼容性

uni-app

BioAuthCamera 活体检测相机插件

一个用于uni-app的原生插件，提供活体检测功能，支持Android和iOS平台。

功能特点

• 调用系统相机进行活体检测
• 自定义UI遮罩和检测引导
• 支持设置检测时长和质量
• 提供权限检查和请求接口
• 支持多语言

安装方法

方式一：使用HBuilderX导入插件

1. 打开HBuilderX
2. 点击菜单【工具】-【插件安装】
3. 选择【uni_module】选项卡，搜索【BioAuthCamera】
4. 点击【安装】按钮

方式二：手动导入

1. 将本插件复制到项目根目录的uni_modules目录下
2. 重启HBuilderX

使用方法

配置权限

Android平台

在项目的manifest.json文件中的"app-plus"节点下添加以下内容：

"permissions": [
    "<uses-permission android:name=\"android.permission.CAMERA\"/>"
]

iOS平台

在项目的manifest.json文件中的"app-plus"节点下添加以下内容：

"ios": {
    "privacyDescription": {
        "NSCameraUsageDescription": "使用相机进行活体检测"
    }
}

基本用法

import BioAuthCamera from '@/uni_modules/bio-auth-camera';

// 检查相机权限
BioAuthCamera.checkCameraPermission(result => {
  console.log('相机权限状态:', result.hasPermission);

  if (!result.hasPermission) {
    // 请求权限
    BioAuthCamera.requestCameraPermission(permResult => {
      console.log('权限请求结果:', permResult.granted);
    });
    return;
  }

  // 开始活体检测
  BioAuthCamera.startLiveDetection({
    minDuration: 2,          // 最小检测时长（秒）
    maxDuration: 3,          // 最大检测时长（秒）
    quality: 'high',         // 视频质量，可选 'high', 'medium', 'low'
    maskColor: '#80000000',  // 遮罩颜色
    tips: '请将脸部置于框内', // 提示文字
    scanAnimation: true,     // 是否显示扫描动画
    autoVerify: true         // 是否自动验证
  }, result => {
    if (result.success) {
      console.log('检测成功');
      console.log('检测时长:', result.duration);
    } else {
      console.log('检测失败或被取消');
      console.log('错误信息:', result.message);
    }
  });
});

// 取消检测（如果需要）
function cancelDetection() {
  BioAuthCamera.cancelDetection(result => {
    console.log('取消结果:', result);
  });
}

API说明

1. 开始活体检测

BioAuthCamera.startLiveDetection(options, callback)

参数说明:

options 参数:

callback 返回结果:

2. 取消检测

BioAuthCamera.cancelDetection(callback)

参数说明:

3. 检查相机权限

BioAuthCamera.checkCameraPermission(callback)

参数说明:

callback 返回结果:

4. 请求相机权限

BioAuthCamera.requestCameraPermission(callback)

参数说明:

callback 返回结果:

注意事项

1. Android 6.0以上版本需要动态申请相机权限
2. iOS需要在info.plist中配置相机使用描述
3. 检测过程中请保持网络连接
4. 建议在光线充足的环境下使用

更新日志

1.0.0 (2023-07-01)

• 首次发布

许可证

MIT