更新记录

1.1.5（2026-07-14）

优化在低端机型性能。 更新安卓最新版依赖。 注意设置质量参数改变了，不在方法里传了

1.1.4（2026-05-26）

修复小米机型拍照后被旋转问题

1.1.3（2026-04-27）

安卓补上 onCaptureStarted() 方法

平台兼容性

uni-app(4.81)

rd-camera 自定义相机插件

高性能自定义相机 UTS 插件，基于 CameraX（Android）和 AVFoundation（iOS）实现。 尽量使用 HBuilder X -alpha 版本

功能特性

• 自定义相机预览（支持缩放模式配置）
• 拍照功能（Android 支持 ZSL 快拍，4 档质量配置，前置自动镜像，智能裁剪对齐预览）
• 视频录制（支持时长限制、音频录制、4 档质量）
• 前后摄像头切换
• 闪光灯控制（开关切换 + 模式设置）
• 音频处理：回声消除、噪声抑制、自动增益控制
• 输出文件格式选择（iOS: mov/mp4, Android: mp4）
• 页面卸载时自动释放资源，避免内存泄漏

安装

将 uni_modules/rd-camera 目录复制到项目的 uni_modules 目录下。

平台支持

仅支持 nvue 页面使用

权限要求

Android

• android.permission.CAMERA - 相机权限
• android.permission.RECORD_AUDIO - 麦克风权限
• android.permission.WRITE_EXTERNAL_STORAGE - 存储权限（Android 9 及以下）

iOS

在 Info.plist 中添加以下权限描述：

<key>NSCameraUsageDescription</key>
<string>需要访问相机进行拍照和录制视频</string>
<key>NSMicrophoneUsageDescription</key>
<string>需要访问麦克风录制视频声音</string>
<key>NSPhotoLibraryAddUsageDescription</key>
<string>需要访问相册保存照片和视频</string>

API

属性 (Props)

scaleType 缩放模式

scaleType 仅 Android 平台生效，iOS 预览始终为填充模式。

事件 (Events)

Android 照片缓存文件完成后立即回调，相册复制在后台继续。视频在 Android 10+ 且 saveToAlbum=true 时由 CameraX 直接写入 MediaStore，完成事件的 path 为 content:// URI；不保存相册时返回缓存文件路径。

方法 (Methods)

Android 与 iOS 使用相同的方法签名，质量统一通过 photoQuality 属性传入。

参数说明

photoQuality（照片/视频质量）

Android 与 iOS 的照片和视频都共用 photoQuality，capturePhoto 和 startRecording 不再接收质量参数。Android 属性变化时会提前重建 CameraX 拍照会话并预热 ZSL。

startRecording 参数

事件回调数据

onPhotoCaptured / onRecordingFinished

{
  detail: {
    success: boolean,   // 是否成功
    message: string,    // 提示信息
    path: string        // 文件路径；Android 10+ 相册视频为 content:// URI
  }
}

onCameraReady / onError

{
  detail: {
    message: string     // 提示信息
  }
}

onRecordingDurationUpdate

{
  detail: {
    duration: number    // 当前录制时长（秒，浮点数）
  }
}

使用示例

Vue2 使用示例

<template>
  <view class="container">
    <!-- 相机组件 -->
    <rd-camera 
      ref="camera"
      class="camera-preview"
      :cameraPosition="cameraPosition"
      :scaleType="3"
      photoQuality="high"
      @onCameraReady="onCameraReady"
      @onPhotoCaptured="onPhotoCaptured"
      @onRecordingFinished="onRecordingFinished"
      @onRecordingDurationUpdate="onRecordingDurationUpdate"
      @onError="onError"
    />

    <!-- 控制按钮 -->
    <view class="controls">
      <button @click="capturePhoto">拍照</button>
      <button @click="startRecording">开始录制</button>
      <button @click="stopRecording">停止录制</button>
      <button @click="switchCamera">切换摄像头</button>
      <button @click="toggleFlash">闪光灯</button>
    </view>

    <!-- 录制时长显示 -->
    <text v-if="isRecording">录制中: {{ recordingDuration }}秒</text>
  </view>
</template>

<script>
export default {
  data() {
    return {
      isRecording: false,
      recordingDuration: 0,
      isCameraReady: false,
      cameraPosition: 'back'
    }
  },

  methods: {
    onCameraReady(e) {
      console.log('相机已就绪', e.detail.message)
      this.isCameraReady = true
    },

    capturePhoto() {
      if (!this.isCameraReady) {
        uni.showToast({ title: '相机未就绪', icon: 'none' })
        return
      }
      this.$refs.camera.capturePhoto(true)
    },

    onPhotoCaptured(e) {
      const { success, message, path } = e.detail
      if (success) {
        console.log('拍照成功，路径:', path)
        uni.showToast({ title: '拍照成功', icon: 'success' })
      } else {
        uni.showToast({ title: message, icon: 'none' })
      }
    },

    startRecording() {
      if (!this.isCameraReady) {
        uni.showToast({ title: '相机未就绪', icon: 'none' })
        return
      }
      if (this.$refs.camera.getRecordingStatus()) {
        uni.showToast({ title: '正在录制中', icon: 'none' })
        return
      }
      this.recordingDuration = 0
      this.$refs.camera.startRecording(
        true,     // saveToAlbum
        true,     // recordAudio
        60,       // maxDuration (60秒)
        true,     // echoCancellation
        true,     // noiseSuppression
        true,     // autoGainControl
        'mp4'     // outputFileType
      )
      this.isRecording = true
    },

    stopRecording() {
      this.$refs.camera.stopRecording()
      this.isRecording = false
    },

    onRecordingFinished(e) {
      const { success, message, path } = e.detail
      this.isRecording = false
      if (success) {
        console.log('录制成功，路径:', path)
        uni.showToast({ title: '录制成功', icon: 'success' })
      } else {
        uni.showToast({ title: message, icon: 'none' })
      }
    },

    onRecordingDurationUpdate(e) {
      this.recordingDuration = Math.floor(e.detail.duration)
    },

    switchCamera() {
      this.$refs.camera.switchCamera()
      this.cameraPosition = this.cameraPosition === 'front' ? 'back' : 'front'
    },

    toggleFlash() {
      const result = this.$refs.camera.toggleFlash()
      uni.showToast({ 
        title: result ? '闪光灯已开启' : '闪光灯已关闭', 
        icon: 'none' 
      })
    },

    onError(e) {
      console.error('相机错误:', e.detail.message)
      uni.showToast({ title: e.detail.message, icon: 'none' })
    }
  },

  beforeUnmount() {
    if (this.isRecording) {
      this.$refs.camera.stopRecording()
    }
  }
}
</script>

<style>
.container {
  flex: 1;
}

.camera-preview {
  width: 100%;
  height: 500rpx;
}

.controls {
  display: flex;
  flex-wrap: wrap;
  justify-content: center;
  padding: 20rpx;
}

.controls button {
  margin: 10rpx;
  font-size: 28rpx;
}
</style>

Vue3 使用示例

<template>
  <view class="container">
    <rd-camera 
      ref="cameraRef"
      class="camera-preview"
      :cameraPosition="cameraPosition"
      :scaleType="3"
      photoQuality="high"
      @onCameraReady="onCameraReady"
      @onPhotoCaptured="onPhotoCaptured"
      @onRecordingFinished="onRecordingFinished"
      @onRecordingDurationUpdate="onRecordingDurationUpdate"
      @onError="onError"
    />

    <view class="controls">
      <button @click="capturePhoto">拍照</button>
      <button @click="handleStartRecording">
        {{ isRecording ? '录制中...' : '开始录制' }}
      </button>
      <button @click="handleStopRecording" :disabled="!isRecording">停止录制</button>
      <button @click="switchCamera">切换摄像头</button>
      <button @click="toggleFlash">闪光灯</button>
    </view>

    <text v-if="isRecording" class="duration-text">
      录制中: {{ recordingDuration }}秒
    </text>

    <image v-if="lastPhotoPath" :src="lastPhotoPath" class="preview-image" mode="aspectFit" />
  </view>
</template>

<script setup>
import { ref } from 'vue'

const cameraRef = ref(null)
const isRecording = ref(false)
const recordingDuration = ref(0)
const isCameraReady = ref(false)
const lastPhotoPath = ref('')
const cameraPosition = ref('back')

const onCameraReady = (e) => {
  console.log('相机已就绪', e.detail.message)
  isCameraReady.value = true
}

const capturePhoto = () => {
  if (!isCameraReady.value) {
    uni.showToast({ title: '相机未就绪', icon: 'none' })
    return
  }
  cameraRef.value.capturePhoto(true)
}

const onPhotoCaptured = (e) => {
  const { success, message, path } = e.detail
  if (success) {
    lastPhotoPath.value = path
    uni.showToast({ title: '拍照成功', icon: 'success' })
  } else {
    uni.showToast({ title: message, icon: 'none' })
  }
}

const handleStartRecording = () => {
  if (!isCameraReady.value) {
    uni.showToast({ title: '相机未就绪', icon: 'none' })
    return
  }
  if (cameraRef.value.getRecordingStatus()) {
    uni.showToast({ title: '正在录制中', icon: 'none' })
    return
  }
  recordingDuration.value = 0
  cameraRef.value.startRecording(
    true,     // saveToAlbum
    true,     // recordAudio
    60,       // maxDuration
    true,     // echoCancellation
    true,     // noiseSuppression
    true,     // autoGainControl
    'mp4'     // outputFileType
  )
  isRecording.value = true
}

const handleStopRecording = () => {
  cameraRef.value.stopRecording()
}

const onRecordingFinished = (e) => {
  const { success, message, path } = e.detail
  isRecording.value = false
  if (success) {
    console.log('录制成功，路径:', path)
    uni.showToast({ title: '录制成功', icon: 'success' })
  } else {
    uni.showToast({ title: message, icon: 'none' })
  }
}

const onRecordingDurationUpdate = (e) => {
  recordingDuration.value = Math.floor(e.detail.duration)
}

const switchCamera = () => {
  cameraRef.value.switchCamera()
  cameraPosition.value = cameraPosition.value === 'front' ? 'back' : 'front'
}

const toggleFlash = () => {
  const result = cameraRef.value.toggleFlash()
  uni.showToast({ 
    title: result ? '闪光灯已开启' : '闪光灯已关闭', 
    icon: 'none' 
  })
}

const onError = (e) => {
  console.error('相机错误:', e.detail.message)
  uni.showToast({ title: e.detail.message, icon: 'none' })
}
</script>

<style scoped>
.container {
  flex: 1;
  background-color: #000;
}

.camera-preview {
  width: 100%;
  height: 500rpx;
}

.controls {
  display: flex;
  flex-wrap: wrap;
  justify-content: center;
  padding: 20rpx;
  background-color: #fff;
}

.controls button {
  margin: 10rpx;
  font-size: 28rpx;
  padding: 15rpx 30rpx;
}

.duration-text {
  color: #fff;
  text-align: center;
  padding: 20rpx;
  font-size: 32rpx;
}

.preview-image {
  width: 100%;
  height: 300rpx;
  margin-top: 20rpx;
}
</style>

平台差异

注意事项

1. 仅支持 nvue 页面：本组件为原生组件，只能在 nvue 页面中使用。
2. 页面卸载：在页面卸载前（beforeUnmount/onBeforeUnmount）建议手动调用 stopRecording() 停止录制，组件会在 NVBeforeUnload 中自动释放资源。
3. 权限检查：组件在 Android 端会自动请求相机和麦克风权限；iOS 端需要在 Info.plist 中手动配置权限描述。
4. maxDuration 参数：传入 0 表示不限制录制时长；设置最大时长后，到达时间会自动停止录制并触发 onRecordingFinished 事件。
5. 录制状态同步：isRecording 状态应由 onRecordingFinished 事件驱动更新，而非仅依赖前端标记，以确保与原生状态一致。
6. saveToAlbum：Android 10+ 由 CameraX 直接写入 MediaStore，避免完整视频二次复制，此时结果 path 为 content:// URI；不保存相册时返回缓存文件路径。