Quan usar WebView
Usa la integració amb WebView només quan:- Desenvolupes en una plataforma sense SDK natiu (per exemple, Xamarin, Cordova o altres frameworks de nínxol)
- Necessites un prototip ràpid o una prova de concepte abans d’integrar el SDK natiu
- Estàs migrant des del web i vols un pont temporal cap a una integració nativa
Com funciona
1
Crea una sessió
El teu backend crida l’API de creació de sessió i rep una
url allotjada.2
Obre-la en un WebView
La teva aplicació carrega el
url en un component WebView.3
L'usuari completa la verificació
L’usuari segueix el flux de verificació dins del WebView.
4
Intercepta el callback
Quan acaba, el WebView navega cap a la teva URL de callback. La teva aplicació intercepta aquesta navegació i extreu el resultat.
5
Obtén els resultats complets mitjançant webhook
El teu backend rep les dades completes de la decisió mitjançant el webhook.
Crear una sessió
Abans d’obrir el flux de verificació, crea una sessió des del teu backend:201: el url incrusta el session_token de 12 caràcters, no el session_id):
url en el WebView. Mai no el construeixis a partir de session_token manualment.
React Native
Instal·la el paquet de WebView:Implementació
Demo de React Native
Exemple de verificació amb Expo i WebView
Flutter
Afegeix els paquets necessaris apubspec.yaml:
Implementació
Demo de Flutter
Exemple de verificació amb WebView en Flutter
Configuració crítica
Agent d’usuari (obligatori)
Has d’establir un agent d’usuari genèric de mòbil perquè el WebView funcioni correctament:Configuració multimèdia (obligatòria)
Gestió del callback
Després de la verificació, el WebView redirigeix a la teva URL de callback amb paràmetres de consulta:Resolució de problemes
La càmera no funciona
La càmera no funciona
- Assegura’t que
mediaPlaybackRequiresUserGesturesiguifalse - Verifica que el sistema operatiu hagi concedit els permisos de càmera
- Comprova que la cadena de user agent estigui ben configurada
Pantalla en blanc o problemes de càrrega
Pantalla en blanc o problemes de càrrega
- Verifica que la URL de la sessió sigui vàlida i no hagi caducat
- Comprova la connectivitat a Internet
- Assegura’t que JavaScript estigui habilitat a la configuració del WebView
El callback no s'activa
El callback no s'activa
- Verifica que la teva URL de callback coincideixi amb la que vas definir en crear la sessió
- Comprova que el delegat o l’escoltador de navegació estigui configurat correctament
- Prova d’establir
callback_methoda"both"en crear la sessió