更新记录

0.3.2（2026-07-09） 下载此版本

• 修复部分设备使用后置摄像头拍照后图片显示异常的问题。
• 优化照片尺寸选择策略，提升后置摄像头拍照稳定性。
• 优化拍照确认页的大图预览方式，降低大图加载时的内存占用。
• 更新插件简介和标签为中文展示。

平台兼容性

uni-app(5.07)

selfie-frontcamera

一个用于 uni-app App Android 的 UTS 相机拍照插件。

插件支持打开前置摄像头、打开后置摄像头，也支持在前置和后置摄像头之间切换，并可以指定默认打开的摄像头。拍照后会进入确认页面，点击确认后返回照片结果，点击取消会删除临时照片并重新打开相机。

功能

• 支持强制使用前置摄像头拍照
• 支持强制使用后置摄像头拍照
• 支持前置/后置摄像头切换
• 支持指定默认摄像头
• 支持拍照前缩放
• 支持拍照后确认或重拍
• 默认返回本地临时图片路径，可按需返回 base64
• 支持前置摄像头照片镜像修正

使用方式

import { takeCameraPhoto } from '@/uni_modules/selfie-frontcamera'

takeCameraPhoto({
  quality: 90,
  cameraPosition: 'front',
  enableSwitch: false,
  returnBase64: false,
  fixFrontMirror: true,
  success: (res) => {
    console.log(res.tempFilePath)
    console.log(res.cameraPosition)
  },
  fail: (err) => {
    console.log(err.errMsg)
  }
})

参数说明

返回结果

{
  tempFilePath: '',
  base64: '',
  cameraPosition: 'front'
}

示例

强制使用前置摄像头：

takeCameraPhoto({
  cameraPosition: 'front',
  enableSwitch: false
})

强制使用后置摄像头：

takeCameraPhoto({
  cameraPosition: 'back',
  enableSwitch: false
})

允许切换摄像头，并默认打开前置摄像头：

takeCameraPhoto({
  cameraPosition: 'front',
  enableSwitch: true
})

允许切换摄像头，并默认打开后置摄像头：

takeCameraPhoto({
  cameraPosition: 'back',
  enableSwitch: true
})

需要返回 base64：

takeCameraPhoto({
  returnBase64: true
})

兼容性

当前仅支持：

• uni-app
• App Android
• Vue2 / Vue3

暂不支持：

• Web
• iOS
• 鸿蒙
• 小程序
• nvue
• uni-app x

注意事项

• 插件需要 Android 相机权限。
• 未拍照直接返回时不会触发错误回调。
• returnBase64 默认关闭，建议优先使用 tempFilePath。
• 拍照后如果点击取消，会删除当前临时照片并重新拍摄。