更新记录

1.0.1(2026-09-12)

  • 修复 Android 云打包时 UTS 生成的 Kotlin 错误回调类型不兼容及构造参数缺失问题。
  • 修复 Android 拍照发送、相册取消时的返回结果解析崩溃。
  • 修复不同 targetSdkVersion 下相册权限不兼容导致媒体列表为空。
  • 修复标准基座缺少原生 Activity 时点击入口导致闪退。

1.0.0(2026-08-01)

1.0.0

  • 首次发布。
  • 支持 Android 和 iOS。
  • 支持 uni-app 与 uni-app x。
  • 支持拍照、长按录像、前后摄像头切换、重拍及取消。
  • 支持图片和视频单选、多选及预览。
  • 支持限制录像时长和视频选择时长。
  • 提供统一的 success、fail、complete 回调及错误码。

平台兼容性

uni-app(5.24)

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

uni-app x(5.24)

Chrome Safari Android iOS 鸿蒙 微信小程序
× × × ×

taurus-camera

微信式拍照、长按录像,以及应用内图片/视频多选和预览。支持 uni-app、uni-app x 的 Android/iOS App。

要求

  • HBuilderX 4.25+
  • Android 5.1(API 22)+
  • iOS 12+
  • Android 包含 Java 混编和原生资源,调试时需制作自定义基座

拍照或录像

import { open } from '@/uni_modules/taurus-camera'

open({
  maxDuration: 60,
  success: (file) => {
    console.log(file.type, file.path)
    console.log(file.snapshotPath, file.duration)
  },
  fail: (error) => console.error(error.errCode, error.errMsg)
})

轻触拍照,长按录像。maxDuration 必须是正整数,默认 60 秒。

选择图片和视频

import { pickMedia } from '@/uni_modules/taurus-camera'

pickMedia({
  maximum: 9,
  maxVideoDuration: 300,
  success: ({ files }) => console.log(files),
  fail: (error) => console.error(error.errCode, error.errMsg)
})

maximum 默认 9,maxVideoDuration 默认 300 秒,均须为正整数。

返回值

type CameraFile = {
  type: 'image' | 'video'
  path: string
  snapshotPath?: string
  duration?: number
}

路径位于应用缓存目录;需要长期保存时请自行复制。视频额外返回首帧图和秒数。

错误码

errCode 含义
9011001 参数非法
9011002 权限被拒绝
9011003 当前页面不可用
9011004 媒体导出失败
9011005 已有相机或相册操作正在进行
9011006 用户取消

插件只在用户操作后访问相机、麦克风或相册,不包含广告、统计和网络上传代码。

隐私、权限声明

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

Android:相机、麦克风、照片和视频;iOS:相机、麦克风、照片

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

仅读取用户主动选择或拍摄的图片、视频并复制到应用缓存目录,不上传数据

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

暂无用户评论。