更新记录

1.0.0(2026-07-02)

首发:自定义相机支持Android/IOS 相机:预览所见即所得 文件:主要是支持IOS选择非媒体文件,android可以通过plus自己实现


平台兼容性

uni-app(3.7.13)

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

其他

多语言 暗黑模式 宽屏模式
× ×

coo-camera

UniApp UTS 插件:App 端 nvue 相机预览/拍照 + 相册选图 / 系统文件选择 API。

平台支持

平台 支持
App Android
App iOS ✓(含预编译 Framework,需自定义调试基座)
App nvue 组件
App vue 页面 仅 API
小程序 / H5

权限说明

插件会使用相机、相册/存储权限,用于拍照、选图、选文件。请在 manifest.json 配置隐私描述。

安装

将本插件目录放入项目 uni_modules/coo-camera。无需配置 nativePlugins

修改原生代码后请重新 制作自定义调试基座

API 示例

import { chooseFile, chooseImage } from '@/uni_modules/coo-camera'

chooseImage({ count: 1 }, (res) => {
  if (res.success) console.log(res.absolutePath)
})

chooseFile({ mimeType: 'application/pdf' }, (res) => {
  if (res.success) console.log(res.fileName, res.absolutePath)
})
方法 说明
chooseFile 系统文件选择
chooseImage 相册选图
toggleFlash 切换闪光灯
setFlashMode 0关 1开 2自动
getFlashStatus 查询闪光灯

iOS 拍照(subNVue 等场景)可配合:

  • registerPhotoCaptureCallback(fn)
  • cancelPhotoCaptureCallback()

组件 <coo-camera>

nvue / uvue 页面可用。

<coo-camera
  ref="camera"
  :autoStart="false"
  @onPreviewReady="onPreviewReady"
  @onPhotoCaptured="onPhoto"
  @onError="onError"
/>
this.$refs.camera.openCamera()
this.$refs.camera.takePhoto()
this.$refs.camera.toggleFlash()
this.$refs.camera.switchCamera()
this.$refs.camera.destroyCamera()

拍照文件目录:_doc/coocamera/pick/(同时返回 absolutePath)。

更新日志

changelog.md

隐私、权限声明

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

相机

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

插件不采集任何数据

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

暂无用户评论。