Version actuelle
La dernière version compat du SDK iOS Liveness est la 0.1.7. Elle prend en charge iOS 12 et les versions antérieures, et couvre donc aussi les intégrations plus anciennes.Prérequis
- Cible de déploiement iOS minimale : iOS 12.0
- Permission caméra déclarée (
NSCameraUsageDescriptiondansInfo.plist) - Swift 6.1 (défini dans
swift_versionsdu pod)
Étape 1 — Ajouter le SDK
- CocoaPods
- Swift Package Manager
Ajoutez le pod à votre Exécutez ensuite :
Podfile :Étape 2 — Déclarer la permission caméra
Ajoutez la clé suivante à votreInfo.plist :
Étape 3 — Générer les jetons côté serveur
Avant d’initialiser le SDK, votre backend doit générer un identifiant de session et un jeton de vivacité. Utilisez l’assistantApiClient ci-dessous comme référence pour les appels requis.
Générer l’identifiant de session : POST /v2/api/identity/sdk/session/generate :
POST /v2/api/identity/sdk/liveness/token :
Étape 4 — Initialiser et lancer le SDK
1
Importer le package
2
Initialiser le SDK avec les jetons
3
Démarrer la tâche de vivacité
4
Ajouter le view controller de vivacité
5
Gérer le delegate de fermeture
Tâches de vivacité disponibles
Toutes les tâches acceptent un paramètre
difficulty (.easy, .medium, .hard) et un timeout facultatif en millisecondes.
Options de configuration
Identifiant de session généré côté serveur via
POST /v2/api/identity/sdk/session/generate.Informations sur l’utilisateur.
firstName est obligatoire ; lastName et email sont facultatifs.Définissez-le sur
true pour activer la narration audio des instructions des tâches.Données de callback (LivenessData)
Présent uniquement en cas d’échec. Contient
key (par ex. eyes_closed, image_capture_failed, invalid_or_expired_session) et message.Version iOS (Compat)
La version compat du SDK est destinée aux intégrations nécessitant la prise en charge d’iOS 12 et des versions antérieures, ou de bases de code héritées. La version actuelle est la 0.1.7. Installez-la via CocoaPods :import YouverifyLivenessSDK, car c’est le nom du module.
Le pod exclut l’architecture
arm64 pour le simulateur iOS. Sur un Mac Apple silicon, exécutez le simulateur avec Rosetta ou testez sur un appareil physique.Si vous recevez une erreur
invalid_or_expired_session, votre identifiant de session a expiré. Générez de nouvelles valeurs sessionId et sessionToken depuis votre backend et appelez de nouveau initializeSDK avec ces valeurs.