更新记录
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 | 用户取消 |
插件只在用户操作后访问相机、麦克风或相册,不包含广告、统计和网络上传代码。

收藏人数:
购买普通授权版(
试用
使用 HBuilderX 导入示例项目
赞赏(0)
下载 1
赞赏 0
下载 12604355
赞赏 1949
赞赏
京公网安备:11010802035340号