vision-camera-remove-background
TypeScript icon, indicating that this package has built-in type declarations

1.4.1 • Public • Published

📚 Introduction

vision-camera-remove-background is a React Native library that integrates with the Vision Camera module to provide face detection functionality. It allows you to easily detect faces in real-time using the front camera and visualize the detected faces on the screen.

If you like this package please give it a ⭐ on GitHub.

🏗️ Features

  • Real-time face detection using front camera
  • Integration with Vision Camera library
  • Adjustable face visualization with customizable styles
  • Base64 frame convertion

🧰 Installation

yarn add vision-camera-remove-background

Then you need to add react-native-worklets-core plugin to babel.config.js. More details here.

💡 Usage

Recommended way:

import {
  StyleSheet,
  Text,
  View
} from 'react-native'
import {
  useEffect,
  useState
} from 'react'
import {useCameraDevice} from 'react-native-vision-camera'
import {
  Camera,
  DetectionResult
} from 'vision-camera-remove-background'
import { Worklets } from 'react-native-worklets-core'

export default function App() {
  const device = useCameraDevice('front')

  useEffect(() => {
    (async () => {
      const status = await Camera.requestCameraPermission()
      console.log({ status })
    })()
  }, [device])

  const handleFacesDetection = Worklets.createRunInJsFn( (
    result: DetectionResult
  ) => {
    console.log( 'detection result', result )
  })

  return (
    <View style={{ flex: 1 }}>
      {!!device? <Camera
        style={StyleSheet.absoluteFill}
        device={device}
        faceDetectionCallback={ handleFacesDetection }
        faceDetectionOptions={ {
          // detection settings
        } }
      /> : <Text>
        No Device
      </Text>}
    </View>
  )
}

Or default way:

import {
  StyleSheet,
  Text,
  View
} from 'react-native'
import {
  useEffect,
  useState
} from 'react'
import {
  Camera,
  useCameraDevice,
  useFrameProcessor
} from 'react-native-vision-camera'
import {
  detectFaces,
  DetectionResult
} from 'vision-camera-remove-background'
import { Worklets } from 'react-native-worklets-core'

export default function App() {
  const device = useCameraDevice('front')

  useEffect(() => {
    (async () => {
      const status = await Camera.requestCameraPermission()
      console.log({ status })
    })()
  }, [device])

  const handleFacesDetection = Worklets.createRunInJsFn( (
    result: DetectionResult
  ) => {
    console.log( 'detection result', result )
  })
  const frameProcessor = useFrameProcessor((frame) => {
    'worklet'
    detectFaces(
      frame,
      handleFacesDetection, {
        // detection settings
      }
    )
  }, [handleFacesDetection])

  return (
    <View style={{ flex: 1 }}>
      {!!device? <Camera
        style={StyleSheet.absoluteFill}
        device={device}
        frameProcessor={frameProcessor}
      /> : <Text>
        No Device
      </Text>}
    </View>
  )
}

OBS: Returned face bounds are relative to image size not to device screen size so you need to scale it by multiplying desired bounds data by screen size divided by frame size: bounds.X * (deviceWidth|Height / frame.width|height).

See example app for more details.

🔧 Troubleshooting

Here is a common issue when trying to use this package and how you can try to fix it:

  • Regular javascript function cannot be shared. Try decorating the function with the 'worklet' keyword...:
    • If you're using react-native-reanimated maybe you're missing this step.

If you find other errors while using this package you're wellcome to open a new issue or create a PR with the fix.

👷 Built With

🔎 About

This package was tested using the following:

  • react-native: 0.73.4 (new arch disabled)
  • react-native-vision-camera: 3.9.0
  • react-native-worklets-core: 0.3.0
  • react-native-reanimated: 3.6.2
  • expo: 50.0.7

Min Android/IOS versions:

  • Android SDK: 26 (Android 8)
  • IOS: 13.4

📚 Author

Made with ❤️ by nonam4.

Package Sidebar

Install

npm i vision-camera-remove-background

Weekly Downloads

33

Version

1.4.1

License

MIT

Unpacked Size

116 kB

Total Files

38

Last publish

Collaborators

  • jrh0203