@capgo/camera-preview

Panoramica

@capgo/camera-preview renderizza un layer della fotocamera nativa dietro o sopra la tua WebView con anteprima continua, scatto statico, controllo flash, aspect ratio e opzionalmente scansione barcodeCrea scansioni per pagamenti, overlay in stile AR, UX personalizzata per l'otturatore e workflow di visione senza dover reindirizzare gli utenti all'app fotocamera predefinita.

Abbinalo a @capgo/capacitor-uploader per caricare gli scatti da percorsi disco invece di caricare interi buffer in JavaScript.

Supporto piattaforme

Piattaforma	Note
iOS	Dispositivi multi-lente, pinch zoom, formati barcode tramite scanner nativo
Android	Anteprima CameraX, risoluzione di cattura configurabile
Web	Supporto limitato, consulta il README del plugin per la superficie web attuale

Funzionalità principali

• start - Avvia l'anteprima della fotocamera.
• stop - Ferma l'anteprima della fotocamera.
• capture - Scatta una foto con la fotocamera.
• captureSample - Cattura un singolo frame dallo stream dell'anteprima della fotocamera.

Pubblico API

Metodo	Descrizione
start	Avvia la camera preview.
stop	Ferma la camera preview.
capture	Scatta una foto con la fotocamera.
captureSample	Cattura un singolo frame dallo stream della camera preview.
getSupportedFlashModes	Ottiene le modalità flash supportate dalla fotocamera attiva.
setAspectRatio	Imposta l'aspect ratio della camera preview.
getAspectRatio	Ottiene l'aspect ratio attuale della camera preview.
setGridMode	Imposta la modalità griglia dell'overlay della camera preview.
getGridMode	Ottiene la modalità griglia attuale dell'overlay della camera preview.
checkPermissions	Verifica lo stato dei permessi della fotocamera (e opzionalmente del microfono) senza mostrare il dialog di sistema.
requestPermissions	Richiede i permessi per la fotocamera (e il microfono opzionale). Se i permessi sono già stati concessi o negati, viene restituito lo stato attuale senza mostrare prompt. Se showSettingsAlert è true e i permessi sono negati, verrà mostrato un alert specifico della piattaforma per guidare l'utente nelle impostazioni dell'app.
getHorizontalFov	Ottiene il campo visivo (FOV) orizzontale della fotocamera attiva. Nota: su alcuni dispositivi potrebbe trattarsi di una stima.
getSupportedPictureSizes	Ottiene le dimensioni delle immagini supportate per tutte le fotocamere.
setFlashMode	Imposta la modalità del flash per la fotocamera attiva.
flip	Passa dalla fotocamera anteriore a quella posteriore.
setOpacity	Imposta l'opacità della preview della fotocamera.
stopRecordVideo	Interrompe una registrazione video in corso.
startRecordVideo	Avvia la registrazione di un video.
isRunning	Verifica se la preview della fotocamera è attualmente attiva.
getAvailableDevices	Ottiene tutti i dispositivi fotocamera disponibili.
getZoom	Ottiene lo stato dello zoom attuale, inclusi i valori min/max e le info sull'obiettivo.
getZoomButtonValues	Restituisce i valori per i pulsanti dello zoom per un passaggio rapido. - iOS/Android: include 0.5 se l'ultra-wide è disponibile; 1 e 2 se il wide è disponibile; 3 se il telephoto è disponibile - Web: non supportato.
setZoom	Imposta il livello di zoom della fotocamera.
getFlashMode	Ottiene la modalità flash corrente.
removeAllListeners	Rimuove tutti i listener registrati.
setDeviceId	Passa dalla fotocamera attiva a quella con il valore specificato deviceId.
getDeviceId	Ottiene l'ID del dispositivo fotocamera attualmente collegato. Su Android, se una richiesta per una lente fisica passa a una fotocamera logica, restituisce l'ID della fotocamera logica collegata.
getPreviewSize	Ottiene la dimensione e la posizione correnti dell'anteprima.
setPreviewSize	Imposta la dimensione e la posizione dell'anteprima.
setFocus	Imposta il focus della fotocamera su un punto specifico dell'anteprima.
addListener	Adds a listener for screen resize events.
addListener	Aggiunge un listener per gli eventi di cambio orientamento.
deleteFile	Elimina un file al percorso assoluto specificato sul dispositivo. Usalo per pulire rapidamente le immagini temporanee create con storeToFile. Sul web non è supportato e lancerà un errore.
getSafeAreaInsets	Ottiene gli inset della safe area per i dispositivi. Restituisce l'inset della notch/camera cutout in base all'orientamento e l'orientamento attuale. In modalità portrait: restituisce l'inset superiore (notch in alto). In modalità landscape: restituisce l'inset sinistro (notch spostata sul lato). Si concentra specificamente sull'area di cutout (notch, punch hole, ecc.) presente su tutti i telefoni moderni.
getOrientation	Ottiene l'orientamento corrente del dispositivo in un formato cross-platform.
getExposureModes	Restituisce le modalità di esposizione supportate dalla camera attiva. Le modalità possono includere: ‘locked’, ‘auto’, ‘continuous’, ‘custom’.
getExposureMode	Restituisce la modalità di esposizione corrente.
setExposureMode	Imposta la modalità di esposizione.
getExposureCompensationRange	Restituisce l'intervallo supportato per la compensazione dell'esposizione (EV bias).
getExposureCompensation	Restituisce la compensazione dell'esposizione (EV bias) corrente.
setExposureCompensation	Imposta la compensazione dell'esposizione (EV bias). Il valore verrà limitato all'intervallo.
getPluginVersion	Ottieni la versione nativa del plugin Capacitor.

Valori di riferimento

Usa questi valori da CameraLens.deviceType o LensInfo.deviceType per scegliere l'obiettivo fisico della fotocamera.

Tipi di dispositivo

Valore	L'utente troverà
ultraWide	Obiettivo ultra-wide.
wideAngle	Obiettivo grandangolare standard.
telephoto	Obiettivo teleobiettivo della fotocamera.
trueDepth	Fotocamera frontale TrueDepth.
dual	Sistema a doppia fotocamera.
dualWide	Sistema a doppia camera wide.
triple	Sistema a tripla camera.

Fonte di verità

Questo riferimento è sincronizzato da src/definitions.ts nella capacitor-camera-preview.

Continua con @capgo/camera-preview

Se stai usando @capgo/camera-preview per pianificare il comportamento dei media nativi e dell'interfaccia, collegalo a Usare @capgo/camera-preview per la funzionalità nativa in Uso di @capgo/camera-preview, Uso di @capgo/capacitor-live-activities per la funzionalità nativa nella pagina Uso di @capgo/capacitor-live-activities, @capgo/capacitor-live-activities per il dettaglio implementativo in @capgo/capacitor-live-activities, Uso di @capgo/capacitor-video-player per la funzionalità nativa nella pagina Uso di @capgo/capacitor-video-player, e @capgo/capacitor-video-player per il dettaglio implementativo in @capgo/capacitor-video-player.