@capgo/camera-preview

Resumen

@capgo/camera-preview renderiza un capa de cámara nativa detrás o encima de tu WebView con vista previa continua, captura de fotos, control de flash, relación de aspecto y opcionalmente escaneo de códigos de barrasEscaneo de pagos, overlays de estilo AR, UX de obturador personalizado y flujos de visión, sin redirigir a los usuarios a la cámara nativa.

Combínalo con @capgo/capacitor-uploader para subir capturas desde rutas de disco en lugar de cargar buffers completos en JavaScript.

Soporte de plataformas

Plataforma	Notas
iOS	Dispositivos multi-lente, pinch zoom y formatos de código de barras vía scanner nativo
Android	Vista previa de CameraX, resolución de captura configurable
Web	Soporte limitado, consulta el README del plugin para ver la web actual

Funcionalidades principales

• start - Inicia la vista previa de la cámara.
• stop - Detiene la vista previa de la cámara.
• capture - Captura una foto con la cámara.
• captureSample - Captura un frame del stream de la vista previa.

Público API

Método	Descripción
start	Inicia el preview de la cámara.
stop	Detiene el preview de la cámara.
capture	Captura una foto con la cámara.
captureSample	Captura un frame del stream de vista previa de la cámara.
getSupportedFlashModes	Obtiene los modos de flash compatibles con la cámara activa.
setAspectRatio	Establece la relación de aspecto de la vista previa.
getAspectRatio	Obtiene la relación de aspecto actual de la vista previa.
setGridMode	Configura el modo de rejilla del overlay de la vista previa.
getGridMode	Obtiene el modo de rejilla actual del overlay de la vista previa.
checkPermissions	Comprueba el estado de los permisos de la cámara (y opcionalmente del micrófono) sin mostrar el diálogo del sistema.
requestPermissions	Solicita permisos de cámara (y micrófono opcional). Si ya se han concedido o denegado, se devuelve el estado actual sin preguntar. Cuando showSettingsAlert si es true y los permisos son denegados, se mostrará una alerta nativa para guiar al usuario a los ajustes de la app.
getHorizontalFov	Obtiene el campo de visión horizontal de la cámara activa. Nota: esto puede ser una estimación en algunos dispositivos.
getSupportedPictureSizes	Obtiene los tamaños de imagen compatibles para todas las cámaras.
setFlashMode	Configura el modo de flash para la cámara activa.
flip	Cambia entre la cámara frontal y la trasera.
setOpacity	Establece la opacidad de la vista previa de la cámara.
stopRecordVideo	Detiene una grabación de video en curso.
startRecordVideo	Inicia la grabación de un video.
isRunning	Comprueba si la vista previa de la cámara está activa.
getAvailableDevices	Gets all available camera devices.
getZoom	Obtiene el estado de zoom actual, incluyendo min/max e información de la lente actual.
getZoomButtonValues	Devuelve los valores de los botones de zoom para cambiar rápido. - iOS/Android: incluye 0.5 si hay ultra gran angular disponible; 1 y 2 si hay gran angular disponible; 3 si hay teleobjetivo disponible - Web: no compatible.
setZoom	Establece el nivel de zoom de la cámara.
getFlashMode	Obtiene el modo de flash actual.
removeAllListeners	Elimina todos los listeners registrados.
setDeviceId	Cambia la cámara activa a la que tiene el deviceId.
getDeviceId	Obtiene el ID del dispositivo de cámara vinculado actualmente. En Android, si una solicitud de lente física recurre a una cámara lógica, devuelve el ID de la cámara lógica vinculada.
getPreviewSize	Obtiene el tamaño y la posición actuales de la vista previa.
setPreviewSize	Sets the preview size and position.
setFocus	Establece el enfoque de la cámara en un punto específico de la vista previa.
addListener	Adds a listener for screen resize events.
addListener	Añade un listener para eventos de cambio de orientación.
deleteFile	Elimina un archivo en la ruta absoluta indicada en el dispositivo. Úsalo para limpiar rápidamente imágenes temporales creadas con storeToFile. En la web no es compatible y lanzará un error.
getSafeAreaInsets	Obtiene los insets del safe area del dispositivo. Devuelve el recorte de la cámara/notch según la orientación y la orientación actual. En portrait: devuelve el inset superior (notch arriba). En landscape: devuelve el inset izquierdo (notch al lateral). Se enfoca específicamente en el área de recorte (notch, punch hole, etc.) de los teléfonos modernos.
getOrientation	Obtiene la orientación actual del dispositivo en un formato multiplataforma.
getExposureModes	Devuelve los modos de exposición compatibles con la cámara activa. Los modos pueden ser: ‘locked’, ‘auto’, ‘continuous’, ‘custom’.
getExposureMode	Devuelve el modo de exposición actual.
setExposureMode	Establece el modo de exposición.
getExposureCompensationRange	Devuelve el rango de compensación de exposición (sesgo EV) compatible.
getExposureCompensation	Devuelve la compensación de exposición actual (sesgo EV).
setExposureCompensation	Establece la compensación de exposición (sesgo EV). El valor se ajustará al rango permitido.
getPluginVersion	Obtén la versión del plugin nativo Capacitor.

Valores de referencia

Usa estos valores de CameraLens.deviceType o LensInfo.deviceType para elegir la lente de la cámara física.

Tipos de dispositivo

Valor	El usuario encontrará
ultraWide	Lente ultra gran angular.
wideAngle	Lente gran angular estándar.
telephoto	Lente teleobjetivo.
trueDepth	Cámara frontal TrueDepth.
dual	Sistema de cámara dual.
dualWide	Sistema de cámara dual gran angular.
triple	Sistema de triple cámara.

Fuente de verdad

Esta referencia se sincroniza desde src/definitions.ts en capacitor-camera-preview.

Continúa con @capgo/camera-preview

Si estás usando @capgo/camera-preview para planificar el comportamiento de los medios nativos y la interfaz, conéctalo con Uso de @capgo/camera-preview para la capacidad nativa al usar @capgo/camera-preview, Uso de @capgo/capacitor-live-activities para la capacidad nativa en Uso de @capgo/capacitor-live-activities, @capgo/capacitor-live-activities para los detalles de implementación en @capgo/capacitor-live-activities, Uso de @capgo/capacitor-video-player para la capacidad nativa en Uso de @capgo/capacitor-video-player, y @capgo/capacitor-video-player para el detalle de implementación en @capgo/capacitor-video-player.