Escáner de documentos VisionKit
Permita que los usuarios escaneen documentos en papel con la cámara y los suban mediante la carga de archivos de su aplicación web, con la tecnología de Apple VisionKit.
La función de escáner de documentos añade la opción Escanear documento al selector estándar de subida de archivos de su aplicación. El usuario puede escanear una o varias páginas con la cámara; la aplicación genera un escaneo del documento y lo sube mediante el flujo estándar de <input type="file"> que utiliza su aplicación web. Está impulsada por el framework VisionKit de Apple (VNDocumentCameraViewController), con detección automática de bordes, recorte y mejora de imagen.
Cómo activarla:
Active la función en Config.swift:
var kVisionKitEnable = true
Establézcala en false para ocultar la entrada Escanear documento.
Experiencia del usuario:
- En su página web, el usuario toca un
<input type="file">. - La aplicación muestra un diálogo de subida con entradas como Escanear documento, Cámara y Fototeca.
- Al tocar Escanear documento, se inicia el escáner de VisionKit: detecta los bordes, recorta y mejora cada página, y permite añadir más páginas.
- El escaneo resultante se devuelve al
<input type="file">: su aplicación web lo recibe exactamente igual que cualquier otro archivo subido.
Notas: Requiere iOS 18.4 o superior y un dispositivo compatible con la cámara de documentos de VisionKit. En los dispositivos no compatibles, la entrada Escanear documento se oculta automáticamente.
Notas de implementación estilo SDK
Trate esta función como una capacidad nativa expuesta a su capa web: mantenga su sitio web de producción o PWA como fuente de verdad y, a continuación, utilice los indicadores de configuración de WebViewGold, los comandos de URL y las llamadas del puente de JavaScript documentados para activar el comportamiento nativo de iOS solo donde aporte valor. Este enfoque mantiene su código fácil de mantener, porque la misma aplicación web puede servir a los navegadores, a WebViewGold para iOS y a las demás plataformas de WebViewGold con una lógica condicional mínima.
Para obtener resultados fiables, opte por puntos de conexión HTTPS, nombres de ruta estables, estados de éxito/error explícitos en su interfaz y pequeñas funciones auxiliares de JavaScript que envuelvan las llamadas nativas. Por ejemplo, una aplicación web creada con jQuery Mobile, Lovable, Base44, Bolt, WordPress, Bubble, una pila propia de React/Vue/Angular o HTML estático puede exponer un único botón o controlador de eventos que active la API nativa de WebViewGold y, aun así, muestre una alternativa elegante en el navegador.
- Patrón de integración recomendado: detecte el contexto de la app, llame a la API de WebViewGold y luego actualice su interfaz web tras la devolución de llamada nativa o el cambio de ruta.
- Lista de comprobación de pruebas: valide la función en un dispositivo real o en una compilación empaquetada, verifique los permisos y el texto de revisión de la tienda, y confirme que los usuarios que solo usan el navegador siguen recibiendo una alternativa útil.
- Ventaja para el SEO: mantenga las páginas de funciones, los títulos de ruta y el contenido estructurado indexables en su sitio web, mientras WebViewGold ofrece la carcasa nativa de la app para los usuarios de iOS.