Vai al contenuto

@capgo/camera-preview

Anteprima live della fotocamera, scatto, lenti zoom e scansione barcode nella tua WebView.

@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.

PiattaformaNote
iOSDispositivi multi-lente, pinch zoom, formati barcode tramite scanner nativo
AndroidAnteprima CameraX, risoluzione di acquisizione configurabile
WebSupporto limitato, consulta il README del plugin per la superficie web attuale
  • start - Avvia l'anteprima della fotocamera.
  • stop - Arresta l'anteprima della fotocamera.
  • capture - Scatta una foto con la fotocamera.
  • captureSample - Cattura un singolo frame dallo stream dell'anteprima della fotocamera.
MetodoDescrizione
startAvvia la camera preview.
stopFerma la camera preview.
captureScatta una foto con la fotocamera.
captureSampleCattura un singolo frame dallo stream della camera preview.
getSupportedFlashModesOttiene le modalità flash supportate dalla fotocamera attiva.
setAspectRatioImposta l'aspect ratio della camera preview.
getAspectRatioOttiene l'aspect ratio attuale della camera preview.
setGridModeImposta la modalità griglia dell'overlay della camera preview.
getGridModeOttiene la modalità griglia attuale dell'overlay della camera preview.
checkPermissionsVerifica lo stato dei permessi della fotocamera (e opzionalmente del microfono) senza mostrare il prompt di sistema.
requestPermissionsRichiede i permessi per la fotocamera (e il microfono opzionale). Se i permessi sono già concessi o negati, viene restituito lo stato attuale senza mostrare prompt. Quando showSettingsAlert è true e i permessi sono negati, verrà mostrato un alert specifico della piattaforma per guidare l'utente alle impostazioni dell'app.
getHorizontalFovOttiene il campo visivo orizzontale (FOV) della fotocamera attiva. Nota: su alcuni dispositivi può essere una stima.
getSupportedPictureSizesOttiene le dimensioni delle immagini supportate da tutte le fotocamere.
setFlashModeImposta la modalità flash per la fotocamera attiva.
flipPassa dalla fotocamera anteriore a quella posteriore.
setOpacityImposta l'opacità dell'anteprima della fotocamera.
stopRecordVideoInterrompe una registrazione video in corso.
startRecordVideoAvvia la registrazione video.
isRunningVerifica se la camera preview è attualmente attiva.
getAvailableDevicesOttiene tutti i dispositivi fotocamera disponibili.
getZoomOttiene lo stato attuale dello zoom, inclusi min/max e le info sull'obiettivo corrente.
getZoomButtonValuesRestituisce i valori dei pulsanti di zoom per il cambio 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.
setZoomImposta il livello di zoom della fotocamera.
getFlashModeOttiene la modalità flash attuale.
removeAllListenersRimuove tutti i listener registrati.
setDeviceIdPassa la camera attiva a quella con l'ID specificato. deviceId.
getDeviceIdOttiene l'ID del dispositivo fotocamera attualmente associato. Su Android, se una richiesta per una lente fisica ricade su una fotocamera logica, restituisce l'ID della fotocamera logica associata.
getPreviewSizeRestituisce la dimensione e la posizione attuali dell'anteprima.
setPreviewSizeImposta la dimensione e la posizione dell'anteprima.
setFocusImposta il focus della fotocamera su un punto specifico dell'anteprima.
addListenerAdds a listener for screen resize events.
addListenerAggiunge un listener per gli eventi di cambio orientamento.
deleteFileElimina 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.
getSafeAreaInsetsOttiene 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.
getOrientationOttiene l'orientamento corrente del dispositivo in un formato cross-platform.
getExposureModesRestituisce le modalità di esposizione supportate dalla camera attiva. Le modalità possono includere: ‘locked’, ‘auto’, ‘continuous’, ‘custom’.
getExposureModeRestituisce la modalità di esposizione corrente.
setExposureModeImposta la modalità di esposizione.
getExposureCompensationRangeRestituisce l'intervallo supportato per la compensazione dell'esposizione (EV bias).
getExposureCompensationRestituisce la compensazione dell'esposizione (EV bias) corrente.
setExposureCompensationImposta la compensazione dell'esposizione (EV bias). Il valore verrà limitato all'intervallo.
getPluginVersionOttieni la versione nativa del plugin Capacitor.

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

ValoreL'utente troverà
ultraWideObiettivo ultra-wide.
wideAngleObiettivo grandangolare standard.
telephotoObiettivo teleobiettivo della fotocamera.
trueDepthFotocamera frontale TrueDepth.
dualSistema a doppia fotocamera.
dualWideSistema a doppia fotocamera wide.
tripleSistema a tripla fotocamera.

Questo riferimento è sincronizzato da src/definitions.ts nella capacitor-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.