Repolode
margelo

margelo/react-native-vision-camera

React Native 相机库,支持拍照录像、二维码/条码扫描和实时帧处理,覆盖 iOS 与 Android。

Star
9,648
Fork
1,397
未关闭 Issue
122
最近提交
7天前

这是什么?

VisionCamera 是一个面向 React Native 应用的相机库。它提供 Camera 组件,支持拍照和录像,可控制设备(包括多摄像头)、分辨率、宽高比,以及 30 到 240 FPS 的帧率。

其核心扩展点是 Frame Processors,可以用 JavaScript worklet 逐帧处理相机画面,适合实现人脸识别、目标检测,或在实时预览上绘制图形、文字和着色器。此外还包含二维码/条码扫描、基于 Reanimated 的平滑变焦、快速暂停与恢复,以及 HDR 和夜间模式。

通过 npm 安装 react-native-vision-camera 包,iOS 端执行 pod install,再按文档配置相机权限即可开始使用。

核心功能

  • 01拍照与录像,支持自定义分辨率和宽高比
  • 02二维码与条码扫描
  • 03Frame Processors 可对每一帧运行 JavaScript worklet
  • 04支持多摄像头选择,基于 Reanimated 实现平滑变焦
  • 05提供 HDR 和夜间模式,帧率支持 30 至 240 FPS

适用场景

  • 为 React Native 应用添加应用内拍照和录像功能
  • 开发二维码或条码扫描页面
  • 对实时相机画面进行人脸或目标检测
  • 在相机预览上叠加滤镜或图形

快速上手

  1. 1

    从 npm 安装该包

    npm i react-native-vision-camera
  2. 2

    安装 iOS 依赖 (Pods)

    cd ios && pod install
  3. 3

    按照文档设置相机权限

使用前须知

  • 需要配置 iOS 和 Android 原生环境的 React Native 项目。
  • README 称 V4 已不再维护,请使用当前的 V5 版本。

标签

常见问题

react-native-vision-camera 是什么?
React Native 相机库,支持拍照录像、二维码/条码扫描和实时帧处理,覆盖 iOS 与 Android。 VisionCamera 是一个面向 React Native 应用的相机库。它提供 Camera 组件,支持拍照和录像,可控制设备(包括多摄像头)、分辨率、宽高比,以及 30 到 240 FPS 的帧率。
react-native-vision-camera 可以免费使用吗?用的什么许可证?
react-native-vision-camera 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
react-native-vision-camera 还在维护吗?
活跃维护中。react-native-vision-camera 最近一次提交是在 2026年10月14日。
react-native-vision-camera 适合用来做什么?
为 React Native 应用添加应用内拍照和录像功能 开发二维码或条码扫描页面 对实时相机画面进行人脸或目标检测 在相机预览上叠加滤镜或图形
react-native-vision-camera 怎么安装和运行?
从 npm 安装该包: npm i react-native-vision-camera 安装 iOS 依赖 (Pods): cd ios && pod install 按照文档设置相机权限
在哪里获取 react-native-vision-camera?
源代码和安装说明在 GitHub 上:https://github.com/margelo/react-native-vision-camera

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目