시작하기

React Native 앱의 스크린샷 및 화면 녹화를 방지하고 강력한 이벤트 감지 기능을 제공하는 React Native 라이브러리입니다.

✨ 주요 기능

🛡️ 스크린샷 및 화면 녹화 방지

3가지 유형의 오버레이를 통해 앱의 민감한 콘텐츠가 캡처되거나 녹화되는 것을 방지합니다:

단일 색상 오버레이 — 단색(예: 검정색, 흰색 또는 사용자 지정 16진수 색상)을 표시합니다.
블러 효과 — 콘텐츠를 가리는 블러 오버레이를 적용합니다.
사용자 지정 이미지 — 캡처 시 고유한 이미지, 로고 또는 워터마크를 표시합니다.

📸 스크린샷 감지

스크린샷이 캡처될 때 즉시 트리거되는 실시간 이벤트 감지 기능을 제공합니다:

즉각적인 반응 — 스크린샷이 찍힐 때 사용자 지정 로직을 실행합니다.
스크린샷 메타데이터 액세스 — 장치에 캡처된 스크린샷 파일 경로를 가져와 자체적인 용도로 활용할 수 있습니다.
스크린샷 이벤트 제어 — 스크린샷 이벤트 발생 횟수를 제한합니다.
상태 추적 — 스크린샷 이벤트 발생 시 ScreenGuard가 활성화 상태인지 확인합니다.

🎥 화면 녹화 감지

화면 녹화 활동을 실시간으로 모니터링합니다.

녹화 상태 감지 — 장치에서 화면 녹화가 시작되고 종료되는 시점을 파악합니다.
녹화 시도에 대응 — 녹화가 감지될 때 사용자 지정 작업을 실행합니다.
크로스 플랫폼 지원 — iOS 13+ 및 **Android 15+ (API 35+)**에서 작동합니다.

📝 활동 로깅

편집 또는 디버깅을 위한 포괄적인 로깅 기능을 제공합니다.

작동 원리

React Native ScreenGuard는 JavaScript와 네이티브 코드(iOS Objective-C, Android Java)를 연결하며, Android에서는 FLAG_SECURE를 사용하고 iOS에서는 사용자 정의 가능한 UITextField를 사용합니다.

사전 요구 사항

JavaScript, React 및 React Native에 익숙하다면 React Native Screenguard를 빠르게 시작할 수 있습니다! 익숙하지 않다면 먼저 기본 지식을 습득한 후 다시 방문하는 것을 적극 권장합니다.

도움이 될 만한 리소스는 다음과 같습니다:

최소 요구 사항

Node.js 버전 15.0 이상:
- Node.js 설치 시 종속성 관련 모든 체크박스를 선택하는 것이 좋습니다.
react-native >= 0.59
react >= 16.8.0
Expo >= 36
Android SDK >= 29
Cocoapods >= 1.1.4
iOS 최소 배포 타겟 >= 13
typescript >= 4.0.0

시작하기

✨ 주요 기능​

🛡️ 스크린샷 및 화면 녹화 방지​

📸 스크린샷 감지​

🎥 화면 녹화 감지​

📝 활동 로깅​

작동 원리​

사전 요구 사항​

최소 요구 사항​