README SETUP DEVICES FORMATS FRAME_PROCESSORS ANIMATED ERRORS

Setup

## Installing the library Install react-native-vision-camera through npm: ```sh npm i react-native-vision-camera npx pod-install ``` ## Updating manifests To use a Camera or Microphone you must first specify that your app requires camera and microphone permissions. ### iOS Open your project's `Info.plist` and add the following lines inside the outermost `` tag: ```xml NSCameraUsageDescription $(PRODUCT_NAME) needs access to your Camera to record videos and capture photos. NSMicrophoneUsageDescription $(PRODUCT_NAME) needs access to your Microphone to record videos with audio. ``` You also may need to: - add a Swift file to your project so that Xcode creates a bridging header - remove explicit Swift 5.0 references in the `LIBRARY_SEARCH_PATH` list as per [this StackOverflow answer](https://stackoverflow.com/a/66281846/1123156) > See [TROUBLESHOOTING.md](./TROUBLESHOOTING.md) if you're having problems ### Android Open your project's `AndroidManifest.xml` and add the following lines inside the `` tag: ```xml ``` ## Permissions react-native-vision-camera also provides functions to easily get and request Microphone and Camera permissions. ### Getting Permissions Simply use the **get** functions to find out if a user has granted or denied permission before: ```ts const cameraPermission = await Camera.getCameraPermissionStatus() const microphonePermission = await Camera.getMicrophonePermissionStatus() ``` A permission status can have the following values: * `authorized`: Your app is authorized to use said permission. Continue with mounting the `` view. * `not-determined`: Your app has not yet requested permission from the user. [Continue by calling the **request** functions.](#requesting-permissions) * `denied`: Your app has already requested permissions from the user, but was explicitly denied. You cannot use the **request** functions again, but you can use the [`Linking` API](https://reactnative.dev/docs/linking#opensettings) to redirect the user to the Settings App where he can manually grant the permission. * `restricted`: (iOS only) Your app cannot use the Camera or Microphone because that functionality has been restricted, possibly due to active restrictions such as parental controls being in place. ### Requesting Permissions Use the **request** functions to prompt the user to give your app permission to use the Camera or Microphone. > Note: You can only use **request** functions if the current permission status is `not-determined`. ```ts const newCameraPermission = await Camera.requestCameraPermission() const newMicrophonePermission = await Camera.requestMicrophonePermission() ``` The permission request status can have the following values: * `authorized`: Your app is authorized to use said permission. Continue with mounting the `` view. * `denied`: Your app has already requested permissions from the user, but was explicitly denied. You cannot use the **request** functions again, but you can use the [`Linking` API](https://reactnative.dev/docs/linking#opensettings) to redirect the user to the Settings App where he can manually grant the permission.
#### 🎉 Hooray! You're ready to learn about [devices](./DEVICES.md)!