Чтобы начать пользоваться нашим SDK, нужно выполнить следующие шаги.

1. Добавьте SDK в проект, как описано здесь.

2. Получите лицензию на SDK – сгенерируйте тестовую самостоятельно на нашем сайте или запросите «боевую» по электронной почте. Для лицензии потребуется application id. Добавьте лицензию в проект, как описано здесь.

3. Подключите SDK к API. Это необязательный шаг, он выполняется, только если вам нужно обрабатывать какие-либо данные на сервере.

4. Для съемки видео используйте методы, описанные здесь – вы получите медиафайлы, которые потом можно будет отправить на анализ.

5. Запустите нужные вам проверки для полученных на предыдущем шаге медиафайлов. Здесь описано, как выполнять проверки.

6. Если вы хотите настроить внешний вид SDK, здесь написано, как это делается.

Ресурсы

Рекомендуемая версия Android: 5+ (чем новее смартфон, тем быстрее выполняются анализы).

Рекомендуемые версии компонентов:

Мы не поддерживаем эмуляторы.

Доступные языки: EN, RU, ES, HY, KK, KY, TR.

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

Список методов и полей SDK:

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

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

В build.gradle проекта добавьте строки:

В build.gradle модуля добавьте строки (VERSION – версия, которую вы планируете добавить. Список версий можно найти в ):

для анализов на сервере

для анализов и на сервере, и на устройстве

Обратите внимание: размер выходного файла будет больше.

Вне зависимости от выбранного режима, добавьте еще:

Создайте контроллер для съемки видео:

action– перечень при записи видео.

По окончании съемки вызывается метод onOZLivenessResult(results:[OZMedia]):

Метод возвращает результаты съемки в виде массива объектов[], которые используются на следующем шаге для выполнения проверок.

Если пользователь прервет запись видео (закроет экран), появится ошибка failedBecauseUserCancelled.

Этот раздел описывает, как работать с Oz Flutter SDK для iOS и Android.

Перед началом работы мы рекомендуем установить:

• Flutter версии 3.0.0 или выше;

• Android SDK версии 21 или выше;

• dart версии 2.18.6 или выше;

• iOS версии 13 или выше;

• Xcode.

Образец кода для Flutter вы можете найти .

Для авторизации в Oz API используйте адрес API и токен доступа, как показано ниже.

OZSDK.setApiConnection(Connection.fromServiceToken(host: "https://sandbox.ohio.ozforensics.com", token: token)) { (token, error) in
}

Второй вариант: логин и пароль.

OZSDK.setApiConnection(Connection.fromCredentials(host: “https://sandbox.ohio.ozforensics.com”, login: login, password: p)) { (token, error) in
    // Ваш код для обработки ошибки или токена
}

Мы рекомендуем использовать метод аутентификации по токену доступа, как более безопасный.

По умолчанию логи сохраняются вместе с данными по анализам. Если вы планируете хранить логи отдельно от этих данных, настройте отдельное подключение для телеметрии:

let eventsConnection = Connection.fromCredentials(host: https://echo.cdn.ozforensics.com/,
                                login: <[email protected]>,
                                password: your_telemetry_password)
OZSDK.setEventsConnection(eventsConnection) { (token, error) in
}

Обратите внимание: описанная ниже функциональность работает, начиная с версии 8.1.0.

Чтобы добавить или обновить языковой пакет для Oz Android SDK, сделайте следующие шаги:

1. Перейдите в папку для нужной локали или создайте такую папку. Детально процесс описан здесь.

2. Создайте файл и назовите его strings.xml.

3. Скопируйте строки из приложенного файла в только что созданный.

4. Переопределите в переводах строки, которые вам нужны.

Список переводов для Android:

Ключи вида action_*_go относятся к соответствующим жестам. Остальные – к подсказкам для всех жестов, информационным сообщениям или ошибкам.

Когда вместе с новыми версиями появляются новые ключи, если вы не переопределите соответствующие строки в вашем файле, текст для новых ключей будет показываться на английском языке.

Если вы при обновлении с прежних версий (до 6.4.2 включительно) хотите сохранить привычный для клиентов дизайн, сбросьте настройки интерфейса экрана съемки до значений по умолчанию и примените следующие параметры (приведены только те параметры, которые нужно изменить):

// параметры настройки верхней панели
let toolbarCustomization = ToolbarCustomization(
   closeButtonColor: .white,
   backgroundColor: .black)

// параметры настройки текста подсказки
let centerHintCustomization = CenterHintCustomization(
   verticalPosition: 70)
   
// параметры настройки анимации подсказки
let hintAnimationCustomization = HintAnimationCustomization(
    hideAnimation: true)

// параметры настройки рамки вокруг лица
let faceFrameCustomization = FaceFrameCustomization(
   strokeWidth: 6,
   strokeFaceAlignedColor: .green,
   strokeFaceNotAlignedColor: .red)

// параметры настройки фона за рамкой
let backgroundCustomization = BackgroundCustomization(
   backgroundColor: .clear)

OZSDK.customization = OZCustomization(toolbarCustomization: toolbarCustomization,
   centerHintCustomization: centerHintCustomization,
   hintAnimationCustomization: hintAnimationCustomization,
   faceFrameCustomization: faceFrameCustomization,
   versionCustomization: versionCustomization,
   backgroundCustomization: backgroundCustomization)

Обратите внимание: описанная ниже функциональность работает, начиная с версии 8.1.0.

Чтобы добавить или обновить языковой пакет для Oz iOS SDK, используйте метод set(languageBundle: Bundle). Он информирует SDK, что вы планируете использовать отличный от стандартного бандл. В OzLocalizationCode используйте кастомный язык (опционально).

• Если вы не укажете кастомные язык и бандл, SDK будет использовать имеющиеся переводы.

• Если бандл указан, а язык нет, приоритетным считается перевод для ключа из файла локализации кастомного бандла. Если такой ключ там не найден, перевод берется из стандартного бандла.

• Если указаны кастомные и бандл, и язык, все переводы берутся из файла локализации кастомного бандла.

Список переводов для iOS:

Ключи вида Action.*.Task относятся к соответствующим жестам. Остальные – к подсказкам для всех жестов, информационным сообщениям или ошибкам.

При появлении новых ключей, если переводов для них в кастомном бандле нет, будет показываться текст на языке по умолчанию (английском).

Для авторизации в Oz API используйте адрес API и , как показано ниже.

Второй вариант: логин и пароль.

Мы рекомендуем использовать метод аутентификации по токену доступа, как более безопасный.

По умолчанию логи сохраняются вместе с данными по анализам. Если вы планируете хранить логи отдельно от этих данных, настройте отдельное подключение для :

Очистка авторизации:

Проверка наличия сохраненного access-токена Oz API:

LogOut:

Если вы при обновлении с прежних версий (до 6.4.2 включительно) хотите сохранить привычный для клиентов дизайн, сбросьте настройки интерфейса экрана съемки до значений по умолчанию и примените следующие параметры (приведены только те параметры, которые нужно изменить):

Чтобы начать пользоваться нашим SDK, нужно выполнить следующие шаги.

1. Добавьте SDK в проект, как описано .

2. Получите лицензию на SDK – сгенерируйте тестовую самостоятельно на нашем или запросите «боевую» по . Для лицензии потребуется bundle id. Добавьте лицензию в проект, как описано .

3. SDK к API. Это необязательный шаг, он выполняется, только если вам нужно обрабатывать какие-либо данные на сервере. Если вы используете , никакие данные никуда не передаются, и подключение к API не нужно.

4. Создайте контроллер для съемки, как описано – вы получите медиафайлы, которые потом можно будет отправить на анализ.

5. Запустите нужные вам проверки для полученных на предыдущем шаге медиафайлов. описано, как выполнять проверки.

6. Если вы хотите настроить внешний вид SDK, написано, как это делается.

Ресурсы

Минимальная версия iOS: 11.

Минимальная версия Xcode: 16.

Доступные языки: EN, RU, ES, HY, KK, KY, TR.

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

Список методов и полей SDK:

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

CocoaPods

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

VERSION (опционально, по умолчанию устанавливается последняя версия) – версия, которую можно найти в .

Начиная с версии 8.1.0, можно использовать упрощенный код:

По умолчанию устанавливается полная версия SDK (с режимами анализа на сервере и на устройстве). Если нужен только серверный анализ, код будет выглядеть так:

Для версий 8.1.0 и выше:

SPM

Установка через SPM возможна для SDK версий 8.7.0 и новее.

Добавьте через SPM зависимости пакетов по ссылке: (, как добавить зависимости). Файл OzLivenessSDK обязателен для добавления, OzLivenessSDKOnDevice можно не добавлять, если вы не используете анализы на устройстве.

Ручная установка

Вы также можете добавить файлы SDK в проект вручную.

1. Скачайте следующие файлы и добавьте их в проект:

• OZLivenessSDK.xcframework,

• OZLivenessSDKResources.bundle,

• OZLivenessSDKOnDeviceResources.bundle (если вы не используете анализы на устройстве, этот файл можно не скачивать).

1. Скачайте TensorFlow : потребуется версия 2.11.

2. Убедитесь, что:

• оба файла xcframework отображаются в Target-Build Phases -> Link Binary With Libraries и Target-General -> Frameworks, Libraries, and Embedded Context;

• файл(ы) bundle отображаются в Target-Build Phases -> Copy Bundle Resources.

Сгенерируйте тестовую лицензию самостоятельно здесь (внимание, страница на английском языке) или свяжитесь с нами по email для выпуска продуктивной лицензии. Для подготовки лицензии потребуется applicationId (bundle id).

Для добавления файла лицензии в SDK вызовите метод OzLivenessSDK.init с одним из параметров LicenseSources:

• LicenseSource.LicenseAssetId должен содержать путь к файлу forensics.license, расположенному в проекте в папке res/raw.

• LicenseSource.LicenseFilePath должен содержать пусть к файлу на устройстве (вне проекта).

OzLivenessSDK.init(context,
    listOf(
        LicenseSource.LicenseAssetId(R.raw.your_license_name),
        LicenseSource.LicenseFilePath("абсолютный путь к файлу лицензии")
    ),
    object : StatusListener<LicensePayload> {
        override fun onSuccess(result: LicensePayload) { /*проверка информации о лицензии*/ }
        override fun onError(error: OzException) { /*обработка исключения */ }
    }
  )

OzLivenessSDK.INSTANCE.getConfig().setBaseURL(BASE_URL);
OzLivenessSDK.INSTANCE.init(context,
    Arrays.asList(
        new LicenseSource.LicenseAssetId(R.raw.forensics),
        new LicenseSource.LicenseFilePath("aбсолютный путь к файлу лицензии")
    ),
    new StatusListener<LicensePayload>() {
        @Override public void onStatusChanged(@Nullable String s) {}
        @Override public void onSuccess(LicensePayload licensePayload) { /*проверка информации о лицензии*/ }
        @Override public void onError(@NonNull OzException e) { /*обработка исключения */ }
    }
);

Если при обработке лицензии возникнут ошибки, вы получите сообщение с описанием этих ошибок. Если ошибок нет, система выведет данные о лицензии. Вы также можете запросить эти данные с помощью метода getLicensePayload.

Возможные ошибки лицензии

Для работы SDK требуется лицензия. Сгенерируйте тестовую лицензию самостоятельно здесь (внимание, страница на английском языке) или свяжитесь с нами по email для выпуска продуктивной лицензии. Для подготовки лицензии потребуется bundle id. Есть два способа добавить лицензию в проект:

1. Переименуйте файл в forensics.license и поместите его в проект. Прописывать путь в этом случае не нужно.

2. Обновление лицензии для уже работающего приложения или в том случае, если вы хотите держать лицензию вне проекта:

OZSDK(licenseSources: [.licenseFileName(“forensics.license”)]) { licenseData, error in
      if let error = error {
        print(error)
      }
    }

или

OZSDK(licenseSources: [.licenseFilePath(“path_to_file”)]) { licenseData, error in
      if let error = error {
        print(error)
      }
    }

LicenseSource – источник лицензии, LicenseData – информация о лицензии. В этот метод встроена проверка наличия активной лицензии, если такая лицензия есть – будет использоваться она, а не та, путь к которой вы указали. Для принудительной замены лицензии используйте метод setLicense.

Если при обработке лицензии возникнут ошибки, вы получите сообщение с описанием этих ошибок. Если ошибок нет, система выведет данные о лицензии. Вы также можете запросить эти данные с помощью OZSDK.licenseData.

Возможные ошибки лицензии

Если наш SDK используется только для съемки, пропустите этот шаг.

Чтобы выполнить проверку, нужно загрузить в систему медиафайлы, а затем запустить для них анализы.

Пример:

let analysisRequest = AnalysisRequestBuilder()

// создайте анализы
let analysis = Analysis.init(
    media: mediaToAnalyze, // mediaToAnalyze – массив объектов OzMedia 
    type: .quality, // типы анализов перечислены в методах iOS SDK
    mode: .serverBased // .onDevice для анализа на устройстве
)
analysisRequest.addAnalysis(analysis)

// initiate the analyses
analysisRequest.run(
    statusHandler: { state in }, // добавьте обработчик шагов сценария
    errorHandler: { _ in } 
) { result in
          // ваш обработчик результата
  }

Для удаления медиафайлов после выполнения всех проверок используйте метод clearTempDirectory.

Добавление метаданных

Для добавления метаданных используйте метод AnalysisRequest.addFolderMeta.

let analysis = Analysis.init(media: mediaToAnalyze, type: .quality, mode: .serverBased)
var folderMeta: [String: Any] = ["key1": "value1"]
analysisRequest.addFolderMeta(folderMeta)
...

Извлечение лучшего кадра

В структуре Analysis можно передать дополнительные параметры, например, для извлечения на сервере лучшего кадра.

let analysis = Analysis.init(media: mediaToAnalyze, type: .quality, mode: .serverBased, params: [“extract_best_shot” : true])

Использование медиафайла, снятого не нашим SDK

Чтобы использовать медиафайлы, снятые не Oz iOS SDK, укажите путь к ним в структуре OzMedia (полеbestShotURL):

let referenceMedia = OZMedia.init(movement: .selfie,
                  mediaType: .movement,
                  metaData: ["meta":"data"],
                  videoURL: nil,
                  bestShotURL: imageUrl,
                  preferredMediaURL: nil,
                  timestamp: Date())

Добавление медиафайлов в определенную папку

Для добавления медиафайлов в определенную папку используйте метод addFolderId:

let analysis = Analysis.init(media: mediaToAnalyze, type: .quality, mode: .serverBased)
analysisRequest.addFolderId(IdRequired)

Мастер-лицензия – это оффлайн-лицензия, с которой можно использовать мобильные SDK без ограничений по bundle_id, в отличие от обычных лицензий. Для получения мастер-лицензии нужно создать пару ключей, как описано ниже. Отправьте нам публичный ключ по электронной почте, и вскоре после этого мы отправим вам мастер-лицензию. Вашему приложению нужно будет подписать свой bundle_id приватным ключом. Мобильные SDK проверяют подпись с помощью публичного ключа из мастер-лицензии. Действие таких лицензий ограничено по времени.

Генерация ключей

В этом разделе описано, как создавать приватный и публичный ключи.

Создание приватного ключа

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

Вы получите два файла:

• privateKey.der – приватный ключ .der;

• privateKey.txt – privateKey.der в кодировке base64. Содержимое этого файла используется в качестве подписи bundle_id хостового приложения.

Спецификация команд OpenSSL:

Создание публичного ключа

Чтобы создать публичный ключ, запустите команду:

Вы получите публичный ключ publicKey.pub. Отправьте его нам по электронной почте. В ответ мы пришлем вам лицензию.

Интеграция SDK

Инициализация SDK:

Перед инициализацией SDK создайте закодированную base64 подпись для bundle_id хостового приложения с помощью приватного ключа.

Пример создания подписи:

Передайте подпись как параметр masterLicenseSignature во время инициализации SDK.

Если подпись невалидна, инициализация продолжится по стандартной схеме: проверка включенных в лицензию bundle_id.

Для старта записи видео используется метод startActivityForResult:

actions – перечень при записи видео.

Для представления Fragment код приведен ниже. LivenessFragment – для экрана Liveness.

Для получения результатов записи видео используется метод onActivityResult:

• sdkMediaResult – объект с результатами записи видео () для дальнейшего использования при взаимодействии с Oz API.

• sdkErrorString – описание в случае их возникновения.

Если пользователь прервет запись видео (закроет экран), resultCode примет значение Activity.RESULT_CANCELED.

Пример кода для обработки:

Мастер-лицензия – это оффлайн-лицензия, с которой можно использовать мобильные SDK без ограничений по bundle_id, в отличие от обычных лицензий. Для получения мастер-лицензии нужно создать пару ключей, как описано ниже. Отправьте нам публичный ключ по электронной почте, и вскоре после этого мы отправим вам мастер-лицензию. Вашему приложению нужно будет подписать свой bundle_id приватным ключом. Мобильные SDK проверяют подпись с помощью публичного ключа из мастер-лицензии. Действие таких лицензий ограничено по времени.

Генерация ключей

В этом разделе описано, как создавать приватный и публичный ключи.

Создание приватного ключа

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

Вы получите два файла:

• privateKey.der – приватный ключ .der;

• privateKey.txt – privateKey.der в кодировке base64. Содержимое этого файла используется в качестве подписи bundle_id хостового приложения.

Спецификация команд OpenSSL:

Создание публичного ключа

Чтобы создать публичный ключ, последовательно запустите следующие команды:

Вы получите публичный ключ publicKey.pub. Отправьте его нам по электронной почте. В ответ мы пришлем вам лицензию.

Интеграция SDK

Инициализация SDK:

Установка лицензии:

Перед инициализацией SDK создайте закодированную base64 подпись для bundle_id хостового приложения с помощью приватного ключа.

Пример создания подписи:

Передайте подпись как параметр masterLicenseSignature во время инициализации SDK или установки лицензии.

Если подпись невалидна, инициализация продолжится по стандартной схеме: проверка включенных в лицензию bundle_id.

Если наш SDK используется только для съемки, пропустите этот шаг.

Чтобы выполнить проверку, нужно загрузить в систему медиафайлы, а затем запустить для них анализы.

Пример работы:

Для удаления медиафайлов после выполнения всех проверок используйте метод clearActionVideos.

Добавление метаданных

Для добавления метаданных используйте метод addFolderMeta.

Извлечение лучшего кадра

В структуре Analysis можно передать дополнительные параметры, например, для извлечения на сервере лучшего кадра.

Использование медиафайла, снятого не нашим SDK

Чтобы использовать медиафайлы, снятые не Oz Android SDK, укажите путь к ним в структуре :

Добавление медиафайлов в определенную папку

Для добавления медиафайлов в определенную папку используйте метод setFolderId:

Настройка интерфейса

Чтобы настроить интерфейс Oz Liveness, воспользуйтесь OZCustomization. Полный список полей находится .

8.19.0 – 24.11.2025

• Android: Исправили ошибку, из-за которой при запуске Fragment могло появляться предупреждение.

• Android: SDK больше не вылетает при вызове copyPlane.

• Android: Если при гибридном анализе вы выбираете отправку сжатых видео, оригинальные видео больше не сохраняются вместе со сжатыми.

• iOS: Исправили анимацию жеста Сканирование.

• iOS: Исправили ошибку, при которой SDK при инициализации в дебаг-режиме не вызывал completion.

• Повысили безопасность.

8.18.1 – 10.09.2025

• initSDK в дебаг-режиме для iOS теперь работает корректно.

8.18.0 – 26.08.2025

• Добавили возможность выполнять анализ для конкретной папки с использованием ее идентификатора.

• Исправили ошибку в коде примера.

• Подсказка для жеста Сканирование теперь озвучивается корректно.

• При попытке удалить референтное фото SDK теперь запрашивает подтверждение.

• Исправили ошибку с темным фоном при запуске SDK.

• Исправили ошибку, из-за которой при биометрическом анализе одно из изображений переворачивалось.

• Исправили несколько ошибок, возникавших во время анализов на устройстве и при гибридном анализе.

• Android: теперь поддерживаем Google Dynamic Feature Delivery.

• Android: исправили ошибку, из-за которой SDK мог вылететь при закрытии экрана съемки.

• iOS: исправили ошибку с интеграцией через Swift UI.

• iOS: в соответствии с требованиями Apple обновили Xcode до версии 16.

• Повысили безопасность и обновили телеметрию.

8.16.0 – 30.04.2025

• Обновили логику авторизации.

• Улучшили логику озвучивания подсказок.

• Обновления безопасности.

• Android: валидацию видео – опцию, которая запускает запись видео заново, если получившийся файл состоит из 3 кадров и менее – теперь можно отключить.

• iOS: SDK теперь сжимает медиафайлы, если их размер превышает 10 МБ.

• iOS: жесты с движениями головы теперь обрабатываются корректно.

• iOS: в соответствии с требованиями Apple обновили Xcode до версии 16.

8.14.0 – 17.12.2024

• Обновления безопасности и телеметрии.

• Подсказки SDK и элементы управления интерфейса могут озвучиваться в соответствии с требованиями WCAG.

• Упростили прохождение проверки для жестов, включающих движение головы.

• Android: сжатие больших видео теперь происходит на этапе закрытия экрана Liveness.

• Android: исправили ошибку, из-за которой изображение с закрытыми глазами могло быть выбрано в качестве лучшего кадра.

• Android: исправили проблемы с кодеками, появлявшиеся на некоторых моделях смартфонов.

• Android: исправили ошибку, из-за которой некоторые записанные SDK видео были зелеными.

• iOS: добавили поддержку Xcode 16.

• iOS: при использовании основной (задней) камеры яркость экрана теперь не меняется.

• iOS: исправили ошибку записи видео, появлявшуюся на некоторых моделях смартфонов.

8.12.0 – 11.10.2024

• Метод executeLiveness больше не используется. Съемка теперь запускается с помощью метода startLiveness.

• Обновили код для получения результата съемки.

• Обновления безопасности и телеметрии.

8.8.2 – 27.06.2024

• При попытке передать пустую строку в качестве аргумента для методов addFolderId (iOS) и setFolderID (Android)теперь показывается информативная ошибка.

• Android: исправили ошибку с бесконечно крутящимся спиннером, который появлялся при переключении пользователя на другое приложение во время прохождения проверки Liveness.

• Android: исправили несколько ошибок, появлявшихся только на определенных моделях смартфонов.

• Обновления безопасности и телеметрии.

8.6.0 – 15.04.2024

• Android: улучшили модель Liveness для проверки на устройстве.

• Android: обновления безопасности.

• iOS: синхронизировали с Android сообщения, которые SDK показывает после загрузки медиафайла.

• iOS: исправили баг с задержками запуска анализа, которые иногда возникали для анализа по одному кадру.

8.5.0 – 20.03.2024

• Длительность жеста Селфи теперь можно менять (размер видеофайла также изменится).

• Убрали паузу после жеста Сканирование.

• Обновления безопасности и журналирования.

• Android: если размер записанного видеофайла больше 10 Мбайт, видео будет сжато.

8.4.0 – 11.01.2024

• Android: обновили модель Liveness для проверки на устройстве.

• iOS: изменили поведение для отсутствующих переводов при добавлении новых ключей в локализацию: теперь вместо названия ключа показывается текст на языке по умолчанию (английском).

• Исправили ошибки.

8.3.0 – 30.11.2023

• Добавили возможность использования мастер-лицензии, которая работает с любым bundle_id.

• Android: исправили ошибку со сжатием видео при гибридном анализе, которая возникала на некоторых моделях телефонов.

• iOS: исправили ошибку с мигающим фоном при съемке.

8.2.0 – 17.11.2023

• Выпущена первая версия.

Образец кода для Flutter вы можете найти здесь.

Установка и лицензирование

Добавьте строки из блока ниже в pubspec.yaml проекта, где планируется использовать плагин.

  ozsdk:
    git:
      url: https://gitlab.com/oz-forensics/oz-mobile-flutter-plugin.git
      ref: '8.8.2'

Поместите файл лицензии (например, license.json или forensics.license) в папку Flutter application/assets. В pubspec.yaml добавьте asset:

assets
  - assets/license.json // название файла лицензии должно совпадать с названием из папки assets

Для Android укажите путь к репозиторию Oz в /android/build.gradle, раздел allprojects → repositories:

allprojects {
    repositories {
        google()
        mavenCentral()
        maven { url ‘https://ozforensics.jfrog.io/artifactory/main’ } // ссылка на репозиторий
    }
}

Для Flutter 8.24.0 и новее или Android Gradle plugin 8.0.0 и новее добавьте строку в android/gradle.properties:

android.nonTransitiveRClass=false

Минимальная версия SDK – 21 или выше:

defaultConfig {
  ...
  minSDKVersion 21
  ...
}

Для iOS в Runner → Info → Deployment target → iOS Deployment Target установите версию 13 или выше.

В ios/Podfile закомментируйте строку use_frameworks! (#use_frameworks!).

Начало работы с Flutter

Инициализация SDK

Для инициализации вызовите метод init. Название и путь к файлу лицензии должны совпадать с теми, которые вы указали в pubspec.yaml (например, assets/license.json).

await OZSDK.initSDK([<% название файла лицензии и путь к нему %>]);

Подключение SDK к API

Для подключения используйте полученные от нас логин, пароль и адрес API сервера.

await OZSDK.setApiConnectionWithCredentials(<login>, <password>, <host>);

На стадии коммерческого использования вместо логина и пароля мы рекомендуем использовать токен доступа, который можно получить с помощью метода API /api/authorize/auth.

 await OZSDK.setApiConnectionWithToken(token, host);

По умолчанию логи сохраняются вместе с данными по анализам. Если вы планируете хранить логи отдельно от этих данных, настройте отдельное подключение для телеметрии:

await OZSDK.setEventConnectionWithCredentials(<login>, <password>, <host>);

или

await OZSDK.setEventConnectionWithToken(<token>, <host>);

Съемка видео

Для запуска съемки и получения результата вызовите метод startLiveness:

await OZSDK.startLiveness(<actions>, <use_main_camera>);

Обратите внимание: для версий до 8.11 включительно метод для запуска называется executeLiveness. Он возвращает результат съемки.

Для получения результата съемки в версии 8.12 и новее подпишитесь на livenessResult, как показано ниже:

class Screen extends StatefulWidget {
  static const route = 'liveness';

  const Screen({super.key});

  @override
  State<Screen> createState() => _ScreenState();
}

class _ScreenState extends State<Screen> {
  late StreamSubscription<List<Media>> _subscription;

  @override
  void initState() {
    super.initState();

    // подписка на результат liveness
    _subscription = OZSDK.livenessResult.listen(
      (List<Media> medias) {
          // содержит медиафайл liveness
      },
      onError: (Object error) {
        // обработка ошибок, чаще всего PlatformException
      },
    );
  }

  @override
  Widget build(BuildContext context) {
    // пропущено для сокращения образца кода
  }

  void _startLiveness() async {
    // запустите экран съемки с помощью метода startLiveness
    OZSDK.startLiveness(<list of actions>);
  }

  @override
  void dispose() {
    // cancel subscription
    _subscription.cancel();
    super.dispose();
  }
}

Выполнение проверок

Размещенный ниже код поможет вам запустить анализы.

Создайте объект Analysis:

List<Analysis> analysis = [ Analysis(Type.quality, Mode.serverBased, <media>, {}), ];

Запустите созданный анализ:

final analysisResult = await OZSDK.analyze(analysis, [], {});

Если вы хотите запустить анализ для конкретной папки, укажите ее идентификатор:

final analysisResult = await OZSDK.analyze(analysis, folderID, [], {});

Результат анализа запишется в массив объектов analysisResult.

Для анализа медиафайла, полученного не нашим SDK, используйте следующий код:

media = Media(FileTypedocumentPhoto, VerificationAction.oneShot, “photo_selfie”, null, <pat

Итоговый блок кода (пример):

// замените VerificationAction.blank, если у вас используется другой жест Livenes
final cameraMedia = await OZSDK.executeLiveness([VerificationAction.blank], use_main_camera);

final analysis = [
  Analysis(Type.quality, Mode.serverBased, cameraMedia, {}),
];

final analysisResult = await OZSDK.analyze(analysis, [], {});

// замените VerificationAction.blank, если у вас используется другой жест Liveness
final cameraMedia = await OZSDK.executeLiveness([VerificationAction.blank], use_main_camera);
final biometryMedia = [...cameraMedia];
biometryMedia.add(
  Media(
    FileType.documentPhoto,
    VerificationAction.blank,
    MediaType.movement,
    null,
    <путь к референсному фото>,
    null,
    null,
    MediaTag.photoSelfie,
  ),
);

final analysis = [
  Analysis(Type.quality, Mode.serverBased, cameraMedia, {}),
  Analysis(Type.biometry, Mode.serverBased, biometryMedia, {}),
];

final analysisResult = await OZSDK.analyze(analysis, [], {});

Настройки Oz Mobile SDK

Применять настройки рекомендуется при старте приложения.

Настройка интерфейса Oz Mobile SDK

Чтобы настроить интерфейс Oz Liveness, воспользуйтесь UICustomization. Полный список полей находится .

По умолчанию SDK использует локаль устройства. Чтобы сменить локаль, используйте код ниже:

8.21.0 – 21.11.2025

• Исправили ошибку, из-за которой SDK на некоторых устройствах иногда мог не реагировать на действия пользователя.

• Обновили SDK в рамках подготовки к внедрению новой функциональности, связанной с безопасностью.

8.20.0 – 17.10.2025

• Исправили ошибку, из-за которой SDK мог вылететь после съемки референтного фото с помощью камеры во время анализа Biometry.

• Повысили безопасность.

8.19.0 – 23.09.2025

• Исправили анимацию жеста Сканирование.

• Исправили ошибку, при которой SDK при инициализации в дебаг-режиме не вызывал completion.

• Повысили безопасность.

8.18.2 – 22.08.2025

• Исправили ошибку, из-за которой SDK иногда вылетал при добавлении лицензии.

8.18.1 – 06.08.2025

• Исправили ошибку с интеграцией через Swift UI.

• SDK больше не вылетает на устройствах, где осталось мало свободного места.

• Повысили безопасность и обновили телеметрию.

8.17.0 – 12.06.2025

• Повысили безопасность.

8.16.2 – 22.04.2025

• В соответствии с требованиями Apple обновили Xcode до версии 16.

8.16.1 – 09.04.2025

• Повысили безопасность.

8.16.0 – 11.03.2025

• Обновили логику авторизации.

• Улучшили логику озвучивания подсказок.

• SDK теперь сжимает медиафайлы, если их размер превышает 10 МБ.

• Жесты с движениями головы теперь обрабатываются корректно.

• Повысили безопасность.

8.15.0 – 30.12.2024

• Добавлен правильный порядок фокусировки для VoiceOver при включенной антискам-подсказке.

• Добавлена ​​публичная настройка extract_action_shot в Демо Приложении.

• Исправили ошибки.

• Повысили безопасность.

8.14.0 – 03.12.2024

• Обновления доступности для пользователей с инвалидностью согласно требованиям WCAG: можно настроить озвучивание подсказок SDK и элементов управления.

• Упростили прохождение проверки для жестов, включающих движение головы.

• Исправили незначительные ошибки.

• Обновили телеметрию.

8.13.0 – 11.11.2024

• При использовании основной (задней) камеры яркость экрана теперь не меняется.

• Исправили ошибку записи видео, появлявшуюся на некоторых моделях смартфонов.

• Повысили безопасность и обновили телеметрию.

8.12.2 – 24.10.2024

• Улучшили работу SDK.

8.12.1 – 30.09.2024

• Добавили поддержку Xcode 16.

• Повысили безопасность и обновили телеметрию.

8.11.0 – 10.09.2024

• Повысили безопасность.

8.10.1 – 23.08.2024

• Исправили ошибки.

8.10.0 – 01.08.2024

• Для работы SDK теперь нужен Xcode 15 и новее.

• Повысили безопасность.

• Исправили ошибки.

8.9.1 – 16.07.2024

• Улучшили работу SDK.

8.8.3 – 11.07.2024

• Улучшили работу SDK.

8.8.2 – 25.06.2024

• Исправили ошибки.

8.8.1 – 25.06.2024

• Обновили телеметрию.

8.8.0 – 18.06.2024

• Повысили безопасность.

8.7.0 – 10.05.2024

• Теперь вы можете установить iOS SDK через Swift Package Manager.

• Добавили образец кода для SwiftUI.

• При попытке передать пустую строку в качестве аргумента для метода addFolderId теперь показывается информативная ошибка.

• Исправили ошибки.

8.6.0 – 10.04.2024

• Синхронизировали с Android сообщения, которые SDK показывает после загрузки медиафайла.

• Исправили баг с задержками запуска анализа, которые иногда возникали для анализа по одному кадру.

8.5.0 – 06.03.2024

• Длительность жеста Селфи теперь можно менять (размер видеофайла также изменится).

• Вы можете заменить логотип Oz своим, если ваша лицензия это предусматривает.

• Убрали паузу после жеста Сканирование.

• Обновили код в Readme.md.

• Повысили безопасность и обновили телеметрию.

8.4.2 – 24.01.2024

• Повысили безопасность.

8.4.0 – 09.01.2024

• Изменили поведение для отсутствующих переводов при добавлении новых ключей в локализацию: теперь вместо названия ключа показывается текст на языке по умолчанию (английском).

• Исправили ошибки.

8.3.3 – 11.12.2023

• Улучшили работу механизмов лицензирования.

8.3.0 – 17.11.2023

• Добавили возможность использования мастер-лицензии, которая работает с любым bundle_id.

• Исправили ошибку с мигающим фоном при съемке.

8.2.1 – 11.11.2023

• Исправили ошибки.

8.2.0 – 30.10.2023

• Добавили в структуру Analysis поле sizeReductionStrategy. Оно определяет размер файла, отправляемого на сервер после успешного завершения проверки на устройстве в составе гибридного анализа.

• Сообщения для получаемых из API ошибок теперь более информативны.

• Настройка toFrameGradientColor для кастомизации подсказки hintAnimationCustomization больше не используется. Вместо нее используйте hintGradientColor.

• Вернули поддержку iOS 11.

8.1.1 – 09.10.2023

• Если несколько анализов назначаются на папку одновременно, система отправляет их группой. Таким образом, выбирается “худший” результат среди всех анализов, а не последний назначенный. Прочитать про отправку анализов группой можно здесь.

• В анализе Liveness для количественного результата теперь берется максимальный из вычисленных. Прочитать о результате можно здесь.

8.1.0 – 07.09.2023

• Обновили модель Liveness для проверки на устройстве.

• Добавили португальский язык (бразильский вариант).

• Вы теперь можете добавить язык или изменить текущие переводы самостоятельно. Как это сделать, описано здесь.

• Если медиафайл по каким-то причинам не загрузился, система теперь повторяет загрузку.

• Добавили новый метод для получения идентификатора телеметрии (логирования): getEventSessionId.

• Методы setPermanentAccessToken, configure и login больше не используются. Вместо них, пожалуйста, используйте метод setApiConnection.

• Метод setLicense(from path:String) больше не используется. Вместо него, пожалуйста, используйте метод setLicense(licenseSource: LicenseSource).

• Исправили ошибки и улучшили работу SDK.

8.0.2 – 15.08.2023

• Исправили ошибки, улучшили работу алгоритмов SDK.

8.0.0 – 27.06.2023

• Добавлен новый тип анализа – гибридный (сейчас работает только для Liveness). В случае спорных результатов анализа на устройстве проводится дополнительная проверка на сервере.

• Обновлены модели для выполнения анализов на устройстве.

• Обновили метод run.

• Добавили новые структуры RequestStatus (статус анализа), ResultMedia (статус анализов для одного медиафайла) и RequestResult (сводный результат анализа для всех медиа).

• Структура OzAnalysisResult больше не используется; вместо нее – обновленная структура AnalysisResult.

• Для объекта OZMedia теперь можно добавить дополнительные теги не из списка основных.

• Длительность видео для жеста “Селфи” снижена до 0,7 секунд, соответственно, уменьшились размер файла и время его загрузки на сервер.

• Текст подсказки теперь может выходить за границы рамки для лица по горизонтали (для основной камеры).

• Прекращена поддержка методов:

7.3.0 – 06.06.2023

• Добавили настройки для фона подсказки.

• Добавили новые формы рамки (круг, квадрат).

• Добавили виджет для защиты от мошенничества и набор настроек к нему. С помощью этого виджета вы можете уведомлять пользователей, что ведется съемка видео для, например, отправления заявки на кредит. Таким образом вы сможете защитить пользователей, если мошенники попытаются убедить их подтвердить такой запрос.

• Синхронизировали значения настроек кастомизации по умолчанию с Android.

• Добавили испанский язык.

• iOS 11 больше не поддерживается; минимальная необходимая версия – 12.

7.2.1 – 24.05.2023

• Исправили ошибки, связанные с проведением однокадрового анализа на стороне сервера.

7.2.0 – 18.05.2023

• Улучшили работу алгоритмов SDK.

7.1.6 – 04.05.2023

• Исправлен баг с серверными анализами при отсутствии видео: если по каким-то причинам видео не загрузилось в папку (например, при потере интернет-соединения), папка будет пустой – без видео и назначенных анализов.

7.1.5 – 03.04.2023

• Улучшили работу Liveness-анализов на устройстве.

7.1.4 – 24.03.2023

• Обновили анимацию для солнечных очков / маски.

• Исправили ошибку с добавлением анализа.document.

7.1.2 – 21.02.2023

• Обновили версию TensorFlow до 2.11.

• Исправили несколько багов, в том числе ошибки биометрической проверки, возникавшие на некоторых моделях телефонов.

7.1.1 – 06.02.2023

• Добавили возможность управлять цветом анимации.

7.1.0 – 20.01.2023

• Обновили модель для выполнения анализов.

• Добавили метод uploadMedia в AnalysisRequest. Метод addMedia больше не используется.

• Исправили ошибку в жесте Комбо.

• Добавили кнопку для сброса настроек языка и темы SDK.

• Увеличили тайм-аут сетевых запросов до 90 с.

• Добавили возможность управлять размером значка анимации.

• Исправили баги.

7.0.0 – 08.12.2022

• Значительно расширили список настроек кастомизации SDK и обновили дизайн. Если вы хотите вернуть дизайн из прошлых версий, соответствующие настройки описаны здесь.

6.7.0

• Синхронизировали ответы методов run с Android SDK, теперь метод возвращает массив результатов анализов.

6.4.0

• Синхронизировали нумерацию версий с Android SDK.

• Добавили новое поле params в структуру Analysis – с его помощью можно задавать дополнительные параметры, например, для извлечения на сервере лучшего кадра. Алгоритм "лучший кадр" выбирает из видеозаписи наиболее качественный и удачный кадр с лицом.

• Исправили ошибки локализации.

• Поменяли жест Комбо.

• Теперь можно запускать проверку Liveness на устройстве для анализа изображений, снятых вне SDK.

3.0.1

• Жесты отдаления и приближения больше не поддерживаются.

3.0.0

• Добавили новую упрощенную структуру анализа AnalysisRequest.

2.3.0

• Добавили методы для локального анализа: runOnDeviceLivenessAnalysis и runOnDeviceBiometryAnalysis.

• Версию для установки можно выбрать: стандартная установка дает доступ ко всем функциям, а в версии core (OzLivenessSDK/Core) отсутствует возможность делать анализы локально на устройстве.

• Добавили универсальный метод для загрузки данных на сервер и немедленного запуска анализов: uploadAndAnalyse.

• Дополнили процесс лицензирования: теперь лицензию можно указать при инициализации SDK. Воспользуйтесь методом OZSDK(licenseSources: [LicenseSource], completion: @escaping ((LicenseData?, LicenseError?) -> Void)), где LicenseSource – путь до лицензии, LicenseData – информация о лицензии.

• Добавили метод setLicense для принудительной установки лицензии.

2.2.3

• Добавили турецкий язык.

2.2.1

• Добавили киргизский язык.

• Добавили Completion Handler для результатов анализа.

• Добавили в телеметрию передачу Error User Info, теперь можно узнавать подробности об ошибке, которая происходит в работе анализа.

2.2.0

• Добавили локальные анализы – теперь анализ можно делать прямо на устройстве.

• Добавили рамки для лица, теперь их две – овал и прямоугольник.

• Теперь поддерживаем Xcode 12.5.1+.

2.1.4

• Добавили конфигурацию SDK через лицензии.

2.1.3

• Добавили жест One Shot.

• В OZVerificationResult добавили bestShotURL (содержит изображение лучшего кадра) и preferredMediaURL (содержит медиаконтейнер с url лучшего видео для назначения анализа)

• При запуске локальной проверки теперь можно указать тип камеры: front / back.

2.1.2

• Авторизационные сессии теперь пролонгируются автоматически.

• Обновили интерфейсы авторизации.

2.1.1

• Добавили казахский язык.

• Добавили тексты для ошибок лицензирования.

2.1.0

• Сетевые запросы теперь можно отменить.

• Для лицензии можно указать Bundle.

• Добавили параметризации анализов documentAnalyse.

• Исправили ошибки при сборках проекта. (Xcode 12.4 / Cocoapods 1.10.1).

2.0.0

• Добавили поддержку лицензий.

• Теперь поддерживаем Xcode 12. 11 поддерживать перестали.

• Исправили ошибку documentAnalyse – анализы не назначались без указания analyseStates. Теперь все корректно.

• Поправили ошибки в сборе логов.

8.22.0 – 01.12.2025

• Исправили ошибки, из-за которых SDK мог иногда вылетать на некоторых моделях телефонов.

• Повысили безопасность.

8.21.0 – 12.11.2025

• Улучшили производительность SDK на некоторых устройствах.

• Обновили SDK в рамках подготовки к внедрению новой функциональности, связанной с безопасностью.

8.20.0 – 10.10.2025

• Исправили ошибку, из-за которой на некоторых моделях телефонов могли записываться зеленые видео.

• Исправили ошибку с mediaId = null.

• Повысили безопасность.

8.19.0 – 15.09.2025

• Исправили ошибку, из-за которой при запуске Fragment могло появляться предупреждение.

• SDK больше не вылетает при вызове copyPlane.

• Если при гибридном анализе вы выбираете отправку сжатых видео, оригинальные видео больше не сохраняются вместе со сжатыми.

• Обновили ссылку на сайт Oz Forensics.

• Повысили безопасность.

8.18.4 – 29.08.2025

• Чтобы обеспечить поддержку размера страниц памяти в 16 КБ, перевели TensorFlow на Lite RT.

8.18.2 – 07.08.2025

• Исправили ошибку с увеличением длительности и размера видео.

8.18.0 – 16.07.2025

• Теперь поддерживаем Google Dynamic Feature Delivery.

• Исправили ошибку, из-за которой SDK мог вылететь при нажатии кнопки закрытия экрана Liveness.

• Исправили ошибку вылета SDK с исключением CameraDevice was already closed.

• Обновления безопасности и телеметрии.

8.17.3 – 02.07.2025

• Устранили проблему несовместимости версий OkHttp.

• Исправили ошибку с Fragment, который не мог обнаружить контекст.

8.17.2 – 26.06.2025

• Исправили ошибку доступа к камере, которая иногда возникала на некоторых моделях смартфонов.

8.17.1 – 23.06.2025

• Обновления безопасности.

8.17.0 – 22.05.2025

• Обновления безопасности.

8.16.3 – 08.04.2025

• Обновления безопасности.

8.16.2 – 19.03.2025

• Исправили ошибку, из-за которой SDK мог вылететь при закрытии экрана съемки.

8.16.1 – 14.03.2025

• Обновления безопасности.

8.16.0 – 11.03.2025

• Обновили логику авторизации.

• Улучшили логику озвучивания подсказок.

• Исправили наблюдавшуюся на некоторых устройствах ошибку с зависанием SDK после завершения съемки видео.

• SDK больше не вылетает при попытке обратиться к закрытым или не инициализированным ресурсам.

• Обновления безопасности.

8.15.6 – 26.02.2025

• Обновления безопасности.

8.15.5 – 18.02.2025

• Валидацию видео – опцию, которая запускает запись видео заново, если получившийся файл состоит из 3 кадров и менее – теперь можно отключить. Воспользуйтесь настройкой disableFramesCountValidation.

• Исправили ошибку, из-за которой на некоторых моделях телефонов могли записываться зеленые видео.

• Обновления безопасности.

8.15.4 – 11.02.2025

• Исправили ошибки, из-за которых на некоторых моделях телефонов могли возникать сбои.

8.15.0 – 30.12.2024

• Добавлен правильный порядок фокусировки для VoiceOver при включенной антискам-подсказке.

• Добавлена ​​публичная настройка extract_action_shot в Демо Приложении.

• Исправили ошибки.

• Обновления безопасности.

8.14.1 – 05.12.2024

• Исправили ошибку, из-за которой некоторые записанные SDK видео были зелеными.

• Исправили проблемы с кодеками, появлявшиеся на некоторых моделях смартфонов.

8.14.0 – 02.12.2024

• Обновления доступности для пользователей с инвалидностью согласно требованиям WCAG: можно настроить озвучивание подсказок SDK и элементов управления.

• Упростили прохождение проверки для жестов, включающих движение головы.

• Сжатие больших видео теперь происходит позже: на этапе закрытия экрана Liveness.

• Исправили ошибку, из-за которой изображение с закрытыми глазами могло быть выбрано в качестве лучшего кадра.

• Исправили незначительные ошибки.

• Обновления телеметрии.

8.13.0 – 12.11.2024

• Обновления безопасности и телеметрии.

8.12.4 – 01.10.2024

• Обновления безопасности.

8.12.2 – 10.09.2024

• Обновления безопасности.

8.12.0 – 29.08.2024

• Обновления безопасности и телеметрии.

8.11.0 – 19.08.2024

• Исправили ошибку RuntimeException, появлявшуюся в режиме серверного Liveness на некоторых моделях телефонов.

• Обновления безопасности.

8.10.0 – 26.07.2024

• Обновления безопасности.

• Исправили ошибки.

8.9.0 – 18.07.2024

• Подняли версию плагина Android Gradle до 8.0.0.

• Улучшили работу SDK.

8.8.3 – 11.07.2024

• Улучшили работу SDK.

8.8.2 – 21.06.2024

• Обновления безопасности.

8.8.1 – 12.06.2024

• Обновления безопасности.

8.8.0 – 04.06.2024

• Обновления безопасности.

8.7.3 – 03.06.2024

• Обновления безопасности.

8.7.0 – 06.05.2024

• При попытке передать пустую строку в качестве аргумента для метода setFolderId теперь показывается информативная ошибка.

• Исправили ошибку с бесконечно крутящимся спиннером, который появлялся при переключении пользователя на другое приложение во время прохождения проверки Liveness.

• Исправили несколько ошибок, появлявшихся только на определенных моделях смартфонов.

8.6.0 – 05.04.2024

• Улучшили модель Liveness для проверки на устройстве.

• Обновления безопасности.

8.5.0 – 27.02.2024

• Длительность жеста Селфи теперь можно менять (размер видеофайла также изменится).

• Вы можете заменить логотип Oz своим, если ваша лицензия это предусматривает.

• Убрали паузу после жеста Сканирование.

• Если размер записанного видеофайла больше 10 Мбайт, видео будет сжато.

• Обновления безопасности и журналирования.

8.4.4 – 06.02.2024

• Изменили алгоритм валидации для мастер-лицензии.

8.4.3 – 29.01.2024

• Снизили требования к compileSdkVersion с 34 до 33.

8.4.2 – 15.01.2024

• Обновления безопасности.

8.4.0 – 04.01.2024

• Обновили модель Liveness для проверки на устройстве.

• Исправили ошибки.

8.3.3 – 11.12.2023

• Улучшили работу механизмов лицензирования.

8.3.2 – 30.11.2023

• Улучшили работу SDK.

8.3.1 – 24.11.2023

• Исправили ошибки.

8.3.0 – 17.11.2023

• Добавили возможность использования мастер-лицензии, которая работает с любым bundle_id.

• Исправили ошибку со сжатием видео при гибридном анализе, которая возникала на некоторых моделях телефонов.

8.2.1 – 01.11.2023

• Исправили ошибки.

8.2.0 – 23.10.2023

• Добавили в структуру Analysis поле sizeReductionStrategy. Оно определяет размер файла, отправляемого на сервер после успешного завершения проверки на устройстве в составе гибридного анализа.

• Настройка toFrameGradientColor для кастомизации подсказки hintAnimationCustomization больше не используется. Вместо нее используйте hintGradientColor.

• Сообщения для получаемых из API ошибок теперь детализированы.

8.1.1 – 02.10.2023

• Если несколько анализов назначаются на папку одновременно, система отправляет их группой. Таким образом, выбирается “худший” результат среди всех анализов, а не последний назначенный. Прочитать про отправку анализов группой можно здесь.

• В анализе Liveness для количественного результата теперь берется максимальный из вычисленных. Прочитать о результате можно здесь.

8.1.0 – 07.09.2023

• Обновили модель Liveness для проверки на устройстве.

• Добавили португальский язык (бразильский вариант).

• Вы теперь можете добавить язык или изменить текущие переводы самостоятельно. Как это сделать, описано здесь.

• Если медиафайл по каким-то причинам не загрузился, система повторяет загрузку.

• Добавили новый метод для получения идентификатора телеметрии (логирования): getEventSessionId.

• Методы auth и login больше не используются. Вместо них, пожалуйста, используйте метод setApiConnection.

• OzConfig.baseURL и OzConfig.permanentAccessToken больше не используются.

• Если пользователь закрывает экран во время съемки видео, соответствующая ошибка обрабатывается SDK.

• Исправили ошибки и улучшили работу SDK.

8.0.3 – 24.08.2023

• Исправили ошибки.

8.0.2 – 13.07.2023

• При установке baseURL = null SDK теперь работает корректно.

8.0.1 – 28.06.2023

• Версии зависимостей SDK приведены в соответствие с версией Kotlin.

8.0.0 – 19.06.2023

• Добавлен новый тип анализа – гибридный (сейчас работает только для Liveness). В случае спорных результатов анализа на устройстве проводится дополнительная проверка на сервере.

• Требования к версии Kotlin понижены до 1.7.21.

• Обновлены модели для анализов на устройстве.

• На некоторых моделях телефонов исправлена ошибка fatal device.

• Текст подсказки теперь может выходить за границы рамки для лица по горизонтали (для основной камеры).

• Фото, снятые во время однокадрового анализа, теперь передаются на сервер в оригинальном размере.

• Удален класс OzAnalysisResult. В параметре onSuccess метода AnalysisRequest.run вместо списка OzAnalysisResult теперь передается структура RequestResult.

• Все исключения перенесены в папку com.ozforensics.liveness.sdk.core.exceptions (детальная информация ниже).

• Связанные с AnalysisRequest классы перенесены в com.ozforensics.liveness.sdk.analysis (детальная информация ниже).

• Прекращена поддержка методов:

7.3.1 – 07.06.2023

• Обновили экран настроек.

• Добавили настройки для фона подсказки.

• Добавили новые формы рамки (круг, квадрат).

• Добавили виджет для защиты от мошенничества и набор настроек к нему. С помощью этого виджета вы можете уведомлять пользователей, что ведется съемка видео для, например, отправления заявки на кредит. Таким образом вы сможете защитить пользователей, если мошенники попытаются убедить их подтвердить такой запрос.

• Метод OzLivenessSDK::init при передаче параметра StatusListener теперь работает корректно.

• Изменили анимацию жеста "Сканирование".

7.2.0 – 04.05.2023

• Улучшили работу алгоритмов SDK.

7.1.4 – 30.03.2023

• Обновили модель для выполнения анализов на устройстве.

• Обновили анимацию для солнечных очков / маски.

• Немного уменьшили размеры овала для Liveness.

7.1.3 – 03.03.2023

• Исправили ошибку, появлявшуюся при выполнении серверных анализов после использования для авторизации permanentAccessToken.

7.1.2 – 22.02.2023

• Добавили возможность анимации подсказки.

• Полосу статуса и системные кнопки теперь можно скрывать (работает с версии 7.0.0).

• В метод OzLivenessSDK.init теперь нужно первым параметром передавать context.

• OzAnalysisResult теперь корректно показывает оценки по серверным анализам.

• Исправлены ошибки инициализации и некорректного отображения настроек кастомизации, а также ошибки некорректной авторизации на версиях Android < 7.1.1.

7.1.1 – 16.01.2023

• Исправили ошибку с вылетами на версиях Android <6.

• Поправили расположение овала для некоторых моделей телефонов.

• Улучшили работу SDK.

7.1.0 – 16.12.2022

• Обновили систему безопасности.

• Добавили некоторые внутренние улучшения.

• Метод addMedia больше не работает. Для загрузки медиафайлов воспользуйтесь методом uploadMedia.

7.0.0 – 23.11.2022

• Из соображений безопасности мы теперь поставляем два типа библиотек: sdk только для серверного анализа и full для серверного анализа и анализа на устройстве.

• Заменили OzCustomization на UICustomization.

• Значительно расширили список настроек кастомизации SDK и обновили дизайн. Если вы хотите вернуть дизайн из прошлых версий, соответствующие настройки описаны здесь.

• Добавили испанский язык.

6.4.2

• Исправили ошибку с зависаниями на некоторых моделях телефонов.

• SDK теперь снимает видео в разрешении 720p (с 6.4.2.3).

6.4.1

• Наименование режимов анализа приведено в соответствие с iOS: SERVER_BASED и ON_DEVICE.

• Исправили ошибку с отображением настроек локализации.

6.4.0

• Теперь в качестве Liveness-экрана можно использовать Fragment.

• Добавили новое поле params в структуру Analysis – с его помощью можно задавать дополнительные параметры, например, для извлечения на сервере лучшего кадра. Алгоритм "лучший кадр" выбирает из видеозаписи наиболее качественный и удачный кадр с лицом.

6.3.7

• Жесты отдаления и приближения больше не поддерживаются.

6.3.6

• Обновили биометрическую модель.

6.3.5

• Добавили новую упрощенную структуру AnalysisRequest – теперь конструировать запросы на анализы стало проще и удобнее.

6.3.4

• Добавили модуль для выполнения анализов локально на устройстве. Подключите модуль:

    implementation 'com.ozforensics.liveness:on-device:6.3.4'

Для запуска анализов biometry и liveness используйте соответствующие методы класса OzLivenessSDK: runOnDeviceBiometryAnalysis и runOnDeviceLivenessAnalysis.

val mediaList: List<OzAbstractMedia> = ...
val biometryAnalysisResult: OzAnalysisResult = OzLivenessSDK.runOnDeviceBiometryAnalysis(mediaList)
val livenessAnalysisResult: OzAnalysisResult = OzLivenessSDK.runOnDeviceLivenessAnalysis(mediaList)

6.3.3

• Liveness теперь работает плавнее.

• На устройствах Xiaomi больше не зависает камера.

• Оптимизировали преобразования изображений с камеры.

6.3.1

• В OzLivenessSDK.uploadMedia добавили параметр metadata и методы OzLivenessSDK.uploadMediaAndAnalyze для передачи metadata в папки.

6.2.8

• Добавили функции для инициализации SDK с лицензиями LicenseSources: LicenseSource.LicenseAssetId иLicenseSource.LicenseFilePath. Для инициализации используйте метод OzLivenessSDK.init.

• Добавили возможность получения информации о лицензии после инициализации val licensePayload = OzLivenessSDK.getLicensePayload().

6.2.4

• Добавили киргизский язык.

6.2.0

• Добавили функции для локальных анализов.

• Добавили конфигурацию рамки вокруг лица.

• Номер версии на экране Liveness теперь отображается корректно.

6.1.0

• Добавили поддержку основной камеры.

6.0.0

• Добавили жест OneShot.

• Добавили состояний в OzAnalysisResult.Resolution.

• Добавили метод uploadMediaAndAnalyze – он загружает список изображений/видео на сервер и сразу отправляет их на анализ.

• OzMedia превратили в OzAbstractMedia и добавили подклассы изображений и видео.

• Исправили ошибки камеры на некоторых устройствах.

5.1.0

• Токен доступа теперь обновляется автоматически.

• Переименовали accessToken в permanentAccessToken.

• Добавили правила R8.

• Упростили процесс конфигурации. Свойства config теперь можно менять.

5.0.2

• Исправили овальную рамку.

• Убрали неиспользуемые параметры params из AnalyseRequest.

• Убрали лимит по умолчанию на количество попыток.

5.0.0

• Убрали свойства конфигурации - baseURL, accessToken и так далее. Заменили их на свойство config, которое нужно инициализировать с помощью OzConfig.Builder.

• Добавили поддержку лицензий. Их нужно устанавливать как raw ресурсы и передавать в OzConfig через setLicenseResourceId.

• Убрали методы, которым нужен был контекст. Заменили аналогами.

• Анализ изображений теперь работает лучше.

• Убрали ненужные зависимости.

• Поправили ошибки журналирования.