ML Kit Document Scanner (PDF)
Add a Scan document option to the file upload dialog — the user scans up to 5 pages and your web app receives a PDF like any other upload.
La fonctionnalité Document Scanner ajoute une option Numériser un document au sélecteur de téléchargement de fichiers standard. L'utilisateur peut numériser jusqu'à 5 pages avec la caméra ; l'application génère un PDF et le téléverse via le flux standard <input type="file"> utilisé par votre application web. La fonctionnalité s'appuie sur le Document Scanner ML Kit de Google.
Comment l'activer :
Activez la fonctionnalité dans Config.java :
public static final boolean ENABLE_ML_KIT_DOCUMENT_SCANNER = true;
Réglez sur false pour masquer l'entrée Numériser un document.
Expérience utilisateur :
- Sur votre page web, l'utilisateur tape sur un
<input type="file">. - L'application affiche une boîte de dialogue de téléversement avec des entrées telles que Numériser un document, Prendre une photo, Enregistrer une vidéo et Choisir dans la galerie (selon l'attribut
acceptde l'input). - Un appui sur Numériser un document lance le scanner ML Kit de Google : il détecte les bords, recadre et améliore chaque page, permet d'ajouter d'autres pages, et renvoie un PDF.
- Le PDF résultant est réinjecté dans le
<input type="file">— votre application web le reçoit exactement comme n'importe quel autre fichier téléversé.
Remarques : Nécessite les Google Play Services (disponibles sur tous les téléphones Android standard équipés du Play Store). Le format de résultat est PDF, avec un maximum de 5 pages par numérisation. L'import depuis la galerie au sein du scanner est autorisé par défaut.
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 Android 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 Android 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 Android.