VisionKit-Dokumentenscanner
Lass Nutzer Papierdokumente mit der Kamera scannen und über den Datei-Upload deiner Web-App hochladen — auf Basis von Apple VisionKit.
Das Dokumentenscanner-Feature ergänzt den Standard-Dateiupload-Dialog deiner App um die Option Dokument scannen. Der Nutzer kann eine oder mehrere Seiten mit der Kamera scannen; die App erzeugt einen Dokumentenscan und lädt ihn über den standardmäßigen <input type="file">-Flow deiner Web-App hoch. Es basiert auf Apples VisionKit-Framework (VNDocumentCameraViewController) — mit automatischer Kantenerkennung, Zuschnitt und Optimierung.
Aktivierung:
Schalte das Feature in Config.swift ein:
var kVisionKitEnable = true
Setze die Option auf false, um den Eintrag Dokument scannen auszublenden.
Nutzererlebnis:
- Auf deiner Webseite tippt der Nutzer auf ein
<input type="file">. - Die App zeigt einen Upload-Dialog mit Einträgen wie Dokument scannen, Kamera und Fotomediathek.
- Ein Tipp auf Dokument scannen startet den VisionKit-Scanner: Er erkennt Kanten, schneidet zu, optimiert jede Seite und erlaubt das Hinzufügen weiterer Seiten.
- Der fertige Scan wird in das
<input type="file">zurückgegeben — deine Web-App erhält ihn genau wie jede andere hochgeladene Datei.
Hinweise: Erfordert iOS 18.4 oder höher und ein Gerät, das die VisionKit-Dokumentenkamera unterstützt. Auf nicht unterstützten Geräten wird der Eintrag Dokument scannen automatisch ausgeblendet.
Implementierungshinweise im SDK-Stil
Betrachte diese Funktion als native Fähigkeit, die deiner Web-Ebene bereitgestellt wird: Behalte deine Produktivwebsite oder PWA als zentrale Quelle bei und nutze anschließend die dokumentierten WebViewGold-Konfigurationsflags, URL-Befehle und JavaScript-Bridge-Aufrufe, um natives iOS-Verhalten nur dort zu aktivieren, wo es einen Mehrwert bietet. So bleibt deine Codebasis wartbar, da dieselbe Webanwendung mit minimaler Fallunterscheidung Browser, WebViewGold für iOS und die übrigen WebViewGold-Plattformen bedienen kann.
Für zuverlässige Ergebnisse empfehlen sich HTTPS-Endpunkte, stabile Routennamen, explizite Erfolgs-/Fehlerzustände in deiner UI sowie kleine JavaScript-Hilfsfunktionen, die native Aufrufe kapseln. Beispielsweise kann eine mit jQuery Mobile, Lovable, Base44, Bolt, WordPress, Bubble, einem eigenen React-/Vue-/Angular-Stack oder statischem HTML erstellte Web-App eine einzelne Schaltfläche oder einen Event-Handler bereitstellen, der die native WebViewGold-API auslöst und dennoch einen sauberen Browser-Fallback zeigt.
- Empfohlenes Integrationsmuster: Erkenne den App-Kontext, rufe die WebViewGold-API auf und aktualisiere anschließend deine Web-UI nach dem nativen Callback oder Routenwechsel.
- Test-Checkliste: Prüfe die Funktion auf einem echten Gerät oder in einem paketierten Build, überprüfe Berechtigungen und Store-Prüftexte und stelle sicher, dass reine Browser-Nutzer weiterhin einen sinnvollen Fallback erhalten.
- SEO-Vorteil: Halte Feature-Seiten, Routentitel und strukturierte Inhalte auf deiner Website indexierbar, während WebViewGold die native App-Hülle für iOS-Nutzer bereitstellt.