Hướng dẫn tích hợp

Tích hợp iOS

Yêu cầu

  • Tối thiểu iOS 10.0 / macOS 10.12 / tvOS 10.0 / watchOS 3.0+
  • Tối thiểu Xcode 11
  • Tối thiểu Swift 5.1

Thiết lập

  • Tải và xuất tệp FEKYC.zip để lấy tệp FEKYC.framework
  • Kéo & thả tệp FEKYC.framework vào dự án của bạn

1

  • Chọn mục tiêu thả, sau đó chọn mục General (Chung) và click vào biểu tượng (+) trong phần Frameworks, Libraries, and Embedded Content (Các Framework, Thư viện, và Nội dung nhúng). Đảm bảo rằng đã thêm thành công tệp FEKYC.framework, nếu không thì tiếp tục kéo và thả tệp này từ Outline View.

2

  • Thêm các biến phụ thuộc: Thêm các biến phụ thuộc cần thiết để thực hiện fekyc (FPT eKYC – định danh khách hàng số FPT) thông qua Cocoapod: pod 'MBProgressHUD' pod 'Alamofire' pod 'TPKeyboardAvoiding' pod 'HydraAsync' pod 'IDMPhotoBrowser'

  • Mô tả nội địa hóa quyền hạn (permissions localization description): FEKYC cần quyền truy cập vào camera người dùng để có thể quét tài liệu cũng như quyền truy cập vào ứng dụng Ảnh để lấy ảnh của người dùng (cả ảnh tài liệu và ảnh chụp mặt). Để lấy được các quyền này, ta sẽ xử lý tệp Goto Info.plist và bổ sung 2 key sau:

    • NSCameraUsageDescription

    • NSPhotoLibraryUsageDescription

3

  • Thiết lập & Chạy (Build & Run)

Sử dụng

Thêm FEKYC

import FEKYC

Trình bày cấu hình (config):

let config = FEKYCConfig(apiKey: "YOU API KEY", fullName: "YOUR NAME",
orcType: FEKYCOrcType.photo, orcDocumentType: FEKYCOrcDocumentType.idCard)

Khởi chạy và khởi động EKYC:

let fekyc = FEKYC(config: config)
fekyc.start(from: self) { [weak self] result in
//
print(result)
}

Tích hợp vào Android

Tạo dự án

4

Thêm SDK Ekyc

5

  • Chọn option (tùy chọn)

  • Thêm package .JAR/AAR

6

  • Chọn lộ trình EkycSdk-release.aar

7

Hoàn tất việc thêm eKYC

Trên ứng dụng mô-đun của bạn

  • Mở Module Settings (Thiết lập Mô-đun)

8

Trên giao diện dialog (hội thoại) thuộc Thiết lập mô-đun

  • Chọn Dependencies’s app (Ứng dụng biến phụ thuộc)

9

  • Chọn biểu tượng “+” trên Declared Dependencies (Các biến phụ thuộc đã đặt), sau đó chọn Module Dependency

10

  • Chọn tùy chọn ekycsdk

11

Thêm các biến phụ thuộc cần thiết cho eKYC SDK

  • Thêm hỗ trợ aaptOptions vào ứng dụng build.gradle

12

  • Thêm các biến phụ thuộc vào ứng dụng build.gradle của bạn
buildscript **{** ext.kotlin_version = '1.3.50' repositories **{**
mavenCentral()
**}**
dependencies **{**
classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:\$kotlin_version"
**}**
**}**
apply plugin: "kotlin-android" apply plugin: "kotlin-android-extensions"

13

implementation 'org.tensorflow:tensorflow-lite:0.0.0-nightly' implementation
'com.kofigyan.stateprogressbar:stateprogressbar:1.0.0'
// kotlin coroutines implementation'org.jetbrains.kotlinx:kotlinx-coroutines-core:1.3.2' implementation
'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.3.2' def retrofit_ver =
"2.9.0" def lifecycle_ver = "2.2.0" implementation
"com.squareup.retrofit2:retrofit:\$retrofit_ver" implementation
"com.squareup.retrofit2:converter-gson:\$retrofit_ver" implementation
"com.squareup.retrofit2:converter-scalars:\$retrofit_ver" implementation
"androidx.lifecycle:lifecycle-extensions:\$lifecycle_ver"

def material_ver = "1.1.0" implementation
"com.google.android.material:material:\$material_ver" implementation
'com.github.israel-fl:bitmap2video:2.0.0'

14

Sử dụng

Tham số

PARAM_API_KEYApi dây (string api) từ EKYC
EKYC PARAM_FULLNAMETên mà ta sẽ thực hiện theo dõi
PARAM_OCR_TYPEOCR_TYPE_PHOTO: dùng cho ảnh chụp mặt (selfie)
PARAM_OCR_DOC_TYPEOCR_DOC_TYPE_CARD_ID (CCCD/CMND)
PARAM_SHOW_RESULT_TYPEĐúng hoặc Sai Trả json trên giao diện onActivivityResult(), không cho xem trước
PARAM_LAYOUTTYPELayoutType : 1 (Dạng layout) ColorStype : color int (Dạng màu)
PARAM_RETURN_PHOTOĐúng/Sai
  • OCR_TYPE_LIVELESS: dùng để xác minh không trực tiếp (lifeless verify)
  • OCR_TYPE_VIDEO: dùng để đăng tải video
  • OCR_DOC_TYPE_DRIVER_LICENCE (bằng lái xe)
  • OCR_DOC_TYPE_PASSPORT (Hộ chiếu)

Lấy kết quả

15

← Xác thực khuôn mặtNhận diện tính sống →