更新记录

1.0.0（2026-06-08）

• 整合相册选择与相机拍摄能力
• 支持图片视频选择、拍照录像、预览和编辑
• 支持图片涂鸦、文字、裁剪、马赛克及视频文字、裁剪
• 优化返回路径、取消标识和 Android 版本兼容

平台兼容性

uni-app(5.07)

uni-app x(5.07)

使用说明

本插件整合相册选择与相机拍摄能力，适合需要同时支持图片视频选择、拍照录像、预览和编辑的场景。

引入插件

const media = uni.requireNativePlugin('album-camera')

打开相册

media.album({}, result => {
  console.log(result)
})

打开相机

media.camera({
  second: 60,
  minSecond: 1,
  cycleColor: '#06C160',
  imageQuality: 95,
  directReturn: false,
  rememberState: true
}, result => {
  console.log(result)
})

相机参数说明

返回结果

图片：

{
  "format": "img",
  "localPath": "/storage/emulated/0/Android/data/xxx/cache/xxx.jpg"
}

视频：

{
  "format": "video",
  "localPath": "/storage/emulated/0/Android/data/xxx/cache/xxx.mp4",
  "coverLocalPath": "/storage/emulated/0/Android/data/xxx/cache/xxx.jpg",
  "second": 10,
  "size": 1234567
}

取消时返回：

{
  "event": "cancel",
  "cancel": true,
  "reason": "cancel"
}

完整示例

const media = uni.requireNativePlugin('album-camera')

function parseResult(result) {
  if (result && result.cancel) {
    console.log('用户取消', result.reason)
    return []
  }
  return result.map(item => JSON.parse(item))
}

media.album({}, result => {
  const files = parseResult(result)
  console.log('相册结果', files)
})

media.camera({
  second: 60,
  cycleColor: '#06C160'
}, result => {
  const files = parseResult(result)
  console.log('相机结果', files)
})

注意事项

• 仅支持 Android。
• 最低支持 Android 5.0，API 21。
• 相册功能需要读取图片、视频权限。
• 相机功能需要相机权限，录像需要录音权限。
• 返回路径为插件处理后的本地路径，可直接用于上传、预览等业务。