Repolode
margelo

margelo/react-native-vision-camera

iOS와 Android에서 사진·동영상 촬영, QR/바코드 스캔, 실시간 프레임 처리를 지원하는 React Native 카메라 라이브러리입니다.

스타
9,648
포크
1,397
열린 이슈
122
마지막 커밋
7일 전

어떤 프로젝트인가요?

VisionCamera는 React Native 앱을 위한 카메라 라이브러리입니다. 사진과 동영상 촬영을 처리하는 Camera 컴포넌트를 제공하며, 기기(멀티 카메라 구성 포함), 해상도, 화면 비율, 30~240 FPS의 프레임 레이트를 제어할 수 있습니다.

주요 확장 지점은 각 카메라 프레임을 대상으로 JavaScript worklet을 실행하는 Frame Processors입니다. 이를 활용하면 얼굴 인식, 객체 감지, 라이브 프리뷰에 도형·텍스트·셰이더 그리기 같은 기능을 구현할 수 있습니다. QR/바코드 스캐너, Reanimated를 통한 부드러운 줌, 빠른 일시 정지 및 재개, HDR 및 야간 모드도 포함되어 있습니다.

npm에서 react-native-vision-camera 패키지를 설치하고, iOS에서는 pod install을 실행한 뒤 문서에 안내된 대로 카메라 권한을 설정하세요.

핵심 기능

  • 01해상도와 화면 비율을 설정할 수 있는 사진 및 동영상 촬영
  • 02QR 및 바코드 스캔
  • 03각 카메라 프레임에서 JavaScript worklet을 실행하는 Frame Processors
  • 04Reanimated 기반의 멀티 카메라 기기 선택 및 부드러운 줌
  • 0530~240 FPS를 지원하는 HDR 및 야간 모드

활용 사례

  • React Native 앱에 인앱 카메라 촬영 기능 추가
  • QR 또는 바코드 스캔 화면 구현
  • 라이브 카메라 피드에서 얼굴이나 객체를 실시간으로 감지
  • 카메라 프리뷰 위에 필터나 오버레이 그리기

빠른 시작

  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은(는) 무엇인가요?
iOS와 Android에서 사진·동영상 촬영, QR/바코드 스캔, 실시간 프레임 처리를 지원하는 React Native 카메라 라이브러리입니다. 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 앱에 인앱 카메라 촬영 기능 추가 QR 또는 바코드 스캔 화면 구현 라이브 카메라 피드에서 얼굴이나 객체를 실시간으로 감지 카메라 프리뷰 위에 필터나 오버레이 그리기
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

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트