@capgo/camera-preview

Übersicht

@capgo/camera-preview rendert ein native Kamera-Ebene hinter oder über deiner WebView mit Continuous Preview, Still-Capture, Blitzsteuerung, Seitenverhältnis und optionalem Barcode-Scanning. Erstelle Scan-to-Pay, AR-Overlays, benutzerdefinierte Shutter-UX und Vision-Workflows, ohne Nutzer zur Standard-Kamera-App zu leiten.

Kombiniere es mit @capgo/capacitor-uploader um Aufnahmen von Disk-Pfaden hochzuladen, statt komplette Buffer in JavaScript zu laden.

Plattformunterstützung

Plattform	Notizen
iOS	Multi-Lens-Geräte, Pinch-to-Zoom und Barcode-Formate via Native Scanner
Android	CameraX Preview, konfigurierbare Auflösung
Web	Eingeschränkter Support, siehe README für Web-Details

Kernfunktionen

• start - Startet die Kamera-Vorschau.
• stop - Stoppt die Kamera-Vorschau.
• capture - Macht ein Foto mit der Kamera.
• captureSample - Erfasst einen einzelnen Frame aus dem Kamera-Stream.

Öffentliches API

Methode	Beschreibung
start	Startet die Kamera-Vorschau.
stop	Stoppt die Kamera-Vorschau.
capture	Macht ein Foto mit der Kamera.
captureSample	Erfasst einen einzelnen Frame aus dem Kamera-Preview-Stream.
getSupportedFlashModes	Ruft die unterstützten Blitzmodi der aktiven Kamera ab.
setAspectRatio	Legt das Seitenverhältnis der Kamera-Vorschau fest.
getAspectRatio	Ruft das aktuelle Seitenverhältnis der Kamera-Vorschau ab.
setGridMode	Legt den Rastermodus des Kamera-Vorschau-Overlays fest.
getGridMode	Ruft den aktuellen Rastermodus des Kamera-Vorschau-Overlays ab.
checkPermissions	Prüft den aktuellen Kamera- (und optional Mikrofon-) Berechtigungsstatus, ohne den Systemdialog anzuzeigen.
requestPermissions	Fordert Kamera- (und optional Mikrofon-) Berechtigungen an. Falls die Berechtigungen bereits erteilt oder abgelehnt wurden, wird der aktuelle Status ohne Prompt zurückgegeben. Wenn showSettingsAlert true ist und die Berechtigungen abgelehnt wurden, erscheint ein plattformspezifischer Alert, der den Nutzer zu den App-Einstellungen leitet.
getHorizontalFov	Ruft das horizontale Sichtfeld der aktiven Kamera ab. Hinweis: Dies kann auf einigen Geräten nur ein Schätzwert sein.
getSupportedPictureSizes	Ruft die unterstützten Bildgrößen für alle Kameras ab.
setFlashMode	Legt den Blitzmodus für die aktive Kamera fest.
flip	Wechselt zwischen der Front- und Rückkamera.
setOpacity	Legt die Deckkraft der Kamera-Vorschau fest.
stopRecordVideo	Stoppt eine laufende Videoaufnahme.
startRecordVideo	Startet die Videoaufnahme.
isRunning	Prüft, ob die Kamera-Vorschau gerade läuft.
getAvailableDevices	Gibt alle verfügbaren Kamera-Geräte zurück.
getZoom	Ruft den aktuellen Zoom-Status ab, inklusive Min/Max und Infos zur aktuellen Linse.
getZoomButtonValues	Gibt Zoom-Button-Werte für schnelles Umschalten zurück. - iOS/Android: 0.5 (falls Ultraweitwinkel vorhanden), 1 und 2 (falls Weitwinkel vorhanden), 3 (falls Teleobjektiv vorhanden) - Web: nicht unterstützt.
setZoom	Setzt die Zoomstufe der Kamera.
getFlashMode	Ruft den aktuellen Blitzmodus ab.
removeAllListeners	Entfernt alle registrierten Listener.
setDeviceId	Wechselt die aktive Kamera zur Kamera mit der angegebenen deviceId.
getDeviceId	Ruft die ID des aktuell gebundenen Kamerageräts ab. Auf Android: Fällt eine Anfrage für eine physische Linse auf eine logische Kamera zurück, wird die ID der gebundenen logischen Kamera zurückgegeben.
getPreviewSize	Ruft die aktuelle Vorschaugröße und -position ab.
setPreviewSize	Setzt die Vorschaugröße und -position.
setFocus	Setzt den Kamerafokus auf einen bestimmten Punkt in der Vorschau.
addListener	Fügt einen Listener für Screen-Resize-Events hinzu.
addListener	Fügt einen Listener für Orientierungsänderungen hinzu.
deleteFile	Löscht eine Datei unter dem angegebenen absoluten Pfad auf dem Gerät. Nutzen Sie dies zum schnellen Aufräumen temporärer Bilder, die mit storeToFileIm Web wird dies nicht unterstützt und wirft einen Fehler.
getSafeAreaInsets	Ruft die Safe Area Insets für Geräte ab. Gibt den orientierungsabhängigen Notch-/Kamera-Cutout-Inset und die aktuelle Ausrichtung zurück. Im Portrait-Modus: oberer Inset (Notch oben). Im Landscape-Modus: linker Inset (Notch an der Seite). Dies zielt speziell auf den Cutout-Bereich (Notch, Punch Hole etc.) ab, den alle modernen Smartphones haben.
getOrientation	Gibt die aktuelle Geräteorientierung in einem plattformübergreifenden Format zurück.
getExposureModes	Gibt die von der aktiven Kamera unterstützten Belichtungsmodi zurück. Die Modi können sein: ‚locked‘, ‚auto‘, ‚continuous‘, ‚custom‘.
getExposureMode	Gibt den aktuellen Belichtungsmodus zurück.
setExposureMode	Legt den Belichtungsmodus fest.
getExposureCompensationRange	Gibt den unterstützten Bereich für die Belichtungskorrektur (EV-Bias) zurück.
getExposureCompensation	Gibt die aktuelle Belichtungskorrektur (EV-Bias) zurück.
setExposureCompensation	Legt die Belichtungskorrektur (EV-Bias) fest. Der Wert wird auf den Bereich begrenzt.
getPluginVersion	Die native Capacitor Plugin-Version abrufen.

Referenzwerte

Verwende diese Werte von CameraLens.deviceType oder LensInfo.deviceType um das physische Kameraobjektiv auszuwählen.

Gerätetypen

Wert	Der Nutzer findet
ultraWide	Ultraweitwinkel-Objektiv.
wideAngle	Standard-Weitwinkelobjektiv.
telephoto	Teleobjektiv-Kameraobjektiv.
trueDepth	TrueDepth-Frontkamera.
dual	Dual-Kamerasystem.
dualWide	Dual-Weitwinkel-Kamerasystem.
triple	Triple-Kamerasystem.

Source of Truth

Diese Referenz wird synchronisiert von src/definitions.ts in capacitor-camera-preview.

Weiter geht's mit @capgo/camera-preview

Wenn du es nutzt @capgo/camera-preview , um natives Media- und Interface-Verhalten zu planen, verbinde es mit Verwendung von @capgo/camera-preview für die native Funktion in der Verwendung von @capgo/camera-preview, @capgo/capacitor-live-activities verwenden für die native Funktion in „@capgo/capacitor-live-activities verwenden“, @capgo/capacitor-live-activities für die Implementierungsdetails in @capgo/capacitor-live-activities, Verwendung von @capgo/capacitor-video-player für die native Funktion in „@capgo/capacitor-video-player verwenden“, und @capgo/capacitor-video-player für das Implementierungsdetail in @capgo/capacitor-video-player.