更新记录

1.0.0（2026-06-09）

● 首版发布相机拍照和长按录像能力。 ● 支持仿微信拍摄交互，轻触拍照、长按录像、录像进度绿环。 ● 支持拍摄后进入图片编辑页，录像后进入视频编辑页。 ● 支持录像最长时长、最短时长、进度环颜色、图片压缩质量、是否直接返回等参数配置。

平台兼容性

uni-app(5.07)

Vue2	Vue3	Chrome	Safari	app-vue	app-nvue	Android	Android插件版本	iOS	鸿蒙	鸿蒙插件版本
-	-	-	-	-	-	5.0	1.0.0	-	API 14+	1.0.0

微信小程序	支付宝小程序	抖音小程序	百度小程序	快手小程序	京东小程序	鸿蒙元服务	QQ小程序	飞书小程序	小红书小程序	快应用-华为	快应用-联盟
-	-	-	-	-	-	-	-	-	-	-	-

uni-app x(5.07)

Chrome	Safari	Android	Android插件版本	iOS	鸿蒙	鸿蒙插件版本	微信小程序
-	-	5.0	1.0.0	-	API 14+	1.0.0	-

相机拍照录像预览编辑插件

说明

这是 wsgen-camera 的 UTS 主线插件包，目标用于 Android 和 HarmonyOS 拍照、长按录像和拍摄后编辑能力。

当前 Android 已接入旧 1.0.0 AAR 桥接实现，等待 HBuilderX 真机验证。HarmonyOS 已接入 uni.chooseMedia 系统相机能力作为可运行基线，并新增 ArkTS 原生相机工作台，保持 camera(options, callback) API 和旧版返回结构。

引入插件

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

调用相机

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

参数说明

参数	类型	默认值	说明
second	Number	60	最长录像时长，单位秒。HarmonyOS 使用系统 `chooseMedia` 拍摄，实际会限制在 3-30 秒
minSecond	Number	1	最短录像时长，单位秒
cycleColor	String	#06C160	录像进度环颜色
imageQuality	Number	95	图片压缩质量，范围 1-100。HarmonyOS 对普通图片返回结果执行 `uni.compressImage`，失败时回退原图路径
directReturn	Boolean	false	是否拍摄后直接返回，不进入编辑
rememberState	Boolean	true	是否记忆前后摄像头和闪光灯状态
cameraFacing	String	back	默认摄像头，back 或 front
flash	String	off	默认闪光灯状态，off 或 on

Android 权限说明

Android 相机能力目标需要以下权限：

<uses-permission android:name="android.permission.CAMERA"/>
<uses-permission android:name="android.permission.RECORD_AUDIO"/>

HarmonyOS 权限说明

HarmonyOS 相机能力需要以下权限：

ohos.permission.CAMERA
ohos.permission.MICROPHONE

当前 HarmonyOS 目录已经提供平台入口、权限声明、资源配置、系统拍摄实现和 ArkTS 原生相机工作台。HarmonyOS 端会调用系统相机拍照/录像并返回媒体结果；second 会按系统能力限制到 3-30 秒。同时注册了 wsgen-camera-native，第一阶段已覆盖相机预览状态、闪光灯、摄像头切换、对焦、拍照、录像、拍后编辑和发送事件。后续继续接入 Camera Kit、PixelMap/Canvas 和 AV 后端能力。

HarmonyOS 拍摄入口使用系统 chooseMedia，imageQuality 会用于普通图片返回前压缩；minSecond、cycleColor、directReturn、rememberState、flash 等 Android 自研相机参数当前不会影响系统相机 UI。

隐私说明

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