Guida
Come utilizzare la anteprima della camera in Capacitor
Utilizzando @capgo/camera-preview
L'interfaccia principale per il plugin CameraPreview.
Installa
bun add @capgo/camera-preview
bunx cap sync
bunx cap sync copia il plugin nativo code nei tuoi progetti nativi. Esegui nuovamente dopo ogni aggiornamento del plugin.
Importa
import { CameraPreview } from '@capgo/camera-preview';
API in un colpo d'occhio
| Metodo | Descrizione |
|---|---|
start |
Avvia la preview della fotocamera. |
stop |
Sospendi la preview della fotocamera. |
capture |
Cattura una foto dalla fotocamera. |
captureSample |
Cattura un singolo frame dalla preview della fotocamera. |
startBarcodeScanner |
Avvia lo scanning dei codici a barre nella preview della camera attiva. |
stopBarcodeScanner |
Interrompe lo scanning dei codici a barre mantenendo attiva la preview della fotocamera. |
getSupportedFlashModes |
Ottieni i modi della flash supportati dalla fotocamera attiva. |
setAspectRatio |
Imposta il rapporto di aspetto della preview della fotocamera. |
getAspectRatio |
Ottiene l'attuale rapporto di aspetto della preview della fotocamera. |
setGridMode |
Sets the grid mode of the camera preview overlay. |
getGridMode |
Ottiene il modo della griglia corrente dell'overlay di anteprima della fotocamera. |
checkPermissions |
Controlla lo stato di autorizzazione della camera (e eventualmente del microfono) attuale senza sollecitare il dialogo del sistema. |
requestPermissions |
Richiede le autorizzazioni per la camera (e microfono opzionale). Se le autorizzazioni sono già state concesse o negate, viene restituito lo stato attuale senza sollecitare l'utente. showSettingsAlert Se è vero e sono negate le autorizzazioni, verrà presentato un avviso specifico per piattaforma che guida l'utente verso le impostazioni dell'app. |
getHorizontalFov |
Ottiene l'angolo di campo orizzontale (FoV) per la fotocamera attiva. Nota: Questo può essere un'ipotesi su alcuni dispositivi. |
getSupportedPictureSizes |
Ottiene le dimensioni delle immagini supportate per tutte le fotocamere. |
setFlashMode |
Imposta il modello di flash per la fotocamera attiva. |
flip |
Alternare tra la fotocamera anteriore e posteriore. |
setOpacity |
Imposta la trasparenza della preview della fotocamera. |
stopRecordVideo |
Interrompe una registrazione video in corso. |
startRecordVideo |
Avvia una registrazione video. |
setVideoQuality |
Imposta la qualità della registrazione video per la sessione attiva della camera. |
getVideoQuality |
Ottieni la qualità della registrazione video corrente. |
getSupportedVideoQualities |
Restituisce le qualità video supportate dalla camera attiva. |
setVideoCodec |
Imposta il codec video utilizzato durante la registrazione. |
getVideoCodec |
Ottieni il codec video corrente utilizzato per la registrazione. |
getSupportedVideoCodecs |
Restituisce i codec video supportati dalla camera attiva. |
isVideoStabilizationSupported |
Controlla se la stabilizzazione video è supportata dalla camera attiva. |
getSupportedVideoStabilizationModes |
Restituisce i modi di stabilizzazione video supportati dalla camera attiva. |
getVideoStabilizationMode |
Ottieni il modo di stabilizzazione video corrente. |
setVideoStabilizationMode |
Imposta il modo di stabilizzazione video per la registrazione. Non può essere modificato mentre una registrazione è in corso. Puoi anche passare videoStabilizationMode se startRecordVideo() opzioni. |
isRunning |
Verifica se la preview della fotocamera è attualmente in esecuzione. |
getAvailableDevices |
Ottiene tutti i dispositivi di camera disponibili. |
getZoom |
Ottiene lo stato di ingrandimento attuale, compreso minimo/maximo e informazioni sulla lente attuale. |
getZoomButtonValues |
Restituisce i valori del pulsante di ingrandimento per la selezione rapida. - iOS/Android: include 0,5 se disponibile ultra-largangolare; 1 e 2 se disponibile largo; 3 se disponibile teleobiettivo - Web: non supportato. |
setZoom |
Imposta il livello di zoom della camera. |
getFlashMode |
Ottiene lo stato di illuminazione attuale. |
setDeviceId |
Passa la fotocamera attiva a quella con lo specificato deviceId. |
getDeviceId |
Ottiene l'ID del dispositivo di fotocamera che è attualmente vincolato. Su Android, se una richiesta di lente fisica cade indietro a una logica fotocamera, questo restituisce l'ID della logica fotocamera vincolata. |
getPreviewSize |
Ottiene le dimensioni e la posizione della preview attuale. |
setPreviewSize |
Imposta le dimensioni e la posizione della preview. |
setFocus |
Imposta il focus della fotocamera su un punto specifico nella anteprima. |
deleteFile |
Elimina un file in un percorso assoluto sul dispositivo. Utilizza questo per pulire velocemente le immagini temporanee create con storeToFileNon supportato su web e lancerà un errore. |
getSafeAreaInsets |
Restituisce gli insetti di area sicura per dispositivi. Restituisce l'insetto di orientamento consapevole della notch/camera e l'orientamento corrente. In modalità ritratto: restituisce l'insetto superiore (notch in alto). In modalità orizzontale: restituisce l'insetto sinistro (notch spostata sul lato). Questo si concentra sull'area del taglio (notch, foro, ecc.) che tutti i telefoni moderni hanno. |
getOrientation |
Restituisce l'orientamento corrente del dispositivo in un formato incrociato. |
getExposureModes |
Restituisce i modi di esposizione supportati dalla camera attiva. I modi possono includere: 'bloccato', 'auto', 'continuo', 'personalizzato'. |
getExposureMode |
Restituisce il modo di esposizione corrente. |
setExposureMode |
Imposta il modo di esposizione. |
getExposureCompensationRange |
Restituisce il range dei valori di compensazione dell'esposizione (EV bias). |
getExposureCompensation |
Restituisce la compensazione dell'esposizione corrente (EV bias). |
setExposureCompensation |
Imposta la compensazione dell'esposizione (EV bias). Il valore sarà limitato al range. |
getWhiteBalanceModes |
Restituisce i modi di bilanciamento della temperatura bianca supportati dalla fotocamera attiva. I modi possono includere: 'AUTO', 'LOCK', 'CONTINUO'. CUSTOM non è elencato fino a quando non viene implementata la supporto manuale. |
getWhiteBalanceMode |
Restituisce il modo di bilanciamento bianco corrente. |
setWhiteBalanceMode |
Imposta il modo di bilanciamento bianco. CONTINUOUS mantiene in esecuzione il bilanciamento bianco automatico (raccomandato; evita un cast caldo/giallo), LOCK congela i guadagni correnti, AUTO effettua un'adeguamento unico. CUSTOM è riservato e rifiutato fino a quando non viene implementata la supporto manuale. |
getSupportedVideoFrameRates |
Elencare le velocità di frame del video supportate dalla camera attiva per il formato corrente. I valori supportati dipendono dalla camera selezionata, dalla lente e dalla qualità del video. |
getVideoFrameRate |
Restituisce la velocità di frame del video configurata per la camera attiva. Su Android, la velocità di registrazione effettiva può ancora variare in condizioni di bassa luce o sotto pressione termica. |
setVideoFrameRate |
Imposta la velocità di frame del video target per la sessione della camera attiva. Preferisci passare frameRate a startRecordVideo() quando si avvia una registrazione. Rifiuta i valori non supportati con un chiaro errore. |
Esempi
start()
Inizia la preview della fotocamera.
import { CameraPreview } from '@capgo/camera-preview';
const result = await CameraPreview.start({ parent: 'parent' });
console.log(result);
stop()
Sospendi la preview della fotocamera.
import { CameraPreview } from '@capgo/camera-preview';
await CameraPreview.stop();
capture()
Cattura una foto dalla fotocamera.
import { CameraPreview } from '@capgo/camera-preview';
const result = await CameraPreview.capture({ height: 1920 });
console.log(result);
captureSample()
Cattura un singolo frame dalla corrente preview della fotocamera.
import { CameraPreview } from '@capgo/camera-preview';
const result = await CameraPreview.captureSample({
quality: 85,
mirrorFrontCamera: false,
});
console.log(result);
startBarcodeScanner()
Avvia lo scanning dei codici a barre sulla preview della camera attiva.
import { CameraPreview } from '@capgo/camera-preview';
await CameraPreview.startBarcodeScanner();
stopBarcodeScanner()
Sospendi lo scanning dei codici a barre mentre la preview della fotocamera continua.
import { CameraPreview } from '@capgo/camera-preview';
await CameraPreview.stopBarcodeScanner();
La tabella sopra elenca le 56 metodologie di base. Gli ascoltatori e gli aiuti di versione, e il contratto completo di ogni metodo, sono documentati nel GitHub repository.
Ascolta gli eventi
addListener ritorna un handle. Chiama handle.remove() quando lo schermo viene smontato, o CameraPreview.removeAllListeners() per cancellare tutti gli ascoltatori.
Riferimento completo
Continua da Utilizzo di @capgo/camera-preview
Se stai utilizzando Utilizzo di @capgo/camera-preview per pianificare il comportamento dei media e dell'interfaccia nativi, connettilo con @capgo/camera-preview per i dettagli di implementazione in @capgo/camera-preview Getting Started per i dettagli di implementazione in Getting Started, Usando @capgo/capacitor-live-attività per la capacità nativa in Usando @capgo/capacitor-live-attività, @capgo/capacitor-live-attività per i dettagli di implementazione in @capgo/capacitor-live-attività, e Usando @capgo/capacitor-player-video per la capacità nativa in Usando @capgo/capacitor-player-video.