更新记录

1.0.0(2026-07-29) 下载此版本

1.0.0 初始版本

  1. 集成微信小程序camera前置摄像头
  2. 圆形镂空遮罩取景UI
  3. 实时视频帧人脸检测,绘制人脸矩形框
  4. 拍照事件回调,解耦图片上传逻辑
  5. 相机异常、拍摄失败事件监听

平台兼容性

uni-app(3.8.1)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
× × × × × ×
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟
- - - - - - - - - - -

bkq-face-camera

微信小程序人脸取景相机组件,基于uni_modules规范

支持平台

微信小程序 MP-WEIXIN

依赖微信原生 wx.faceDetect 实时人脸检测接口 注意:个人小程序/沙盒测试号无法启用wx.faceDetect,仅企业认证小程序/试用小程序可用

功能特性

  1. 前置摄像头,圆形镂空遮罩取景框
  2. 实时视频帧人脸检测,绘制绿色人脸框
  3. 拍照触发success事件,返回图片临时路径
  4. 解耦上传逻辑,图片上传、人脸比对交给父页面处理
  5. 相机异常、拍摄失败事件回调

使用方式

自动easycom,无需import


<bkq-face-camera 
  @success="handleSuccess"
  @fail="handleFail"
  @error="handleCameraErr"
/>

隐私、权限声明

1. 本插件需要申请的系统权限列表:

微信小程序scope.camera相机权限;wx.faceDetect人脸检测接口权限(企业小程序后台手动开通)

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件本身不会主动采集、缓存、上传任何人脸图片数据;仅通过事件向外输出拍摄得到的图片临时路径,图片上传、人脸比对逻辑交由业务开发者自行实现,无内置请求第三方服务器逻辑。

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议