Scanner de documents VisionKit
Permettez aux utilisateurs de scanner des documents papier avec l'appareil photo et de les téléverser via l'upload de fichiers de votre application web — propulsé par Apple VisionKit.
La fonctionnalité Scanner de documents ajoute une option Scanner un document au sélecteur standard de téléversement de fichiers de votre application. L'utilisateur peut scanner une ou plusieurs pages avec l'appareil photo ; l'application produit un scan du document et le téléverse via le flux standard <input type="file"> utilisé par votre application web. Elle s'appuie sur le framework VisionKit d'Apple (VNDocumentCameraViewController) — avec détection automatique des bords, recadrage et amélioration de l'image.
Activation :
Activez la fonctionnalité dans Config.swift :
var kVisionKitEnable = true
Définissez-la sur false pour masquer l'entrée Scanner un document.
Expérience utilisateur :
- Sur votre page web, l'utilisateur touche un
<input type="file">. - L'application affiche une boîte de dialogue de téléversement avec des entrées telles que Scanner un document, Appareil photo et Photothèque.
- Toucher Scanner un document lance le scanner VisionKit : il détecte les bords, recadre et améliore chaque page, et permet d'ajouter d'autres pages.
- Le scan obtenu est renvoyé dans le
<input type="file">— votre application web le reçoit exactement comme n'importe quel autre fichier téléversé.
Remarques : nécessite iOS 18.4 ou version ultérieure et un appareil prenant en charge la caméra de documents VisionKit. Sur les appareils non compatibles, l'entrée Scanner un document est masquée automatiquement.
Notes d’implémentation façon SDK
Considérez cette fonctionnalité comme une capacité native exposée à votre couche web : conservez votre site web de production ou votre PWA comme source de vérité, puis utilisez les indicateurs de configuration WebViewGold documentés, les commandes URL et les appels du pont JavaScript pour activer le comportement natif iOS uniquement là où il apporte de la valeur. Cette approche garde votre base de code maintenable, car la même application web peut servir les navigateurs, WebViewGold pour iOS et les autres plateformes WebViewGold avec un minimum de logique conditionnelle.
Pour des résultats fiables, privilégiez les points de terminaison HTTPS, des noms de routes stables, des états de succès/erreur explicites dans votre interface et de petites fonctions JavaScript qui encapsulent les appels natifs. Par exemple, une application web créée avec jQuery Mobile, Lovable, Base44, Bolt, WordPress, Bubble, une pile React/Vue/Angular personnalisée ou du HTML statique peut exposer un seul bouton ou gestionnaire d’événement qui déclenche l’API native WebViewGold tout en affichant une solution de repli élégante dans le navigateur.
- Modèle d’intégration recommandé : détectez le contexte de l’application, appelez l’API WebViewGold, puis mettez à jour votre interface web après le rappel natif ou le changement de route.
- Liste de vérification des tests : validez la fonctionnalité sur un appareil réel ou une build empaquetée, vérifiez les autorisations et le texte de revue du store, et confirmez que les utilisateurs navigateur uniquement reçoivent toujours une solution de repli utile.
- Avantage SEO : gardez les pages de fonctionnalités, les titres de routes et le contenu structuré indexables sur votre site web pendant que WebViewGold fournit l’enveloppe d’application native pour les utilisateurs iOS.