tnrn-excard v3.0.0

易道博识-图像识别 for React Native.

Getting Started

First, cd to your RN project directory, and install RNMK through rnpm . If you don't have rnpm, you can install RNMK from npm with the command npm i -S tnrn-excard and link it manually (see below).

iOS

• React Native < 0.29 (Using rnpm)

  rnpm install tnrn-excard

• React Native >= 0.29

  $npm install -S tnrn-excard

  $react-native link tnrn-excard

• Notice

  在 Build Settings->Search Paths->Framework Search Paths 中加入路径 $(SRCROOT)/../node_modules/tnrn-excard/ios/Framework

  在 Build Settings->Link->Other Linker Flags 中加入 -framework "ExCardSDK" 和 -framework "ExBankCardSDK"

  最后还需要手动导入 bundle 资源文件：

  在主工程中找到 Libraries 下面的 RNKitExcard，然后找到 Framework 文件夹，鼠标右键 Show in Finder，然后将里面的两个 .bundle 文件拖入主工程中，切记，一定要 勾选 add to targets，不需要勾选 copy items if meed

Android

• React Native < 0.29 (Using rnpm)

  rnpm install tnrn-excard

• React Native >= 0.29

  $npm install -S tnrn-excard

  $react-native link tnrn-excard

Manually

1. JDK 7+ is required

2. Add the following snippet to your android/settings.gradle:

   include ':tnrn-excard'
   project(':tnrn-excard').projectDir = new File(rootProject.projectDir, '../node_modules/tnrn-excard/android/app')

3. Declare the dependency in your android/app/build.gradle

   dependencies {
       ...
       compile project(':tnrn-excard')
   }

4. Import import io.tnrn.excard.EXOCRPackage; and register it in your MainActivity (or equivalent, RN >= 0.32 MainApplication.java):

   @Override
   protected List<ReactPackage> getPackages() {
       return Arrays.asList(
               new MainReactPackage(),
               new EXOCRPackage()
       );
   }

5. Add Module ExBankCardSDK And ExCardSDK In Your Main Project.

Finally, you're good to go, feel free to require tnrn-excard in your JS files.

Have fun! :metal:

Basic Usage

Import library

import RNExcard from 'tnrn-excard';

Init

RNExcard.config({
  DisplayLogo: false
  ....
})

Init Params

OrientationMask

• Portrait
• LandscapeLeft
• LandscapeRight
• PortraitUpsideDown
• Landscape
• MaskAll
• AllButUpsideDown

一、银行卡识别

1. 使用摄像头、相册识别

try {
	const result = await RNExcard.recoBankFromStream();
} catch (error) {
	if (error.code === -1) {
		console.log('on cancel')
	} else {
		console.log(error)
	}
}

2. 使用远程或本地图片识别

try {
	const imagePath = '...';
	const result = await RNExcard.recoBankFromStillImage(imagePath);
} catch (error) {
	if (error.code === -1) {
		console.log('on cancel')
	} else {
		console.log(error)
	}
}

返回值

二、驾驶证识别

1. 使用摄像头、相册识别

try {
	const result = await RNExcard.recoDRCardFromStream();
} catch (error) {
	if (error.code === -1) {
		console.log('on cancel')
	} else {
		console.log(error)
	}
}

2. 使用远程或本地图片识别

try {
	const imagePath = '...';
	const result = await RNExcard.recoDRCardFromStillImage(imagePath);
} catch (error) {
	if (error.code === -1) {
		console.log('on cancel')
	} else {
		console.log(error)
	}
}

返回值

三、行驶证识别

1. 使用摄像头、相册识别

try {
	const result = await RNExcard.recoVECardFromStream();
} catch (error) {
	if (error.code === -1) {
		console.log('on cancel')
	} else {
		console.log(error)
	}
}

2. 使用远程或本地图片识别

try {
	const imagePath = '...';
	const result = await RNExcard.recoVECardFromStillImage(imagePath);
} catch (error) {
	if (error.code === -1) {
		console.log('on cancel')
	} else {
		console.log(error)
	}
}

返回值

四、身份证识别

1. 使用摄像头、相册识别

try {
	const bFront = true  // 身份证方向，true-正面，false-背面
	const result = await RNExcard.recoIDCardFromStreamWithSide(bFront);
} catch (error) {
	if (error.code === -1) {
		console.log('on cancel')
	} else {
		console.log(error)
	}
}

2. 使用远程或本地图片识别

try {
	const imagePath = '...';
	const result = await RNExcard.recoIDCardFromStillImage(imagePath);
} catch (error) {
	if (error.code === -1) {
		console.log('on cancel')
	} else {
		console.log(error)
	}
}

返回值

五、常量

const sdkVersion = RNExcard.sdkVersion;
const kernelVersion = RNExcard.kernelVersion;

六、clean 清理图片临时目录

try {
	const result = await RNExcard.clean();
} catch (error) {
	console.log(error)
}

Contribution

• @simamn The main author.

Questions

Feel free to contact me or create an issue

made with ♥