Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/tony-xlh/capacitor-plugin-dynamsoft-barcode-reader

capacitor-plugin-dynamsoft-barcode-reader
https://github.com/tony-xlh/capacitor-plugin-dynamsoft-barcode-reader

barcode capacitor ionic qrcode typescript

Last synced: 2 months ago
JSON representation

capacitor-plugin-dynamsoft-barcode-reader

Awesome Lists containing this project

README

        

# capacitor-plugin-dynamsoft-barcode-reader

![version](https://img.shields.io/npm/v/capacitor-plugin-dynamsoft-barcode-reader.svg)

A capacitor plugin for [Dynamsoft Barcode Reader](https://www.dynamsoft.com/barcode-reader/overview/).

## Install

```bash
npm install capacitor-plugin-dynamsoft-barcode-reader
npx cap sync
```

## Supported Platforms

* Android
* iOS
* Web

## Capacitor Versions

For Capacitor 6, use 2.x.

For Capacitor <= 5, use 1.x.

## SDK Versions Used for Different Platforms

| Product | Android | iOS | Web |
| ----------- | ----------- | ----------- | ------- |
| Dynamsoft Barcode Reader | 10.4.20 | 10.4.20 | 10.4.20 |

## Supported Barcode Symbologies

* Code 11
* Code 39
* Code 93
* Code 128
* Codabar
* EAN-2
* EAN-5
* EAN-8
* EAN-13
* UPC-A
* UPC-E
* UPC-2
* UPC-5
* Interleaved 2 of 5 (ITF)
* Industrial 2 of 5 (Code 2 of 5 Industry, Standard 2 of 5, Code 2 of 5)
* ITF-14
* QRCode
* DataMatrix
* PDF417
* GS1 DataBar
* Maxicode
* Micro PDF417
* Micro QR
* PatchCode
* GS1 Composite
* Postal Code
* Dot Code
* Pharmacode

## Demos

* [Ionic React](https://github.com/xulihang/Ionic-React-QR-Code-Scanner)
* [Quasar + Vue 2](https://github.com/tony-xlh/Quasar-QR-Code-Scanner)
* [Ionic + Vue 3](https://github.com/tony-xlh/Ionic-Vue-QR-Code-Scanner)
* [Vanilla JS](https://github.com/xulihang/capacitor-qr-code-scanner)

## API

* [`initLicense(...)`](#initlicense)
* [`initialize()`](#initialize)
* [`initRuntimeSettingsFromString(...)`](#initruntimesettingsfromstring)
* [`decode(...)`](#decode)
* [`decodeBitmap(...)`](#decodebitmap)
* [`setEngineResourcePaths(...)`](#setengineresourcepaths)
* [Interfaces](#interfaces)

### initLicense(...)

```typescript
initLicense(options: { license: string; }) => Promise<{ success?: boolean; message?: string; }>
```

| Param | Type |
| ------------- | --------------------------------- |
| **`options`** | { license: string; } |

**Returns:** Promise<{ success?: boolean; message?: string; }>

--------------------

### initialize()

```typescript
initialize() => Promise<{ success?: boolean; message?: string; }>
```

**Returns:** Promise<{ success?: boolean; message?: string; }>

--------------------

### initRuntimeSettingsFromString(...)

```typescript
initRuntimeSettingsFromString(options: { template: string; }) => Promise
```

| Param | Type |
| ------------- | ---------------------------------- |
| **`options`** | { template: string; } |

--------------------

### decode(...)

```typescript
decode(options: { source: string | HTMLImageElement | HTMLCanvasElement | HTMLVideoElement; template?: string; }) => Promise<{ results: TextResult[]; }>
```

source: Android and iOS only support base64 string.
path: for Android and iOS.
template: pass a template name to specify the template

| Param | Type |
| ------------- | ------------------------------------------------ |
| **`options`** | { source: any; template?: string; } |

**Returns:** Promise<{ results: TextResult[]; }>

--------------------

### decodeBitmap(...)

```typescript
decodeBitmap(options: { className?: string; methodName?: string; template?: string; }) => Promise<{ results: TextResult[]; }>
```

Android and iOS only method which directly read camera frames from capacitor-plugin-camera

| Param | Type |
| ------------- | ---------------------------------------------------------------------------- |
| **`options`** | { className?: string; methodName?: string; template?: string; } |

**Returns:** Promise<{ results: TextResult[]; }>

--------------------

### setEngineResourcePaths(...)

```typescript
setEngineResourcePaths(options: { paths: any; }) => Promise
```

Web only method to set the engine resource path

| Param | Type |
| ------------- | ---------------------------- |
| **`options`** | { paths: any; } |

--------------------

### Interfaces

#### TextResult

| Prop | Type |
| ------------------------ | ------------------- |
| **`barcodeText`** | string |
| **`barcodeFormat`** | string |
| **`barcodeBytesBase64`** | string |
| **`x1`** | number |
| **`y1`** | number |
| **`x2`** | number |
| **`y2`** | number |
| **`x3`** | number |
| **`y3`** | number |
| **`x4`** | number |
| **`y4`** | number |