@exapps/camera-preview v6.2.22

Capacitor Camera Preview Plugin

This plugin is compatible Capacitor 6 and above.

Use v5 for Capacitor 5 and below.

PR's are greatly appreciated.

-- @riderx, current maintainers

Installation

yarn add @capgo/camera-preview

or

npm install @capgo/camera-preview

Then run

npx cap sync

Extra Android installation steps

Important camera-preview 3+ requires Gradle 7. Open android/app/src/main/AndroidManifest.xml and above the closing </manifest> tag add this line to request the CAMERA permission:

<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

For more help consult the Capacitor docs.

Extra iOS installation steps

You will need to add two permissions to Info.plist. Follow the Capacitor docs and add permissions with the raw keys NSCameraUsageDescription and NSMicrophoneUsageDescription. NSMicrophoneUsageDescription is only required, if audio will be used. Otherwise set the disableAudio option to true, which also disables the microphone permission request.

Extra Web installation steps

Add import '@capgo/camera-preview' to you entry script in ionic on app.module.ts, so capacitor can register the web platform from the plugin

API

• start(...)
• stop()
• capture(...)
• captureSample(...)
• getSupportedFlashModes()
• getHorizontalFov()
• setFlashMode(...)
• flip()
• setOpacity(...)
• stopRecordVideo()
• startRecordVideo(...)
• Interfaces
• Type Aliases

start(...)

start(options: CameraPreviewOptions) => Promise<void>

Start the camera preview instance.

Since: 0.0.1

stop()

stop() => Promise<void>

Stop the camera preview instance.

Since: 0.0.1

capture(...)

capture(options: CameraPreviewPictureOptions) => Promise<{ value: string; }>

Switch camera.

Returns: Promise<{ value: string; }>

Since: 0.0.1

captureSample(...)

captureSample(options: CameraSampleOptions) => Promise<{ value: string; }>

Capture a sample image.

Returns: Promise<{ value: string; }>

Since: 0.0.1

getSupportedFlashModes()

getSupportedFlashModes() => Promise<{ result: CameraPreviewFlashMode[]; }>

Get supported flash modes.

Returns: Promise<{ result: CameraPreviewFlashMode[]; }>

Since: 0.0.1

getHorizontalFov()

getHorizontalFov() => Promise<{ result: any; }>

Get horizontal field of view.

Returns: Promise<{ result: any; }>

Since: 0.0.1

setFlashMode(...)

setFlashMode(options: { flashMode: CameraPreviewFlashMode | string; }) => Promise<void>

Set flash mode.

Since: 0.0.1

flip()

flip() => Promise<void>

Flip camera.

Since: 0.0.1

setOpacity(...)

setOpacity(options: CameraOpacityOptions) => Promise<void>

Set opacity.

Since: 0.0.1

stopRecordVideo()

stopRecordVideo() => Promise<{ videoFilePath: string; }>

Stop recording video.

Returns: Promise<{ videoFilePath: string; }>

Since: 0.0.1

startRecordVideo(...)

startRecordVideo(options: CameraPreviewOptions) => Promise<void>

Start recording video.

Since: 0.0.1

Interfaces

CameraPreviewOptions

CameraPreviewPictureOptions

CameraSampleOptions

CameraOpacityOptions

Type Aliases

CameraPosition

"rear" | "front"

PictureFormat

"jpeg" | "png"

CameraPreviewFlashMode

"off" | "on" | "auto" | "red-eye" | "torch"