Skip to main content

Function: useCamera()

useCamera(): object

Defined in: packages/react-native-client/src/hooks/useCamera.ts:121

This hook can toggle camera on/off and provides current camera state.

Returns

object

cameras

cameras: readonly Camera[]

Property that lists cameras available on device.

Returns

A promise that resolves to the list of available cameras.

currentCamera

currentCamera: null | Camera

Which camera is now used for streaming (or will be used as default when camera will be enabled)

isCameraOn

isCameraOn: boolean

Informs if user camera is streaming video

isInitialized

isInitialized: boolean = isCameraInitialized

A value indicating if camera was already initialized (if prepareCamera was called).

prepareCamera()

prepareCamera: (config) => Promise<boolean>

Prepares camera and starts local video track

Parameters

ParameterTypeDescription
configReadonly<CameraConfig>configuration of the camera capture

Returns

Promise<boolean>

A promise that resolves when camera is started.

simulcastConfig

simulcastConfig: SimulcastConfig

Simulcast configuration

switchCamera()

switchCamera: (cameraId) => Promise<void>

Switches to the specified camera. List of available devices can be retrieved from cameras variable

Parameters

ParameterType
cameraIdCameraId

Returns

Promise<void>

A promise that resolves when camera is switched.

toggleCamera()

toggleCamera: () => Promise<void>

Enable/disable current camera

Returns

Promise<void>