Zum Inhalt springen

@capgo/camera-preview

Live-Kamera-Vorschau, Aufnahmen, Zoom-Objektive und Barcode-Scanning direkt in deinem WebView.

@capgo/camera-preview rendert ein native Kamera-Ebene hinter oder über deinem WebView mit kontinuierlicher Vorschau, Fotoaufnahme, Blitzsteuerung, Seitenverhältnis und optionaler Barcode-Erkennung. Scan-to-Pay, AR-Overlays, individuelles Shutter-UX und Vision-Workflows – ohne Nutzer in die Standard-Kamera-App zu schicken.

Kombiniere mit @capgo/capacitor-uploader um Aufnahmen von Disk-Pfaden zu uploaden, statt vollständige Puffer in JavaScript zu laden.

PlattformNotizen
iOSGeräte mit mehreren Linsen, Pinch-Zoom, Barcode-Formate über den nativen Scanner
AndroidCameraX-Vorschau, konfigurierbare Aufnahmeauflösung
WebEingeschränkte Unterstützung, siehe Plugin-README für die aktuelle Web-Oberfläche
  • start - Startet die Kamera-Vorschau.
  • stop - Stoppt die Kamera-Vorschau.
  • capture - Macht ein Foto mit der Kamera.
  • captureSample - Fängt einen einzelnen Frame aus dem Kamera-Vorschau-Stream ab.
MethodeBeschreibung
startStartet die Kameravorschau.
stopStoppt die Kameravorschau.
captureNimmt ein Bild mit der Kamera auf.
captureSampleErfasst einen einzelnen Frame aus dem Kamera-Preview-Stream.
getSupportedFlashModesRuft die von der aktiven Kamera unterstützten Blitzmodi ab.
setAspectRatioSetzt das Seitenverhältnis der Kameravorschau.
getAspectRatioRuft das aktuelle Seitenverhältnis der Kameravorschau ab.
setGridModeLegt den Rastermodus der Kamera-Vorschau-Überlagerung fest.
getGridModeRuft den aktuellen Rastermodus des Kameravorschau-Overlays ab.
checkPermissionsPrüft den aktuellen Berechtigungsstatus für Kamera (und optional Mikrofon), ohne den Systemdialog auszulösen.
requestPermissionsFordert Berechtigungen für Kamera (und optional Mikrofon) an. Falls Berechtigungen bereits erteilt oder abgelehnt sind, wird der aktuelle Status ohne Nachfrage zurückgegeben. Wenn showSettingsAlert ist true und die Berechtigungen verweigert, wird eine plattformspezifische Warnung angezeigt, die den Benutzer zu den App-Einstellungen führt.
getHorizontalFovRuft den horizontalen Sichtfeldwinkel der aktiven Kamera ab. Hinweis: Bei einigen Geräten kann es sich um einen Schätzwert handeln.
getSupportedPictureSizesGibt die unterstützten Bildgrößen für alle Kameras zurück.
setFlashModeLegt den Blitzmodus für die aktive Kamera fest.
flipWechselt zwischen der Front- und Rückkamera.
setOpacityLegt die Deckkraft der Kamera-Vorschau fest.
stopRecordVideoStoppt eine laufende Videoaufnahme.
startRecordVideoStartet die Videoaufnahme.
isRunningPrüft, ob die Kamera-Vorschau gerade läuft.
getAvailableDevicesGibt alle verfügbaren Kamera-Geräte zurück.
getZoomRuft den aktuellen Zoom-Status ab, inklusive Min/Max und Infos zur aktuellen Linse.
getZoomButtonValuesGibt 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.
setZoomSetzt die Zoomstufe der Kamera.
getFlashModeRuft den aktuellen Blitzmodus ab.
removeAllListenersEntfernt alle registrierten Listener.
setDeviceIdWechselt die aktive Kamera zur Kamera mit der angegebenen deviceId.
getDeviceIdRuft 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.
getPreviewSizeRuft die aktuelle Vorschaugröße und -position ab.
setPreviewSizeSetzt die Vorschaugröße und -position.
setFocusSetzt den Kamerafokus auf einen bestimmten Punkt in der Vorschau.
addListenerFügt einen Listener für Screen-Resize-Events hinzu.
addListenerFügt einen Listener für Orientation-Change-Events hinzu.
deleteFileLöscht eine Datei unter dem angegebenen absoluten Pfad auf dem Gerät. Nutzen Sie dies zum schnellen Aufräumen temporärer Bilder, die mit storeToFile. Im Web wird dies nicht unterstützt und wirft einen Fehler.
getSafeAreaInsetsRuft 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.
getOrientationGibt die aktuelle Geräteorientierung in einem plattformübergreifenden Format zurück.
getExposureModesGibt die von der aktiven Kamera unterstützten Belichtungsmodi zurück. Die Modi können sein: ‘locked’, ‘auto’, ‘continuous’ oder ‘custom’.
getExposureModeGibt den aktuellen Belichtungsmodus zurück.
setExposureModeLegt den Belichtungsmodus fest.
getExposureCompensationRangeGibt den unterstützten Bereich für die Belichtungskorrektur (EV-Bias) zurück.
getExposureCompensationGibt die aktuelle Belichtungskorrektur (EV-Bias) zurück.
setExposureCompensationLegt die Belichtungskorrektur (EV-Bias) fest. Der Wert wird auf den Bereich begrenzt.
getPluginVersionDie native Capacitor Plugin-Version abrufen.

Verwenden Sie diese Werte aus CameraLens.deviceType oder LensInfo.deviceType um die physische Kamerablende auszuwählen.

WertDer Benutzer findet
ultraWideUltra-Weitwinkel-Kamerablende.
wideAngleStandard-Weitwinkel-Kamerablende.
telephotoTelefoto-Kamerablende.
trueDepthTrueDepth-Frontkamera.
dualDoppelsystemkamera.
dualWideDual-Weitwinkel-Kamerasystem.
tripleTriple-Kamerasystem.

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

Wenn du es nutzt @capgo/camera-preview , um natives Media- und Interface-Verhalten zu planen, verbinde es mit Mit @capgo/camera-preview arbeiten für die native Funktion in Using @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.