Erste Schritte

1. Plugin installieren

   npm

   npm i @capgo/capacitor-document-scanner

   pnpm

   pnpm add @capgo/capacitor-document-scanner

   yarn

   yarn add @capgo/capacitor-document-scanner

   bun

   bun add @capgo/capacitor-document-scanner

2. Native Plattformen synchronisieren

   npm

   npx cap sync

   pnpm

   pnpm cap sync

   yarn

   yarn cap sync

   bun

   bunx cap sync

Einen Scan auslösen

import {
  DocumentScanner,
  ResponseType,
  ScanDocumentResponseStatus,
} from '@capgo/capacitor-document-scanner';

const result = await DocumentScanner.scanDocument({
  croppedImageQuality: 90,
  letUserAdjustCrop: true,
  maxNumDocuments: 10,
  responseType: ResponseType.ImageFilePath,
});

if (result.status === ScanDocumentResponseStatus.Success) {
  console.log('Gescannte Dateien:', result.scannedImages);
} else {
  console.log('Scan vom Benutzer abgebrochen');
}

Base64-Daten zurückgeben

const result = await DocumentScanner.scanDocument({
  responseType: ResponseType.Base64,
});

const [firstPage] = result.scannedImages ?? [];
if (firstPage) {
  const dataUrl = `data:image/jpeg;base64,${firstPage}`;
  // Vorschau anzeigen oder auf Server hochladen
}

Plattformanforderungen

• iOS: Fügen Sie NSCameraUsageDescription zu ios/App/App/Info.plist hinzu und erklären Sie, wie Sie die Kamera verwenden.
• Android: Bestätigen Sie, dass die CAMERA-Berechtigung deklariert ist (Capacitor fügt sie automatisch hinzu) und passen Sie croppedImageQuality, letUserAdjustCrop und maxNumDocuments an Ihre Benutzeroberfläche an.
• Speicher: Wenn Sie ResponseType.ImageFilePath verwenden, verschieben oder kopieren Sie die gescannten Dateien an Ihren gewünschten Speicherort, bevor die App-Sitzung endet.