更新记录

1.0.0（2026-06-09）

● 首版发布相册选择与相机拍摄组合能力。 ● 支持图片、视频选择，支持拍照、长按录像和拍摄预览。 ● 支持图片编辑、视频文字编辑、视频裁剪、原图选择和本地路径返回。 ● 适合需要同时集成相册和相机能力的媒体上传、聊天、发布类场景。

平台兼容性

uni-app(5.07)

uni-app x(5.07)

相册相机图片视频选择拍摄编辑插件

说明

这是 wsgen-album-camera 的 UTS 主线组合包，目标整合 Android 和 HarmonyOS 的相册选择和相机拍摄能力。

当前 Android 已接入旧 1.0.0 AAR 桥接实现，等待 HBuilderX 真机验证。HarmonyOS 已接入 uni.chooseMedia 系统相册/相机能力，保持 album(options, callback)、camera(options, callback) API 和旧版返回结构。

引入插件

import { album, camera } from '@/uni_modules/wsgen-album-camera'

调用相册

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

调用相机

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

Android 权限说明

Android 组合包目标需要相册和相机相关权限：

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32"/>
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES"/>
<uses-permission android:name="android.permission.READ_MEDIA_VIDEO"/>
<uses-permission android:name="android.permission.READ_MEDIA_VISUAL_USER_SELECTED"/>
<uses-permission android:name="android.permission.CAMERA"/>
<uses-permission android:name="android.permission.RECORD_AUDIO"/>

HarmonyOS 权限说明

HarmonyOS 组合包需要相册和相机相关权限：

ohos.permission.READ_IMAGEVIDEO
ohos.permission.CAMERA
ohos.permission.MICROPHONE

当前 HarmonyOS 目录已经提供平台入口、权限声明、资源配置、系统相册选择、系统拍摄实现和 ArkTS 原生组合工作台。HarmonyOS 端会调用系统相册/相机返回媒体结果；同时注册了 wsgen-album-camera-native，第一阶段已覆盖相册、相机、预览、图片编辑、视频编辑和发送事件。后续继续接入 HarmonyOS 媒体库、Camera Kit、PixelMap/Canvas 和 AV 后端能力。

HarmonyOS 拍摄入口使用系统 chooseMedia，second 会按系统能力限制到 3-30 秒；imageQuality 会用于普通图片返回前压缩；cycleColor、directReturn、rememberState、flash 等 Android 自研相机参数当前不会影响系统相机 UI。

隐私说明

插件不上传数据到服务器，不内置服务器地址，不接入广告或统计。插件只处理用户主动选择或主动拍摄的本地媒体，并返回业务必要的本地路径和媒体信息。