ImageRecognizer API

ImageRecognizer.RecognitionListener() {
  /**
    * 인식에 성공하여 결과값 전달
    * @param resultText 인식 결과 데이터
    * @param rrnRect 주민등록번호 마스킹 영역
    * @param licenseNumberRect 운전면허번호 마스킹 영역
    * @param photoRect 증명사진 영역
    * @param persImage 결과 이미지
    * @param isValidCard 흑백 복사본 판별, 흑백복사본인 경우 false
    * @param isValidRegistrationNumber 주민등록번호/외국인등록번호 유효성 여부
    * @param isValidArea 신분증 영역 검출 여부
    */
  @Override
  public void onFinish(ArrayList resultText, Rect rrnRect, Rect licenseNumberRect, Rect photoRect, Bitmap persImage,
                        boolean isValidCard, boolean isValidRegistrationNumber, boolean isValidArea) {

  /**
    * 인식에 실패
    * @param code 오류코드
    *              {@link ImageRecognizer#ERROR_CODE_FAIL}: 인식 실패
    *              {@link ImageRecognizer#ERROR_CODE_FILE_NOT_FOUND}: ROM 파일을 찾지 못함
    *              {@link ImageRecognizer#ERROR_CODE_LICENSE_CHECK_FAILED}: 라이선스 만료
    *              {@link ImageRecognizer#ERROR_CODE_REGISTRATION_NUMBER_FAIL}: 주민등록번호 인식 실패
    *              {@link ImageRecognizer#ERROR_CODE_LICENSE_NUMBER_FAIL}: 운전면허번호 인식 실패
    */
  @Override
  public void onError(int code) {
  }
};

// 인식엔진 생성자
ImageRecognizer(Context context)
// 인식엔진 생성자(결과 암호화)
ImageRecognizer(Context context, byte[] encryptKey, byte[] encryptIV)
// 입력된 이미지를 인식하고 그 결과를 리스너로 반환
void startRecognition(Bitmap input, RecognitionListener recognitionListener)
// 입력된 카메라 프리뷰 이미지를 인식하고 그 결과를 리스너로 반환
void startRTRRecognition(byte[] data, int width, int height, Rect guideRect, int cameraOrientation, RecognitionListener recognitionListener)
// 인식기 메모리 해제
void release()

ImageRecognizer mImageRecognizer = new ImageRecognizer(getApplicationContext());

byte[] mEncryptKey = {'s', 'e', 'l', 'v', 'a', 's', 'a', 'i' ...};
byte[] mEncryptIV = {'s', 'e', 'l', 'v', 'a', 's', 'a', 'i' ...};
ImageRecognizer mImageRecognizer = new ImageRecognizer(getApplicationContext(), mEncryptKey, mEncryptIV);

ImageRecognizer mImageRecognizer = new ImageRecognizer(getApplicationContext());
Bitmap inputImage = BitmapFactory.decodeFile("/path/to/image.jpg");
ImageRecognizer.RecognitionListener mRecognitionListener = new ImageRecognizer.RecognitionListener() {...);
mImageRecognizer.startRecognition(inputImage, mRecognitionListener);
                

ImageRecognizer mImageRecognizer = new ImageRecognizer(getApplicationContext());
ImageRecognizer.RecognitionListener mRecognitionListener = new ImageRecognizer.RecognitionListener() {...);
mImageRecognizer.startRTRRecognition(previewData, previewWidth, previewHeight, mGuideRect, mCameraOrientation, mRecognitionListener);

mImageRecognizer.release();

mImageRecognizer = new ImageRecognizer(getApplicationContext(), mEncryptKey, mEncryptIV);
mImageRecognizer.maskInputImage(true);

byte[] mEncryptKey = {'s', 'e', 'l', 'v', 'a', 's', 'a', 'i' ...};
byte[] mEncryptIV = {'s', 'e', 'l', 'v', 'a', 's', 'a', 'i' ...};
ImageRecognizer.encrypt("text", mEncryptKey, mEncryptIV);

byte[] mEncryptKey = {'s', 'e', 'l', 'v', 'a', 's', 'a', 'i' ...};
byte[] mEncryptIV = {'s', 'e', 'l', 'v', 'a', 's', 'a', 'i' ...};
String decodedText = ImageRecognizer.decrypt("encrypted_text", mEncryptKey, mEncryptIV);

byte[] mEncryptKey = {'s', 'e', 'l', 'v', 'a', 's', 'a', 'i' ...};
byte[] mEncryptIV = {'s', 'e', 'l', 'v', 'a', 's', 'a', 'i' ...};
byte[] encodedText = ImageRecognizer.encrypt(byteArray, mEncryptKey, mEncryptIV);

byte[] mEncryptKey = {'s', 'e', 'l', 'v', 'a', 's', 'a', 'i' ...};
byte[] mEncryptIV = {'s', 'e', 'l', 'v', 'a', 's', 'a', 'i' ...};
byte[] decodedImage = ImageRecognizer.decrypt(encryptImage, mEncryptKey, mEncryptIV);

Bitmap inputImage = BitmapFactory.decodeFile("/path/to/image.jpg");
byte[] mEncryptKey = {'s', 'e', 'l', 'v', 'a', 's', 'a', 'i' ...};
byte[] mEncryptIV = {'s', 'e', 'l', 'v', 'a', 's', 'a', 'i' ...};
byte[] encryptByteArray = ImageRecognizer.getEncryptedImage(inputImage, mEncryptKey, mEncryptIV);
                

//  SelvyIDCardData.h
//  SelvyIDCardRecognizer
//
//  Created by selvasAI on 2018. 8. 8..
//  Copyright © 2018년 SelvasAI. All rights reserved.
//

#import <UIKit/UIKit.h>
#import <Foundation/Foundation.h>

/*!
  * @class   SelvyIDCardData
  * @abstract    SelvyIDCardData 클래스
  * @discussion  신분증 인식 결과 클래스
  */
@interface SelvyIDCardData : NSObject

/*!
  * @typedef IDCardType
  * @brief   신분증 종류 정보
  * @constant    IDCardTypeIDCard    주민등록증
  * @constant    IDCardTypeDriverLicense 자동차운전면허증
  * @constant    IDCardTypeAlienRegistration 외국인등록증
  * @constant    IDCardTypeForeign 주민등록증(재외국민)
  */
typedef NS_ENUM(NSInteger, IDCardType) {
    IDCardTypeIDCard,
    IDCardTypeDriverLicense,
    IDCardTypeAlienRegistration,
    IDCardTypeForeign,
} __TVOS_PROHIBITED;

/*!
  * @property image
  * @brief   영역 검출된 신분증 이미지
  */
@property (strong, nonatomic, readwrite) UIImage *image;

/*!
  * @property type
  * @brief   신분증 종류
  */
@property IDCardType type;

#ifdef _VENDOR_KOSCOM_
/*!
  * @property typeStr
  * @brief   신분증 타입(공통), 주어진 키로 암호화되고 Base64Encoding 된 데이터
  */
@property (strong, nonatomic, readwrite)  NSString *typeStr;

/*!
  * @property name
  * @brief   이름(공통), 주어진 키로 암호화되고 Base64Encoding 된 데이터
  */
@property (strong, nonatomic, readwrite)  NSString *name;

/*!
  * @property rrn
  * @brief   등록번호(공통), 주어진 키로 암호화되고 Base64Encoding 된 데이터
  */
@property (strong, nonatomic, readwrite)  NSString *rrn;

/*!
  * @property birth
  * @brief   생년월일(공통), 주어진 키로 암호화되고 Base64Encoding 된 데이터
  */
@property (strong, nonatomic, readwrite)  NSString *birth;

/*!
  * @property date
  * @brief   발급일(공통), 주어진 키로 암호화되고 Base64Encoding 된 데이터
  */
@property (strong, nonatomic, readwrite)  NSString *date;

/*!
  * @property organization
  * @brief   발급처(주민등록증/자동차운전면허증), 주어진 키로 암호화되고 Base64Encoding 된 데이터
  */
@property (strong, nonatomic, readwrite)  NSString *organization;

/*!
  * @property licenseNumber
  * @brief   면허번호(자동차운전면허증), 주어진 키로 암호화되고 Base64Encoding 된 데이터
  */
@property (strong, nonatomic, readwrite)  NSString *licenseNumber;

/*!
  * @property licenseAptitudeDate
  * @brief   적성검사 만료일(자동차운전면허증), 주어진 키로 암호화되고 Base64Encoding 된 데이터
  */
@property (strong, nonatomic, readwrite)  NSString *licenseAptitudeDate;

/*!
  * @property licenseType
  * @brief   면허종류(자동차운전면허증), 주어진 키로 암호화되고 Base64Encoding 된 데이터
  */
@property (strong, nonatomic, readwrite)  NSString *licenseType;

/*!
  * @property nation
  * @brief   국가(외국인등록증), 주어진 키로 암호화되고 Base64Encoding 된 데이터
  */
@property (strong, nonatomic, readwrite)  NSString *nation;

/*!
  * @property residentStatus
  * @brief   체류자격(외국인등록증), 주어진 키로 암호화되고 Base64Encoding 된 데이터
  */
@property (strong, nonatomic, readwrite)  NSString *residentStatus;

/*!
  * @property address
  * @brief   주소, 주어진 키로 암호화되고 Base64Encoding 된 데이터
  */
@property (strong, nonatomic, readwrite)  NSString *address;

/*!
  * @property licenseIdentificationNumber
  * @brief   면허증 식별번호, 주어진 키로 암호화되고 Base64Encoding 된 데이터
  */
@property (strong, nonatomic, readwrite)  NSString *licenseIdentificationNumber;
#else
/*!
  * @property typeStr
  * @brief   신분증 타입(공통)
  */
@property (strong, nonatomic, readwrite)  NSData *typeStr;

/*!
  * @property name
  * @brief   이름(공통)
  */
@property (strong, nonatomic, readwrite)  NSData *name;

/*!
  * @property rrn
  * @brief   등록번호(공통)
  */
@property (strong, nonatomic, readwrite)  NSData *rrn;

/*!
  * @property date
  * @brief   발급일(공통)
  */
@property (strong, nonatomic, readwrite)  NSData *date;

/*!
  * @property organization
  * @brief   발급처(주민등록증/자동차운전면허증)
  */
@property (strong, nonatomic, readwrite)  NSData *organization;

/*!
  * @property licenseNumber
  * @brief   면허번호(자동차운전면허증)
  */
@property (strong, nonatomic, readwrite)  NSData *licenseNumber;

/*!
  * @property licenseAptitudeDate
  * @brief   적성검사 만료일(자동차운전면허증)
  */
@property (strong, nonatomic, readwrite)  NSData *licenseAptitudeDate;

/*!
  * @property licenseType
  * @brief   면허종류(자동차운전면허증)
  */
@property (strong, nonatomic, readwrite)  NSData *licenseType;

/*!
  * @property nation
  * @brief   국가(외국인등록증)
  */
@property (strong, nonatomic, readwrite)  NSData *nation;

/*!
  * @property residentStatus
  * @brief   체류자격(외국인등록증)
  */
@property (strong, nonatomic, readwrite)  NSData *residentStatus;

/*!
  * @property address
  * @brief   주소
  */
@property (strong, nonatomic, readwrite)  NSData *address;

/*!
  * @property licenseIdentificationNumber
  * @brief   면허증 식별번호
  */
@property (strong, nonatomic, readwrite)  NSData *licenseIdentificationNumber;
#endif

/*!
  * @property rrnRect
  * @brief   등록번호 뒷자리 영역(공통)
  */
@property CGRect rrnRect;

/*!
  * @property licenseNumberRect
  * @brief   면허번호 가운데 영역(자동차운전면허증)
  */
@property CGRect licenseNumberRect;

/*!
  * @property photoRect
  * @brief   사진 영역(공통)
  */
@property CGRect photoRect;

/*!
  * @property isValidColor
  * @brief   흑백 복사본 판별 (YES:컬러 NO:흑백)
  */
@property BOOL isValidColor;

/*!
  * @property isValidRagistrationNumber
  * @brief   주민번호(외국인등록번호) 유효성 여부 (YES:유효함 NO:유효하지않음)
  */
@property BOOL isValidRagistrationNumber;

/*!
  * @property isCropArea
  * @brief   신분증 영역 검출 여부 (YES:영역 검출 NO:영역 검출 실패)
  */
@property BOOL isCropArea;

@end

// 인식엔진 생성자
// 인식엔진 생성자(결과 암호화)

// 입력된 이미지를 인식하고 그 결과를 리스너로 반환

// 입력된 카메라 프리뷰 이미지를 인식하고 그 결과를 리스너로 반환

// 인식기 메모리 해제

SelvyIDCardRecognizer

SelvyIDCardRecognizerDelegate

SelvyBlurDetector

SelvyAreaChecker