Anleitung
So verwendest du Camera Preview in Capacitor
Mit @capgo/camera-preview
Die Hauptoberfläche für das CameraPreview-Plugin.
Installieren
bun add @capgo/camera-preview
bunx cap sync
bunx cap sync kopiert die native code des Plugins in Ihre native Projekte. Führen Sie es erneut durch, nachdem Sie das Plugin aktualisiert haben.
Importieren
import { CameraPreview } from '@capgo/camera-preview';
API im Überblick
| Methode | Beschreibung |
|---|---|
start |
Startet die Kamera-Vorschau. |
stop |
Beendet die Kamera-Vorschau. |
capture |
Erstellt ein Bild von der Kamera. |
captureSample |
Fängt ein einzelnes Bild von der Kamera-Vorschau-Stream ein. |
startBarcodeScanner |
Startet die Barcode-Scannung auf der aktiven Kamera-Vorschau. |
stopBarcodeScanner |
Beendet die Barcode-Scannung, während die Kamera-Vorschau weiterläuft. |
getSupportedFlashModes |
Erhält die unterstützten Blitzmodi der aktiven Kamera. |
setAspectRatio |
Setzt den Aspektverhältnis der Kamera-Vorschau. |
getAspectRatio |
Erhält das aktuelle Aspektverhältnis der Kamera-Vorschau. |
setGridMode |
Setzt die Gittermodus des Kameravorschau-Überlays. |
getGridMode |
Erhält den aktuellen Gittermodus der Kamera-Vorschau-Überlagerung. |
checkPermissions |
Überprüft den aktuellen Kamera- (und optional Mikrofon-) Berechtigungsstatus ohne das Systemdialog zu erzwingen. |
requestPermissions |
Anfragen der Kamera- (und optionalen Mikrofon-) Berechtigungen. Wenn Berechtigungen bereits erteilt oder abgelehnt wurden, wird der aktuelle Status ohne Aufforderung zurückgegeben. showSettingsAlert wahr ist und die Berechtigungen abgelehnt wurden, wird eine plattform-spezifische Warnung vorgestellt, die den Benutzer zu den App-Einstellungen leitet. |
getHorizontalFov |
Gibt den horizontalen Blickwinkel (FoV) für die aktive Kamera zurück. Hinweis: Dies kann eine Schätzung auf einigen Geräten sein. |
getSupportedPictureSizes |
Gibt die unterstützten Bildgrößen für alle Kameras zurück. |
setFlashMode |
Setzt den Blitzmodus für die aktive Kamera. |
flip |
Schaltet zwischen der Vorder- und der Rückkamera um. |
setOpacity |
Setzt die Opazität der Kameravorschau. |
stopRecordVideo |
Beendet ein laufendes Videoaufnahmeverfahren. |
startRecordVideo |
Startet eine Videoaufnahme. |
setVideoQuality |
Setzt die Videoaufnahmeeinstellung für die aktive Kamera-Sitzung. |
getVideoQuality |
Gibt die aktuelle Videoaufnahmeeinstellung zurück. |
getSupportedVideoQualities |
Gibt die von der aktiven Kamera unterstützten Videoeinstellungen zurück. |
setVideoCodec |
Stellt den verwendeten Video-Codec für die Aufzeichnung fest. |
getVideoCodec |
Ermittelt die aktuelle Videocodec-Software für die Aufzeichnung. |
getSupportedVideoCodecs |
Gibt die von der aktiven Kamera unterstützten Videocodecs zurück. |
isVideoStabilizationSupported |
Überprüft, ob die aktive Kamera Video-Stabilisierung unterstützt. |
getSupportedVideoStabilizationModes |
Gibt die von der aktiven Kamera unterstützten Video-Stabilisierungsmodi zurück. |
getVideoStabilizationMode |
Gibt den aktuellen Video-Stabilisierungsmodus zurück. |
setVideoStabilizationMode |
Setzt den Video-Stabilisierungsmodus für die Aufzeichnung. Dies kann nicht während einer laufenden Aufzeichnung geändert werden. Sie können auch Optionen übergeben. videoStabilizationMode in startRecordVideo() options. |
isRunning |
Überprüft, ob die Kamera-Vorschau gerade läuft. |
getAvailableDevices |
Alle verfügbaren Kamera-Geräte abrufen. |
getZoom |
Ermittelt den aktuellen Zoomzustand, einschließlich Min/Max und aktuellen Linsendaten. |
getZoomButtonValues |
Gibt Werte für das Zoom-Schaltfeld zurück, um schnell zwischen den Einstellungen zu wechseln. - iOS/Android: enthält 0,5, wenn Ultra-Wide verfügbar ist; 1 und 2, wenn Wide verfügbar ist; 3, wenn Telephoto verfügbar ist - Web: nicht unterstützt. |
setZoom |
Setzt die Zoom-Einstellung der Kamera. |
getFlashMode |
Ermittelt den aktuellen Blitzmodus. |
setDeviceId |
Wechselt die aktive Kamera zur mit der angegebenen deviceId. |
getDeviceId |
Ermittelt die ID des Kamera-Geräts, das derzeit gebunden ist. Bei Android, wenn eine physische-Linse-Anfrage auf eine logische Kamera zurückfällt, gibt dies die gebundene logische Kamera-ID zurück. |
getPreviewSize |
Ermittelt die aktuelle Vorschau-Größe und -Position. |
setPreviewSize |
Setzt die Vorschau-Größe und -Position. |
setFocus |
Setzt die Kamera-Belichtung auf einen bestimmten Punkt in der Vorschau. |
deleteFile |
Löscht eine Datei an der angegebenen absoluten Pfad auf dem Gerät. Verwenden Sie dies, um schnell temporäre Bilder zu löschen, die mit storeToFile. On web, this is not supported and will throw. |
getSafeAreaInsets |
Ermittelt die sicheren Bereich-Einrückungen für Geräte. Gibt die orientierungsbewusste Notch/Kamera-Schnittstelle-Einrückung und die aktuelle Orientierung zurück. In Portrait-Modus: Gibt die obere Einrückung zurück (Notch oben). In Landschaftsmodus: Gibt die linke Einrückung zurück (Notch verschoben auf Seite). Dies zielt speziell auf die Schnittstelle-Bereich (Notch, Loch, usw.) ab, die alle modernen Smartphones haben. |
getOrientation |
Ermittelt die aktuelle Geräteorientierung in einer plattformübergreifenden Format. |
getExposureModes |
Gibt die von der aktiven Kamera unterstützten Belichtungsmodi zurück. Die Modi können beinhalten: 'gesperrt', 'automatisch', 'fortlaufend', 'benutzerdefiniert'. |
getExposureMode |
Gibt den aktuellen Belichtungsmodus zurück. |
setExposureMode |
Setzt den Belichtungsmodus. |
getExposureCompensationRange |
Gibt den Bereich der unterstützten Belichtungsanpassung (EV-Bias) zurück. |
getExposureCompensation |
Gibt den aktuellen Belichtungsanpassung (EV-Bias) zurück. |
setExposureCompensation |
Setzt die Belichtungsanpassung (EV-Bias). Der Wert wird auf den Bereich begrenzt. |
getWhiteBalanceModes |
Gibt die von der aktiven Kamera unterstützten Weißabstimmungsmodi zurück. Die Modi können beinhalten: 'AUTO', 'SPERRUNG', 'FORTLAUFEND'. CUSTOM wird nicht aufgelistet, bis die manuelle Einstellung von Gewinnen implementiert ist. |
getWhiteBalanceMode |
Gibt den aktuellen Weißabstimmungsmodus zurück. |
setWhiteBalanceMode |
Setzt den Weißabstimmungsmodus. CONTINUOUS Bewahrt die automatische Weißabstimmung bei Lauf (empfohlen; vermeidet eine warme/Gelbkante), LOCK friert die aktuellen Gewinne ein, AUTO führt eine einmalige Anpassung durch. CUSTOM ist reserviert und wird abgelehnt, bis manuelle Unterstützung implementiert ist. |
getSupportedVideoFrameRates |
Listet die unterstützten Videobildraten für die aktive Kamera für die aktuelle Formatierung auf. Die unterstützten Werte hängen von der ausgewählten Kamera, dem Objektiv und der Videoqualität ab. |
getVideoFrameRate |
Gibt den konfigurierten Videobildrate für die aktive Kamera zurück. Bei Android kann der tatsächliche Aufnahmebildrate in niedriger Helligkeit oder unter thermischer Belastung noch variieren. |
setVideoFrameRate |
Setzt den Ziel-Videobildrate für die aktive Kamera-Sitzung. Vorziehen Sie die Übermittlung von frameRate zu startRecordVideo() wenn eine Aufzeichnung gestartet wird. Ablehnt nicht unterstützte Werte mit einem klaren Fehler. |
Beispiele
start()
Startet die Kameravorschau.
import { CameraPreview } from '@capgo/camera-preview';
const result = await CameraPreview.start({ parent: 'parent' });
console.log(result);
stop()
Beendet die Kameravorschau.
import { CameraPreview } from '@capgo/camera-preview';
await CameraPreview.stop();
capture()
Erstellt ein Bild von der Kamera.
import { CameraPreview } from '@capgo/camera-preview';
const result = await CameraPreview.capture({ height: 1920 });
console.log(result);
captureSample()
Erstellt ein einzelnes Bild von der Kameravorschau-Stream.
import { CameraPreview } from '@capgo/camera-preview';
const result = await CameraPreview.captureSample({
quality: 85,
mirrorFrontCamera: false,
});
console.log(result);
startBarcodeScanner()
Startet die Barcode-Scannung auf der aktiven Kamera-Vorschau.
import { CameraPreview } from '@capgo/camera-preview';
await CameraPreview.startBarcodeScanner();
stopBarcodeScanner()
Beendet die Barcode-Scannung, während die Kamera-Vorschau weiterläuft.
import { CameraPreview } from '@capgo/camera-preview';
await CameraPreview.stopBarcodeScanner();
Die Tabelle oben listet die 56 Kernmethoden. Helfer für Listener und Versionen sowie die vollständige Vertragsstruktur jeder Methode sind in der GitHub-Repository.
Hören Sie auf Ereignisse
addListener erstellt einen Handle. Rufen Sie handle.remove() an, wenn das Bildschirm unmontiert wird, oder CameraPreview.removeAllListeners() um jeden Listener zu löschen.
Vollständige Referenz
Fortfahren mit @capgo/camera-preview
Wenn Sie @__CAPGO_KEEP_0__/camera-preview verwenden Verwenden Sie @capgo/camera-preview um native Medien und Schnittstellenverhalten zu planen, verbinden Sie es mit @capgo/camera-preview Um die Implementierungsdetails in @capgo/camera-preview zu erhalten Zur Einführung Um die Implementierungsdetails in Zur Einführung zu erhalten Verwenden Sie @capgo/capacitor-live-activities Um die native Fähigkeit in Verwenden Sie @capgo/capacitor-live-activities zu erhalten @capgo/capacitor-live-Aktivitäten Um die Implementierungsdetails in @capgo/capacitor-live-activities zu erhalten Mit @capgo/capacitor-video-player für die native Fähigkeit in Mit @capgo/capacitor-video-player.