https://github.com/appandflow/expo-camera-characteristics
This library exposes the rear camera's characteristics such as the sensor size, the focal length and the image resolution.
https://github.com/appandflow/expo-camera-characteristics
camera expo react-native
Last synced: 3 months ago
JSON representation
This library exposes the rear camera's characteristics such as the sensor size, the focal length and the image resolution.
- Host: GitHub
- URL: https://github.com/appandflow/expo-camera-characteristics
- Owner: AppAndFlow
- Created: 2023-04-14T21:34:53.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2025-01-08T16:00:03.000Z (over 1 year ago)
- Last Synced: 2025-05-07T11:15:07.695Z (about 1 year ago)
- Topics: camera, expo, react-native
- Language: Java
- Homepage: https://www.npmjs.com/package/@appandflow/expo-camera-characteristics?activeTab=readme
- Size: 1.19 MB
- Stars: 5
- Watchers: 3
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
### About
App & Flow is a Montreal-based React Native engineering and consulting studio. We partner with the world’s top companies and are recommended by [Expo](https://expo.dev/consultants). Need a hand? Let’s build together. team@appandflow.com
[](https://www.npmjs.com/package/@appandflow/expo-camera-characteristics)
This library exposes the rear camera's characteristics such as the sensor size, the focal length and the image resolution.
**On Android**, the Camera2 module is used to get the camera characteristics programmatically.
**On iOS**, there is no accessible module to do so (see https://stackoverflow.com/questions/13190932/how-to-find-out-focal-length-of-camera-in-ios-and-what-is-the-sensor-height for the existing work around), therefore, the values returned by this library are hardcoded here: https://github.com/AppAndFlow/expo-camera-characteristics/blob/main/src/iPhoneSpecs.ts. We'll try to maintain that list of devices up to date as much as possible.
# Installation
For Expo SDK <= 48 use <= `expo-camera-characteristics 1.0.0`
This library needs `expo-device` for iOS.
```
npx expo install @appandflow/expo-camera-characteristics expo-device
```
> This package cannot be used in the "Expo Go" app because [it requires custom native code](https://docs.expo.dev/workflow/customizing/).
After installing this npm package, add the [config plugin](https://docs.expo.dev/config-plugins/introduction/) to the [`plugins`](https://docs.expo.dev/versions/latest/config/app/#plugins) array of your `app.json` or `app.config.js`:
```JSON
{
"expo": {
"plugins": [["@appandflow/expo-camera-characteristics", {}]]
}
}
```
And finally, rebuild your app as described in the ["Adding custom native code"](https://docs.expo.dev/workflow/customizing/) guide.
```
npx expo prebuild
```
# API documentation
## getCameraCharacteristics()
```TS
import * as expoCameraCharacteristics from "@appandflow/expo-camera-characteristics";
const cameraCharacteristics: {
focalLength: number;
sensorSize: {
height: number;
width: number;
};
imageResolution: {
height: number;
width: number;
};
} = expoCameraCharacteristics.getCameraCharacteristics();
```