Exigences WebView

Ce qu'une WebView doit prendre en charge pour qu'une expérience OmniLab fonctionne dans votre app.

3 min de lecture

Confirmez ces points avant que votre équipe mobile ne commence le développement. Quand l'un d'eux manque, l'expérience semble défaillante, sans que rien n'indique un réglage manquant : c'est pourquoi les découvrir tard coûte cher.

La WebView elle-même

  • JavaScript activé. Rien ne se charge sans lui. Il est désactivé par défaut dans une WebView Android standard.
  • Un composant WebView récent. Utilisez le composant standard de la plateforme ou un wrapper maintenu. Les anciens navigateurs intégrés gèrent mal les animations et les mises en page modernes, et affichent généralement un écran blanc plutôt qu'une erreur.
  • Cookies et stockage local autorisés, y compris pour le domaine de l'expérience. L'expérience s'en sert pour reconnaître un participant d'un écran à l'autre. Si vous les bloquez, le participant semble déconnecté en plein parcours.
  • Un conteneur plein écran ou bord à bord. Une WebView placée dans un conteneur court, à hauteur fixe, rogne les jeux.

Permissions

C'est votre app qui accorde les permissions, pas OmniLab. La WebView doit aussi relayer la demande de la page vers la fenêtre d'autorisation native : déclarer la permission dans le manifeste de l'app ne suffit pas.

L'expérience utiliseVotre app doit fournir
Un scan de QR code, par exemple dans une chasse au trésorL'accès à la caméra
L'envoi d'un ticket de caisse, ou un champ photo dans un formulaireUn sélecteur de fichiers, avec la caméra et la photothèque
Une vérification de position, par exemple dans une chasse au trésor, un jeu instantané ou un enregistrement en autonomieL'accès à la localisation
Le fichier calendrier ou le billet d'une réservation, ou une photo à garderUn moyen d'enregistrer un fichier que la page crée elle-même : voir Enregistrer les fichiers

Testez chacune sur un vrai appareil. Les simulateurs accordent les permissions différemment, et réussissent là où un vrai téléphone échoue.

Pourquoi la connexion fonctionne ici

Une WebView charge l'expérience en tant que page, et non à l'intérieur d'une page : l'expérience n'y est donc pas considérée comme un contenu tiers. Les cookies se comportent normalement et la connexion est conservée. Pour transmettre un membre connecté avec fci, il suffit de garder les hôtes de connexion dans la vue. Votre système d'identité client doit en revanche être connecté au préalable : voir Transmettre un client connu à une expérience.

La connexion quitte brièvement le domaine de l'expérience, en passant par une adresse de connexion et par votre fournisseur d'identité. Gardez ces pages dans la WebView. Un filtre qui les envoie vers le navigateur du téléphone rend la connexion impossible : voir Développer la WebView.

Ne construisez pas votre propre page HTML dans la WebView avec l'expérience dans une iframe. Cela recrée le problème de contexte tiers qu'une WebView simple évite, et la connexion cesse de fonctionner. Pointez la WebView directement sur l'adresse de l'expérience.

Clavier et formulaires

Si l'expérience comporte un formulaire ou une étape de connexion, vérifiez que le clavier ne couvre pas le champ en cours de saisie, et que la vue défile pour le garder visible. C'est le défaut WebView le plus fréquent, et il vous fait perdre l'inscription.

Session et navigation

  • Définissez le comportement de votre bouton retour en cours d'expérience. Quitter l'expérience à mi-parcours doit être un choix délibéré, pas un accident.
  • Vérifiez que l'expérience résiste au passage de l'app en arrière-plan puis à son retour au premier plan.
  • Vérifiez qu'après une perte de connexion, le participant peut reprendre son parcours.

Tailles d'écran

Testez le plus petit téléphone que vous prenez en charge et la plus grande tablette. Testez les deux orientations si votre app autorise la rotation.

Étapes suivantes

Sur cette page