Работа с OZ Mobile SDK в операционной системе «iOS»

OZ Mobile SDK для IOS– Software Developer’s Kit платформы Oz Forensics, обеспечивающий удобную интеграцию с мобильными приложениями для регистрации и биометрической идентификации клиентов.

Демо-приложение

Актуальную сборку демо-приложения Вы можете загрузить по ссылке:

https://ozforensics.com/ru/demokit

Исходный код примера приложения с использованием Oz Liveness SDK расположен в репозитории GitHub:

https://gitlab.com/oz-forensics/oz-liveness-ios/-/tree/develop/OZLivenessDemo

Добавление функционала SDK в мобильное приложение клиента

Установка SDK

Для установки OZLivenessSDK используется менеджер зависимостей CocoaPods. Для интеграции OZLivenessSDK в проект Xcode добавьте в Podfile:


    pod 'OZLivenessSDK', :git => 'https://gitlab.com/oz-forensics/oz-liveness-ios.git', :branch => 'develop'

Настройка проекта

OZLivenessSDK для liveness-проверки использует Firebase MLKit. Для этого необходимо создать Firebase-проект, скачать и добавить в Xcode проект «GoogleService-Info.plist.»

В проект нужно добавить параметры:


    OZSDK.authToken = "" // действующий access-token доступа к Oz API
    FirebaseApp.configure()

Авторизация

Для авторизации Oz Api и получения authToken нужно воспользоваться методом «OZSDK.login»:


    OZSDK.login(login, password: password) { (token, error) in
        if let token = token {
            OZSDK.authToken = token
        }
    }

Съёмка видео

Создать контроллер, который произведёт съемку видео можно следующим образом:


    let actions: [OZVerificationMovement] = [.scanning, .smile, .far]
    let ozLivenessVC: UIViewController = OZSDK.createVerificationVCWithDelegate(self, actions: actions)
    self.present(ozLivenessVC, animated: true)

action - перечень действий пользователя при записи видео.

В методе onOZVerificationResult(results:) делегата OZVerificationDelegate можно получить результаты съёмки, содержащие статус и URL видео.

Отправка медиа-файлов на анализ

Полученные в процессе съёмки видео-файлы можно отправить на анализ с помощью метода «OZSDK.analyse»:


    OZSDK.analyse(
        results: results,
        analyseStates: [.quality],
        fileUploadProgress: { (progress) in
    
        }) { (resolution, error) in
    
    }

В блоке «completion» | «resolution» будет содержать результат назначенного анализа, включающий в себя status (статус анализа), type (тип анализа) и «folderID» (id папки Oz API).

Для проведения комплексного анализа с видео и фотографиями документов используется метод «OZSDK.documentAnalyse»:


    OZSDK.documentAnalyse(
        documentPhoto: DocumentPhoto(front: frontDocumentURL, back: backDocumentURL),
        results: results,
        scenarioState: { (state) in
        }, fileUploadProgress: { (progress) in

        }) { (folderResolutionStatus, resolutions, error)

    }


В блоке «completion» | «resolution» будет содержать результат назначенного анализа (аналогично OZSDK.analyse), а folderResolutionStatus – общий статус анализов для папки.