更新记录

1.0.7（2026-07-09）

• iOS ready 事件修复

1.0.6（2026-07-09）

修复预设前后摄不生效的问题，因参数名冲突有变化请了解

1.0.4（2026-07-08）

删除 android 默认的录音权限配置

平台兼容性

uni-app(4.71)

uni-app x(4.71)

自定义相机 fsyang-camera

原生 CameraX(Android) / AVFoundation(iOS) 封装的自定义相机组件 <fsyang-camera>。 预览自适应任意容器、所见即所得、横竖方向自动跟随。Android + iOS 双端一致，uni-app(vue3 / nvue) 通用。

特性

• 预览自适应：放进任意大小的盒子都不变形，所见即所得（成片 = 预览可视区）
• 拍照：自定义成片宽度（自动选传感器分辨率）/ 按比例裁剪 / 实时水印 / EXIF·GPS 开关 / 无声拍照
• 录像：按设备真实档位（4K / 1080P / 720P）+ 帧率 + 音频开关 + 自动取封面
• 专业控制：曝光补偿 / 变焦 / 点按对焦 / 两指缩放 / 闪光(关·开·自动·常亮) / 前后摄切换
• 能力一次给全：@ready 回传变焦范围、曝光档、是否有闪光灯、拍照上限、录像真实档位
• 权限独立申请：相机 / 麦克风 / 定位 各自按需

快速开始

1. 放置组件（铺满或任意容器都可）

<template>
  <view style="flex:1">
    <fsyang-camera
      ref="cam"
      style="position:absolute;left:0;top:0;right:0;bottom:0;"
      :mode="mode"
      :cameraPosition="position"
      :flash="flash"
      :photoWidth="1080"
      @ready="onReady"
      @captured="onCapture"
      @error="onError"
    />
  </view>
</template>

nvue 中自定义原生组件 flex:1 不会被撑开，请用绝对定位铺满父容器。

2. 申请权限并拍照

export default {
  data() { return { mode: 'photo', position: 'back', flash: 'off' } },
  mounted() {
    // 默认只申请相机权限；需要录像收声时，再按需申请 microphone
    this.$refs.cam.requestPermission('camera')
  },
  methods: {
    shot() { this.$refs.cam.takePhoto() },          // 拍照
    onReady(e) { /* this.parse(e) 为设备能力 */ },
    onCapture(e) {
      const d = this.parse(e)                        // { path, width, height, size, ... }
      console.log('拍到', d.path)
    },
    onError(e) { console.log(this.parse(e).message) },
    // 事件 payload 双端统一解析（字符串 / 对象 / Map 都兼容）
    parse(e) {
      let d = (e != null && e.detail != null) ? e.detail : e
      if (typeof d === 'string') { try { d = JSON.parse(d) } catch (x) { d = {} } }
      return d || {}
    }
  }
}

Props

事件

payload 双端形态略有差异（Android 为 JSON 字符串、iOS 为 e.detail），用上面的 parse(e) 统一处理即可。

方法（this.$refs.cam.xxx）

系统要求与权限

• Android minSdk 21（5.0）+，需自定义基座 / 云打包；iOS 12.0+
• 权限：相机(必需) / 定位(可选，仅写 GPS 时)；麦克风仅录像收声时需要
• Android 插件默认不声明 RECORD_AUDIO，云打包不会自动加入录音权限；如业务需要录像收声，请在宿主 manifest.json 额外添加 android.permission.RECORD_AUDIO，并在使用前调用 requestPermission('microphone')
• iOS 相机 / 麦克风 / 定位用途串插件已内置声明，云打包自动合并

购买与售后

• 支持试用，先试后买；源码版含 Android(CameraX) + iOS(AVFoundation) 完整 uts 源码 + 示例工程
• 定制 / 对接问题：插件评论区留言