react-native-vision-camera-spoof-detector 1.0.26 → 1.0.28

package/README.md

@@ -20,9 +20,10 @@ High-performance face anti-spoofing and liveness detection module for React Nati
 ## 📋 Requirements
 
 - React Native >= 0.60.0
-- react-native-vision-camera >= 4.6.4
-- react-native-reanimated >= 3.0.0
-- react-native-worklets-core >= 1.0.0
+- React Native Vision Camera `^4.6.4` or `^5.0.0`
+- `react-native-reanimated` `^3.0.0`
+- `react-native-worklets-core` `^1.0.0`
+- iOS 11.0 or later
 - react-native-vision-camera-face-detector (optional, for enhanced features)
 
 ## 📦 Installation
@@ -43,7 +44,26 @@ npm install react-native-vision-camera react-native-reanimated react-native-work
 yarn add react-native-vision-camera react-native-reanimated react-native-worklets-core
 ```
 
-### Step 3: Configure Android (if not auto-linked)
+### Step 3: Configure iOS
+
+Install the CocoaPods dependencies from the iOS directory:
+
+```bash
+cd ios
+pod install
+cd ..
+```
+
+Add a camera usage description to `ios/<YourApp>/Info.plist`:
+
+```xml
+<key>NSCameraUsageDescription</key>
+<string>This app uses the camera for face liveness verification.</string>
+```
+
+Open the generated `.xcworkspace` in Xcode, or run the app with the React Native CLI. The package pod bundles `FaceAntiSpoofing.tflite` and declares its `TensorFlowLiteSwift` and `VisionCamera` dependencies automatically. No manual model copy is required.
+
+### Step 4: Configure Android (if not auto-linked)
 
 Add to `android/app/build.gradle`:
 
@@ -53,7 +73,7 @@ dependencies {
 }
 ```
 
-### Step 4: Link native module (for React Native < 0.60)
+### Step 5: Link native module (for React Native < 0.60)
 
 ```bash
 react-native link react-native-vision-camera-spoof-detector
@@ -61,24 +81,31 @@ react-native link react-native-vision-camera-spoof-detector
 
 ## 🚀 Quick Start
 
+> **Important:** Request camera permission before rendering `Camera`, and call `initializeFaceAntiSpoof()` once before the frame processor starts. The frame processor returns `null` until native initialization or a result is available. Native inference is throttled and may return the most recent result while another frame is being processed.
+
 ### Simple Usage
 
 ```javascript
 import React, { useEffect, useState } from 'react';
 import { StyleSheet, Text, View } from 'react-native';
-import { Camera, useCameraDevices, useFrameProcessor } from 'react-native-vision-camera';
+import { Camera, useCameraDevices, useCameraPermission, useFrameProcessor } from 'react-native-vision-camera';
 import { faceAntiSpoofFrameProcessor, initializeFaceAntiSpoof } from 'react-native-vision-camera-spoof-detector';
 import { runOnJS } from 'react-native-reanimated';
 
 export default function App() {
   const devices = useCameraDevices();
   const device = devices.front;
+  const { hasPermission, requestPermission } = useCameraPermission();
   const [spoofResult, setSpoofResult] = useState(null);
 
   useEffect(() => {
-    initializeFaceAntiSpoof().then((success) => {
-      console.log('FaceAntiSpoof initialized:', success);
-    });
+    if (!hasPermission) requestPermission();
+  }, [hasPermission, requestPermission]);
+
+  useEffect(() => {
+    initializeFaceAntiSpoof()
+      .then((success) => console.log('FaceAntiSpoof initialized:', success))
+      .catch((error) => console.error('FaceAntiSpoof initialization failed:', error));
   }, []);
 
   const frameProcessor = useFrameProcessor((frame) => {
@@ -89,7 +116,7 @@ export default function App() {
     }
   }, []);
 
-  if (device == null) return <Text>Loading...</Text>;
+  if (!hasPermission || device == null) return <Text>Waiting for camera permission...</Text>;
 
   return (
     <View style={styles.container}>
@@ -292,14 +319,14 @@ const result = faceAntiSpoofFrameProcessor(frame);
 
 **Parameters**: `frame` (Vision Camera Frame)
 
-**Returns**: `FaceAntiSpoofingResult | null`
+**Returns**: `FaceAntiSpoofingResult | null`. On iOS, inference runs off the frame callback and the returned object can be the latest completed result.
 
 ### `FaceAntiSpoofingResult`
 
 ```typescript
 interface FaceAntiSpoofingResult {
   isLive: boolean;              // Real face (true) or spoof (false)
-  label: string;                // "Live Face" or "Spoof Face"
+  label: string;                // Usually "live", "spoof", or "error"
   neuralNetworkScore: number;   // 0.0-1.0 confidence
   laplacianScore: number;       // Image quality score
   combinedScore: number;        // Weighted average
@@ -331,11 +358,7 @@ const FACE_CENTER_THRESHOLD_Y = 0.15;         // Y-axis tolerance
 
 ## 🎮 Complete Examples
 
-Check the [examples](./examples) folder for:
-- Basic anti-spoofing detection
-- Face detection with liveness
-- Complete capture flow
-- UI components and feedback
+The [Quick Start](#-quick-start) above shows the basic frame-processor integration. For the complete capture flow, face detection, liveness, and UI patterns, see the [project wiki](https://github.com/dpraful/react-native-vision-camera-spoof-detector/wiki).
 
 ## 🔍 Attack Detection Capabilities
 
@@ -363,8 +386,8 @@ Performance depends on:
 
 | Platform | Status | GPU | Notes |
 |----------|--------|-----|-------|
-| Android  | ✅ Supported | Yes | Fully optimized |
-| iOS      | ⏳ In Progress | Yes | Coming soon |
+| Android  | ✅ Supported | Yes | TensorFlow Lite model bundled in the AAR |
+| iOS      | ✅ Supported | CPU | Requires CocoaPods and iOS 11+ |
 | Web      | ❌ No | N/A | Not applicable |
 
 ## 🐛 Troubleshooting
@@ -377,11 +400,15 @@ if (!available) {
 }
 ```
 
+- iOS: run `pod install` from the `ios` directory and rebuild the app from the generated workspace.
+- iOS: verify `NSCameraUsageDescription` exists in the app's `Info.plist`.
+- Check the initialization promise result and inspect the native logs for model-loading errors.
+
 **Low accuracy**
 - Check lighting conditions
 - Ensure face is centered
 - Adjust `antispooflevel` parameter
-- Verify TensorFlow Lite models are bundled
+- Verify the `FaceAntiSpoofing.tflite` model is bundled (the package does this automatically on iOS)
 
 **Performance issues**
 - Reduce frame processing frequency
@@ -397,10 +424,9 @@ if (!available) {
 
 ## 📖 Documentation
 
-- [Complete API Documentation](./.docs/API.md)
-- [Migration Guide](./.docs/MIGRATION.md)
-- [Best Practices](./.docs/BEST_PRACTICES.md)
-- [Comprehensive Example](./examples/CompleteExampleApp.tsx)
+- [Project Wiki](https://github.com/dpraful/react-native-vision-camera-spoof-detector/wiki)
+- [Changelog](./CHANGELOG.md)
+- [Contributing Guide](./CONTRIBUTING.md)
 
 ## 🤝 Contributing
 

package/android/.gradle/buildOutputCleanup/cache.properties

@@ -1,2 +1,2 @@
-#Thu Sep 03 10:53:58 IST 2026
-gradle.version=9.2.0
+#Thu Sep 03 17:06:38 IST 2026
+gradle.version=8.9

package/ios/FaceAntiSpoofFrameProcessor.swift

@@ -11,9 +11,9 @@ import Accelerate
 import TensorFlowLite
 #endif
 
-typealias FaceAntiSpoofFrameType = Frame
-typealias FaceAntiSpoofProxyType = VisionCameraProxyHolder
-typealias FaceAntiSpoofPluginBase = FrameProcessorPlugin
+typealias FaceAntiSpoofFrameType = VisionCamera.Frame
+typealias FaceAntiSpoofProxyType = VisionCamera.VisionCameraProxyHolder
+typealias FaceAntiSpoofPluginBase = VisionCamera.FrameProcessorPlugin
 
 @objc(FaceAntiSpoofFrameProcessor)
 class FaceAntiSpoofFrameProcessor: FaceAntiSpoofPluginBase {
@@ -24,6 +24,9 @@ class FaceAntiSpoofFrameProcessor: FaceAntiSpoofPluginBase {
     private var isProcessing: Bool = false
     private var latestResult: [String: Any] = ["error": "Not initialized", "isLive": false, "label": "Not Initialized"]
     private static let INPUT_IMAGE_SIZE: Int = 256
+    private static let BASE_THRESHOLD: Float = 0.2
+    private static let LAPLACE_THRESHOLD: Int = 50
+    private static let LAPLACIAN_THRESHOLD: Int = 4000
 
     #if canImport(TensorFlowLite)
     // Interpreter is provided by FaceAntiSpoofManager.sharedInterpreter
@@ -90,7 +93,7 @@ class FaceAntiSpoofFrameProcessor: FaceAntiSpoofPluginBase {
 
         // Capture a small, resized RGB float snapshot synchronously while the pixel buffer is valid
         let targetSize = CGSize(width: Self.INPUT_IMAGE_SIZE, height: Self.INPUT_IMAGE_SIZE)
-        guard let rgbInput = Self.rgbFloatData(from: pixelBuffer, size: targetSize) else {
+        guard let rgbInput = Self.rgbFloatData(from: pixelBuffer, orientation: frame.orientation, size: targetSize) else {
             objc_sync_enter(self)
             isProcessing = false
             objc_sync_exit(self)
@@ -145,14 +148,15 @@ class FaceAntiSpoofFrameProcessor: FaceAntiSpoofPluginBase {
 
                 let combined = Self.calculateCombinedScore(neuralScore: nnScore, laplacianScore: lapScore)
                 let confidence = Self.calculateConfidence(neuralScore: nnScore, laplacianScore: lapScore)
+                let isLive = nnScore < Self.BASE_THRESHOLD && lapScore > Self.LAPLACIAN_THRESHOLD
 
                 self.latestResult = [
                     "neuralNetworkScore": Double(nnScore),
                     "laplacianScore": lapScore,
                     "combinedScore": Double(combined),
                     "confidence": Double(confidence),
-                    "isLive": combined > 0.5,
-                    "label": combined > 0.5 ? "live" : "spoof",
+                    "isLive": isLive,
+                    "label": isLive ? "live" : "spoof",
                     "width": width,
                     "height": height
                 ]
@@ -180,11 +184,25 @@ class FaceAntiSpoofFrameProcessor: FaceAntiSpoofPluginBase {
 
     private static let sharedCIContext: CIContext = CIContext(options: nil)
 
-    private static func rgbFloatData(from pixelBuffer: CVPixelBuffer, size: CGSize) -> [Float]? {
+    private static func rgbFloatData(from pixelBuffer: CVPixelBuffer, orientation: UIImage.Orientation, size: CGSize) -> [Float]? {
         CVPixelBufferLockBaseAddress(pixelBuffer, CVPixelBufferLockFlags.readOnly)
         defer { CVPixelBufferUnlockBaseAddress(pixelBuffer, CVPixelBufferLockFlags.readOnly) }
 
-        let ciImage = CIImage(cvPixelBuffer: pixelBuffer)
+        let image = CIImage(cvPixelBuffer: pixelBuffer)
+        let exifOrientation: CGImagePropertyOrientation
+        switch orientation {
+        case .up, .upMirrored:
+            exifOrientation = .up
+        case .right, .rightMirrored:
+            exifOrientation = .right
+        case .down, .downMirrored:
+            exifOrientation = .down
+        case .left, .leftMirrored:
+            exifOrientation = .left
+        @unknown default:
+            exifOrientation = .up
+        }
+        let ciImage = image.oriented(forExifOrientation: Int32(exifOrientation.rawValue))
         let context = Self.sharedCIContext
         guard let cgImage = context.createCGImage(ciImage, from: ciImage.extent) else { return nil }
 
@@ -243,7 +261,7 @@ class FaceAntiSpoofFrameProcessor: FaceAntiSpoofPluginBase {
         let laplace = [[0,1,0],[1,-4,1],[0,1,0]]
         let size = 3
         var score = 0
-        let threshold = 50
+        let threshold = Self.LAPLACE_THRESHOLD
         for y in 0..<(height - size + 1) {
             for x in 0..<(width - size + 1) {
                 var result = 0
@@ -262,7 +280,7 @@ class FaceAntiSpoofFrameProcessor: FaceAntiSpoofPluginBase {
 
     private static func calculateCombinedScore(neuralScore: Float, laplacianScore: Int) -> Float {
         let normalizedNeural = min(max(neuralScore, 0), 1)
-        let normalizedLaplacian = min(max(Float(laplacianScore) / 4000.0, 0), 1)
+        let normalizedLaplacian = min(max(Float(laplacianScore) / Float(Self.LAPLACIAN_THRESHOLD), 0), 1)
         let neuralWeight: Float = 0.6
         let laplacianWeight: Float = 0.4
         let invertedNeural = 1.0 - normalizedNeural
@@ -271,7 +289,7 @@ class FaceAntiSpoofFrameProcessor: FaceAntiSpoofPluginBase {
 
     private static func calculateConfidence(neuralScore: Float, laplacianScore: Int) -> Float {
         let neuralConfidence = min(max(neuralScore, 0), 1)
-        let laplacianConfidence = min(max(Float(laplacianScore) / 4000.0, 0), 1)
+        let laplacianConfidence = min(max(Float(laplacianScore) / Float(Self.LAPLACIAN_THRESHOLD), 0), 1)
         let invertedNeural = 1.0 - neuralConfidence
         return (invertedNeural * 0.6 + laplacianConfidence * 0.4)
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-vision-camera-spoof-detector",
-  "version": "1.0.26",
+  "version": "1.0.28",
   "description": "High-performance face anti-spoofing and liveness detection module for React Native Vision Camera. Uses TensorFlow Lite with GPU acceleration and optimized YUV processing.",
   "homepage": "https://github.com/dpraful/react-native-vision-camera-spoof-detector",
   "repository": {

package/react-native-vision-camera-spoof-detector.podspec

@@ -18,5 +18,5 @@ Pod::Spec.new do |s|
   s.dependency 'VisionCamera'
 
   # Keep default deployment target and static linkage consistent with RN
-  s.pod_target_xcconfig = { 'EXCLUDED_ARCHS[sdk=iphonesimulator*]' => 'arm64' }
+   s.pod_target_xcconfig = { 'EXCLUDED_ARCHS[sdk=iphonesimulator*]' => 'arm64' }
 end