Работа с 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 - перечень действий пользователя при записи видео. Возможные действия:
- .far
- .close
- .smile
- .eyes
- .up
- .down
- .left
- .right
- .scanning
- .selfie
В методе onOZVerificationResult(results:) делегата OZVerificationDelegate можно получить результаты съёмки, содержащие статус и URL видео.
Отправка медиа-файлов на анализ
Данные для отправки на анализ находятся в объекте results (см. выше), полученном после съемки и записи видео. Загрузите их на сервер и инициируйте запуск необходимых анализы с помощью Oz API. См. методы Folder ADD, Folder Media ADD, Analyse ADD и другие.
Анализы проводятся асинхронно, их статус и результаты можно получить с помощью методов Folder SINGLE или Analyse LIST
Для простого сценария взаимодействия с Oz API можно использовать метод 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 – общий статус анализов для папки.