Comenzando

1. Instalar el Plugin

   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. Sincronizar plataformas nativas

   npm

   npx cap sync

   pnpm

   pnpm cap sync

   yarn

   yarn cap sync

   bun

   bunx cap sync

Iniciar un escaneo

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('Archivos escaneados:', result.scannedImages);
} else {
  console.log('Escaneo cancelado por el usuario');
}

Devolver datos base64

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

const [firstPage] = result.scannedImages ?? [];
if (firstPage) {
  const dataUrl = `data:image/jpeg;base64,${firstPage}`;
  // Mostrar vista previa o cargar al servidor
}

Requisitos de plataforma

• iOS: Agrega NSCameraUsageDescription a ios/App/App/Info.plist explicando cómo usas la cámara.
• Android: Confirma que el permiso CAMERA esté declarado (Capacitor lo agrega automáticamente) y ajusta croppedImageQuality, letUserAdjustCrop y maxNumDocuments para que coincidan con tu interfaz de usuario.
• Almacenamiento: Cuando uses ResponseType.ImageFilePath, mueve o copia los archivos escaneados a tu ubicación de almacenamiento deseada antes de que finalice la sesión de la aplicación.