Skip to main content

Camera

A powerful <Camera> component.​

Read the VisionCamera documentation for more information.

The <Camera> component's most important (and therefore required) properties are:

  • device: Specifies the CameraDevice to use. Get a CameraDevice by using the useCameraDevices() hook, or manually by using the Camera.getAvailableCameraDevices() function.
  • isActive: A boolean value that specifies whether the Camera should actively stream video frames or not. This can be compared to a Video component, where isActive specifies whether the video is paused or not. If you fully unmount the <Camera> component instead of using isActive={false}, the Camera will take a bit longer to start again.

Example

function App() {
const devices = useCameraDevices('wide-angle-camera')
const device = devices.back

if (device == null) return <LoadingView />
return (
<Camera
style={StyleSheet.absoluteFill}
device={device}
isActive={true}
/>
)
}

Component

Hierarchy​

Methods​

focus​

â–¸ focus(point): Promise<void>

Focus the camera to a specific point in the coordinate system.

Throws

CameraRuntimeError When any kind of error occured while focussing. Use the code property to get the actual error

Example

await camera.current.focus({
x: tapEvent.x,
y: tapEvent.y
})

Parameters​

NameTypeDescription
pointPointThe point to focus to. This should be relative to the Camera view's coordinate system, and expressed in Pixel on iOS and Points on Android. (0, 0) means top left. (CameraView.width, CameraView.height) means bottom right. Make sure the value doesn't exceed the CameraView's dimensions.

Returns​

Promise<void>

Defined in​

Camera.tsx:290


getAvailableVideoCodecs​

â–¸ getAvailableVideoCodecs(fileType?): Promise<CameraVideoCodec[]>

Get a list of video codecs the current camera supports for a given file type. Returned values are ordered by efficiency (descending).

Example

const codecs = await camera.current.getAvailableVideoCodecs("mp4")

Throws

CameraRuntimeError When any kind of error occured while getting available video codecs. Use the ParameterError.code | code property to get the actual error

Platform

iOS

Parameters​

NameType
fileType?VideoFileType

Returns​

Promise<CameraVideoCodec[]>

Defined in​

Camera.tsx:308


pauseRecording​

â–¸ pauseRecording(): Promise<void>

Pauses the current video recording.

Throws

CameraCaptureError When any kind of error occured while pausing the video recording. Use the code property to get the actual error

Example

// Start
await camera.current.startRecording()
await timeout(1000)
// Pause
await camera.current.pauseRecording()
await timeout(500)
// Resume
await camera.current.resumeRecording()
await timeout(2000)
// Stop
const video = await camera.current.stopRecording()

Returns​

Promise<void>

Defined in​

Camera.tsx:215


resumeRecording​

â–¸ resumeRecording(): Promise<void>

Resumes a currently paused video recording.

Throws

CameraCaptureError When any kind of error occured while resuming the video recording. Use the code property to get the actual error

Example

// Start
await camera.current.startRecording()
await timeout(1000)
// Pause
await camera.current.pauseRecording()
await timeout(500)
// Resume
await camera.current.resumeRecording()
await timeout(2000)
// Stop
const video = await camera.current.stopRecording()

Returns​

Promise<void>

Defined in​

Camera.tsx:243


startRecording​

â–¸ startRecording(options): void

Start a new video recording.

Records in the following formats:

  • iOS: QuickTime (.mov)
  • Android: MPEG4 (.mp4)

Blocking

This function is synchronized/blocking.

Throws

CameraCaptureError When any kind of error occured while starting the video recording. Use the code property to get the actual error

Example

camera.current.startRecording({
onRecordingFinished: (video) => console.log(video),
onRecordingError: (error) => console.error(error),
})
setTimeout(() => {
camera.current.stopRecording()
}, 5000)

Parameters​

NameType
optionsRecordVideoOptions

Returns​

void

Defined in​

Camera.tsx:178


stopRecording​

â–¸ stopRecording(): Promise<void>

Stop the current video recording.

Throws

CameraCaptureError When any kind of error occured while stopping the video recording. Use the code property to get the actual error

Example

await camera.current.startRecording()
setTimeout(async () => {
const video = await camera.current.stopRecording()
}, 5000)

Returns​

Promise<void>

Defined in​

Camera.tsx:264


takePhoto​

â–¸ takePhoto(options?): Promise<PhotoFile>

Take a single photo and write it's content to a temporary file.

Throws

CameraCaptureError When any kind of error occured while capturing the photo. Use the code property to get the actual error

Example

const photo = await camera.current.takePhoto({
qualityPrioritization: 'quality',
flash: 'on',
enableAutoRedEyeReduction: true
})

Parameters​

NameType
options?TakePhotoOptions

Returns​

Promise<PhotoFile>

Defined in​

Camera.tsx:121


takeSnapshot​

â–¸ takeSnapshot(options?): Promise<PhotoFile>

Take a snapshot of the current preview view.

This can be used as an alternative to takePhoto() if speed is more important than quality

Throws

CameraCaptureError When any kind of error occured while taking a snapshot. Use the code property to get the actual error

Platform

Android

Example

const photo = await camera.current.takeSnapshot({
quality: 85,
skipMetadata: true
})

Parameters​

NameType
options?TakeSnapshotOptions

Returns​

Promise<PhotoFile>

Defined in​

Camera.tsx:145


getAvailableCameraDevices​

â–¸ Static getAvailableCameraDevices(): Promise<CameraDevice[]>

Get a list of all available camera devices on the current phone.

Throws

CameraRuntimeError When any kind of error occured while getting all available camera devices. Use the code property to get the actual error

Example

const devices = await Camera.getAvailableCameraDevices()
const filtered = devices.filter((d) => matchesMyExpectations(d))
const sorted = devices.sort(sortDevicesByAmountOfCameras)
return {
back: sorted.find((d) => d.position === "back"),
front: sorted.find((d) => d.position === "front")
}

Returns​

Promise<CameraDevice[]>

Defined in​

Camera.tsx:334


getCameraPermissionStatus​

â–¸ Static getCameraPermissionStatus(): Promise<CameraPermissionStatus>

Gets the current Camera Permission Status. Check this before mounting the Camera to ensure the user has permitted the app to use the camera.

To actually prompt the user for camera permission, use requestCameraPermission().

Throws

CameraRuntimeError When any kind of error occured while getting the current permission status. Use the code property to get the actual error

Returns​

Promise<CameraPermissionStatus>

Defined in​

Camera.tsx:349


getMicrophonePermissionStatus​

â–¸ Static getMicrophonePermissionStatus(): Promise<CameraPermissionStatus>

Gets the current Microphone-Recording Permission Status. Check this before mounting the Camera to ensure the user has permitted the app to use the microphone.

To actually prompt the user for microphone permission, use requestMicrophonePermission().

Throws

CameraRuntimeError When any kind of error occured while getting the current permission status. Use the code property to get the actual error

Returns​

Promise<CameraPermissionStatus>

Defined in​

Camera.tsx:364


requestCameraPermission​

â–¸ Static requestCameraPermission(): Promise<CameraPermissionRequestResult>

Shows a "request permission" alert to the user, and resolves with the new camera permission status.

If the user has previously blocked the app from using the camera, the alert will not be shown and "denied" will be returned.

Throws

CameraRuntimeError When any kind of error occured while requesting permission. Use the code property to get the actual error

Returns​

Promise<CameraPermissionRequestResult>

Defined in​

Camera.tsx:379


requestMicrophonePermission​

â–¸ Static requestMicrophonePermission(): Promise<CameraPermissionRequestResult>

Shows a "request permission" alert to the user, and resolves with the new microphone permission status.

If the user has previously blocked the app from using the microphone, the alert will not be shown and "denied" will be returned.

Throws

CameraRuntimeError When any kind of error occured while requesting permission. Use the code property to get the actual error

Returns​

Promise<CameraPermissionRequestResult>

Defined in​

Camera.tsx:394