iOS SDK
Ласкаво просимо до документації Identomat iOS SDK! Тут ви знайдете все необхідне для безшовної інтеграції наших рішень з верифікації особи та KYC/AML у ваш iOS-застосунок.
Документація з інтеграції
Бібліотека Identomat надає потік ідентифікації користувача, що складається з різних кроків, які поєднують тип документа та зображення/відео користувача для верифікації.
Для початку сесії за допомогою API Identomat необхідні такі кроки
1. Отримати токен сесії та налаштувати сесію
Щоб почати сесію, спочатку потрібно отримати session_token, викликавши ендпоінт begin/ та налаштувавши ваш потік верифікації.
⚠️ Примітка: Цей процес ідентичний для веб- та SDK-інтеграцій.
Повні деталі щодо генерації токена сесії, налаштування кроків та прапорців, а також запуску сесії див. у Посібнику з веб-інтеграції — ініціалізація сесії.
Отримавши токен сесії, ви можете продовжити інтеграцію його у ваш потік SDK.
2. Отримати екземпляр Identomat SDK та передати дані
Основний клас Identomat SDK — це клас IdentomatManager.
IdentomatManager — клас-синглтон в Identomat SDK.
Щоб отримати змінну SDK, ви можете використати такий код:
Альтернативно, ви можете щоразу викликати IdentomatManager.getInstance(), і він поверне той самий екземпляр Identomat SDK.
3. Передати токен сесії та обробити колбек
sessionToken – Відповідь від API: тип
String.
Щоб передати токен сесії, ми використовуємо функцію setUp, яку можна викликати так:
Останній крок — передати функцію колбека, яка буде запущена після завершення взаємодії користувача з бібліотекою. Для цього використовуйте функцію .callback, яка приймає функцію як аргумент:
4. Запустити Identomat SDK
Спочатку вам потрібно отримати стартовий view бібліотеки, а потім показати його користувачу.
5. Передати додаткові змінні
Для налаштування бібліотеки Identomat під застосунок у нас є декілька додаткових функцій:
setColors(colors: [String : String])- встановлює конкретні кольори 2.1setStringsTableName(tableNme : String)- встановлює рядки за файлом мов 2.2setStrings(dict : [String : Any?])- встановлює конкретні текстові рядкиsetVariables(variables : [String : Any?])- встановлює багато настроюваних зміннихsetLogo(view: UIView)- встановлює індикатор завантаження
Наступні функції у пункті 5 є ЗАСТАРІЛИМИ після версії 0.0.73
5.1 setTitleFont(fontname: String, size : Int) - встановлює шрифт заголовка в бібліотеці
5.2 setHeadlineFont(fontname: String, size : Int) - встановлює шрифт заголовка в бібліотеці
5.3 setBodyFont(fontname: String, size : Int ) - встановлює шрифт основного тексту в бібліотеці
5.4 skipLivenessInstructions() - пропускає інструкції перевірки живості
5.5 setLivenessIcons(neutralFace: UIImage?, smileFace: UIImage?) - встановлює іконки перевірки живості
5.6 setLivenessRetryIcon(retryIcon: Int?, size : Int) - встановлює головну іконку панелі повторних спроб перевірки живості, size встановлює розмір іконки
5.7 setRetryIcon(retryIcon: Int?, size : Int) - встановлює головну іконку панелі повторних спроб перегляду сканування документа, size встановлює розмір іконки
5.8 setCameraDenyIcon(cameraDenyIcon: Int?, size : Int) - встановлює головну іконку панелі повторних спроб перегляду сканування документа
5.9 hideStatusBar(_ bool : Bool), setStatusBarStyle(style : UIStatusBarStyle) - налаштування статус-бару
1. Налаштування кольорів
Використовуйте функцію setColors, щоб налаштувати кольори в бібліотеці відповідно до теми застосунку. Передайте словник, що містить відповідні ключі кольорів та їхні відповідні шістнадцяткові значення:
Спосіб передачі кольорів у бібліотеку:
2. Налаштування рядків
Щоб налаштувати рядки, які бібліотека відображає в конкретних місцях, ви можете використати дві функції:
setStrings(dict: [String: Any?])setStringsTableName(tableNme : String)
Це два різні методи налаштування рядків.
Функція setStrings приймає словник із конкретними ключами для різних мов. Структура виглядає так:
У другому підході ви використовуєте функцію setStringsTableName(tableName: String), де створюєте файл .strings у вашому проєкті та локалізуєте його для різних мов, так само як ви робили б для свого застосунку.
Ось як використовувати цей метод:
Створіть файл
.strings, наприклад,languages.strings.Локалізуйте файл для різних мов, як зазвичай робите у вашому проєкті.
Передайте назву файлу
.strings(без розширення) до бібліотеки, так:
3. Налаштування змінних
Для будь-якого іншого налаштування ми використовуємо функцію setVariables(variables: Map<String, Any?>), куди ми передаємо мапу пар ключ-значення змінних.
Структура мапи виглядає так:
4. Встановлення користувацького логотипу
setLogo(view: UIView) Ця функція використовується для встановлення користувацького логотипу в бібліотеці. Ви можете передати власний користувацький view та відображати на ньому будь-що (анімації, зображення тощо). Цей логотип відображатиметься, коли бібліотека щось обробляє.
Ключі рядків та значення за замовчуванням
Ключі рядків та їхні значення за замовчуванням для англійської мови (залишено англійською, оскільки це значення за замовчуванням у файлі ресурсів коду):
Last updated
Was this helpful?