![npm][npm-badge]
![downloads][downloads-badge]

react-camera-pro

Universal Camera component for React.

Designed with focus on Android and iOS cameras.
Works with standard webcams as well.

See this for browser compatibility.

Note: WebRTC is only supported on secure connections. So you need to serve it from https. You can test and debug in Chrome from localhost though (this doesn't work in Safari).

Features

- mobile friendly camera solution (tested on iOS and Android)
- video element is fully responsive
- you can setup parameter to cover your container
- you can define aspectRatio of view: 16/9, 4/3, 1/1, ...
- taking photo to base64 jpeg file - with same aspect Ratio as view, with FullHD resolution (or maximum supported by camera).
- working with standard webcams or other video input devices
- supports autofocus
- switching facing/environment cameras (with your own button)
- detect number of cameras
- facing camera is mirrored, environment is not
- controlled by react Ref
- public functions to take photo, to switch camera and to get number of cameras
- typescript library

Installation

``
npm install --save react-camera-pro
`

Demo

https://purple-technology.github.io/react-camera-pro/

Example

https://github.com/purple-technology/react-camera-pro/blob/master/example/src/App.tsx

Usage

`javascript
import React, { useState, useRef } from "react";
import {Camera} from "react-camera-pro";

const Component = () => {
const camera = useRef(null);
const [image, setImage] = useState(null);

return (




setImage(camera.current.takePhoto())}>Take photo



export Component;
`

$3

| prop | type | default | notes |
| ----------------------- | -------------------------------- | ------------ | ---------------------------------------------- |
| facingMode | 'user'\|'environment' | 'user' | default camera - 'user' or 'environment' |
| aspectRatio | 'cover'\|number | 'cover' | aspect ratio of video (16/9, 4/3); |
| numberOfCamerasCallback | (numberOfCameras: number):void | () => null | callback is called if number of cameras change |
| errorMessages | object? see below | see below | Error messages object (optional) |

#### Error messages (prop errorMessages)

Type:

`
errorMessages: {
noCameraAccessible?: string;
permissionDenied?: string;
switchCamera?: string;
canvas?: string;
};
`

Default:
`
{
noCameraAccessible: 'No camera device accessible. Please connect your camera or try a different browser.',
permissionDenied: 'Permission denied. Please refresh and give camera permission.',
switchCamera:
'It is not possible to switch camera to different one because there is only one video device accessible.',
canvas: 'Canvas is not supported.'
}
`

$3

- takePhoto(): string - Returns a base64 encoded string of the taken image.
- switchCamera(): 'user'|'environment' - Switches the camera - user to environment or environment to user. Returns the new value 'user' or 'environment'.
- getNumberOfCameras(): number - Returns number of available cameras.

See demo

See example code

`javascript

const Component = () => {
const camera = useRef(null);
const [numberOfCameras, setNumberOfCameras] = useState(0);
const [image, setImage] = useState(null);

//...

return (


onClick={() => {
const photo = camera.current.takePhoto();
setImage(photo);
}}
/>
hidden={numberOfCameras <= 1}
onClick={() => {
camera.current.switchCamera();
}}
/>
)
`

Camera options

$3

`javascript
const Cam = () =>
`

$3

`javascript
const Cam = () => ;
`

Using within an iframe

`