Работа с 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 – общий статус анализов для папки.