更新记录

1.0.0（2026-03-25）

插件提交

平台兼容性

uni-app(4.01)

geni-camera 使用文档

简介

geni-camera 是一个 uni-app UTS 原生插件，用于调用系统相机进行拍照和录像。支持 Android 和 HarmonyOS 平台，自动处理相机权限申请、图片旋转修正及缩放。

支持平台

安装

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

调用说明

插件提供了 sysTools.js 工具文件，封装了跨平台的拍照调用逻辑。你可以将该文件复制到项目中任意合适的位置（如 utils/、common/ 等目录），根据实际路径修改 import 引用即可使用。

customTakePhoto(options)

调用系统相机拍照，返回 Promise。

参数：

返回值：

Promise，成功时 resolve { url: string }，url 为拍摄图片的文件路径。

使用示例

import { customTakePhoto } from '@/utils/sysTools.js'

// 使用后置摄像头拍照
async function onCapture() {
  try {
    const { url } = await customTakePhoto({ cameraType: 'back' })
    console.log('照片路径:', url)
  } catch (err) {
    console.error('拍照出错:', err)
  }
}

// 使用前置摄像头拍照
async function onSelfie() {
  try {
    const { url } = await customTakePhoto({ cameraType: 'front' })
    console.log('照片路径:', url)
  } catch (err) {
    console.error('拍照出错:', err)
  }
}

注意事项

• sysTools.js 文件可挪动到项目中任意位置，移动后请同步修改文件内的插件 import 路径及外部调用的 import 路径。
• iOS 端通过 plus.camera 实现，Android / HarmonyOS 端通过 UTS 插件实现，调用方无需关心平台差异。
• Android 端拍照图片会自动修正 EXIF 旋转方向，缩放至最大 1920px，压缩质量 85%，保存在应用缓存目录。