npmpackage.info

Gathering detailed insights and metrics for @spoonconsulting/cordova-plugin-simple-camera-preview

@spoonconsulting/cordova-plugin-simple-camera-preview - 2.0.44 | npmpackage.info

@spoonconsulting/cordova-plugin-simple-camera-preview

cordova plugin for a showing simple camera preview

2.0.44

Objective-C

127.95 kB

4.1

Installations

npm install @spoonconsulting/cordova-plugin-simple-camera-preview

Developer Guide

BETA

Typescript

No

Module System

N/A

Node Version

20.19.3

NPM Version

10.8.2 Pull Requests

Open

16

Total

113

Closed

14

Merged

83

Issues

Open

0

Total

2

Closed

2

Releases

2.0.41

Updated on May 28, 2025

Add aspect ratio support

2.0.40

Updated on May 23, 2025

Enhance torch error reporting

2.0.39

Updated on May 06, 2025

Android: Change flash state synchronously

2.0.38

Updated on Apr 21, 2025

Improve camera startup delay iOS

2.0.36

Updated on Apr 16, 2025

Add support for switching to the front camera

2.0.33

Updated on Feb 28, 2025

View All 27 releases

Languages

Objective-C

Java

TypeScript

JavaScript

SCSS

HTML

Metal

Objective-C (43.12%)

Java (40.1%)

TypeScript (9.33%)

JavaScript (3.41%)

SCSS (2.01%)

HTML (1.04%)

Metal (0.99%)

Developer

spoonconsulting

Download Statistics

Total Downloads

Last Day

Last Week

Last Month

Last Year

GitHub Statistics

4 Stars

614 Commits

1 Forks

5 Watchers

113 Branches

12 Contributors

Updated on Jul 15, 2025

Maintainers

View All 12 Contributors

Package Meta Information

Latest Version

2.0.44

Package Id

@spoonconsulting/cordova-plugin-simple-camera-preview@2.0.44

Unpacked Size

127.95 kB

Size

25.75 kB

File Count

NPM Version

10.8.2

Node Version

20.19.3

Published on

Jul 15, 2025

Total Downloads

Cumulative downloads

Total Downloads

NaN

Last Day

NaN

Compared to previous day

Last Week

NaN

Compared to previous week

Last Month

NaN

Compared to previous month

Last Year

NaN

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

Cordova Plugin Simple Camera Preview

Cordova plugin that allows simple camera preview and taking pictures from Javascript and HTML

Installation

cordova plugin add https://github.com/spoonconsulting/cordova-plugin-simple-camera-preview.git

ionic cordova plugin add https://github.com/spoonconsulting/cordova-plugin-simple-camera-preview.git

Make the webview html background color transparent.

1html, body, .ion-app, .ion-content {
2  background-color: transparent;
3}

for newer version ionic use the following:

1html, body, .ion-app, .ion-content {
2 --background: transparent;
3}
4

Make sure to set up the camera size as follows:

1const aspectRatio = 3/4; // or 9/16
2const cameraSize = this.getCameraSize(aspectRatio);
3
4getCameraSize(aspectRatio) {
5    let height;
6    let width;
7    const ratio = 4 / 3;
8    const min = Math.min(window.innerWidth, window.innerHeight);
9
10    [width, height] = [min, Math.round(min / aspectRatio)];
11    if (this.isLandscape()) {
12      [width, height] = [height, width];
13    }
14
15    return {
16      x: (window.innerWidth - width) / 2,
17      y: (window.innerHeight - height) / 2,
18      width,
19      height,
20    };    
21}
22
23isLandscape() {
24    return Math.abs(window.orientation % 180) === 90;
25}
26

Android

Uses Google's CameraX API

Methods

enable(options, successCallback, errorCallback)

Starts the camera preview instance.

1const params = {
2  targetSize: 1024,
3  lens: 'auto', // Camera lens (auto or wide). Default is auto.
4  direction: 'back', // Camera direction (front or back). Default is back.
5  aspectRatio: '3:4', // Camera aspect ratoio (3:4 or 9:16). Default is 3:4.
6  ...cameraSize,
7}
8
9SimpleCameraPreview.enable(params, () => {
10  console.log("Camera enabled");
11});

disable(successCallback, errorCallback)

Stops the camera preview instance.

1SimpleCameraPreview.disable(params, () => {
2  console.log("Camera disabled");
3});

capture(options, successCallback, errorCallback)

Take the picture

1let options = {
2  flash: true,
3};
4
5SimpleCameraPreview.capture(options, (imagaeNativePath) => {
6  console.log(imagaeNativePath);
7});

setSize(options, successCallback, errorCallback)

Set the camera frame size

1let size = {
2  x: 0,
3  y: 0,
4  width: 1080,
5  height: 1920,
6};
7
8SimpleCameraPreview.setSize(size, () => {
9  console.log("Camera frame size set");
10});

deviceHasUltraWideCamera(successCallback, errorCallback)

Check if device has ultra-wide camera

1
2SimpleCameraPreview.deviceHasUltraWideCamera(size, (value: boolean) => {
3  console.log("Device has ultra-wide camera?: ", value);
4});

switchCameraTo(options, successCallback, errorCallback)

Switch camera between wide or auto and set the camera direction (front or back) dynamically. Change camera aspect ratio.

The options variable can take the following keys:

Available options:

lens:
- "wide" – Use a wide-angle lens.
- "auto" – Automatically select the best available lens.
direction:
- "front" – Use the front-facing camera.
- "back" – Use the rear-facing camera.
aspectRatio:
- "3:4" – Display 3/4 preview.
- "9:16" – Display 9/16 preview.

Note:

Currently, the wide-angle lens functionality is not supported for the front-facing camera. If the lens is set to "wide" and the direction is set to "front", the camera will default to the "auto" lens instead of switching to the wide lens.

1const params = {
2  lens: "wide",
3  direction: "back", // Specify camera direction
4  aspectRatio: "9:16", 
5  ...cameraSize,
6};
7
8SimpleCameraPreview.switchCameraTo(
9  params, 
10  (value: unknown) => {
11    return (typeof value === "boolean" ? value : false);
12  },
13  (e: unknown) => {
14    console.log("cannot switch camera: ", e);
15  }
16);

No vulnerabilities found.

10

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

Maintained

Determines if the project is "actively maintained".

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

0

Security-Policy

Determines if the project has published a security policy.

0

License

Determines if the project has defined a license.

0

Fuzzing

Determines if the project uses fuzzing.

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

0

SAST

Determines if the project uses static code analysis.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Score

4.1

/10

Last Scanned on 2025-07-07

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More