Übersicht
Abschnitt: „Übersicht“@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.
Plattformunterstützung
Abschnitt mit dem Titel „Plattformunterstützung“| Plattform | Notizen |
|---|---|
| iOS | Geräte mit mehreren Linsen, Pinch-Zoom, Barcode-Formate über den nativen Scanner |
| Android | CameraX-Vorschau, konfigurierbare Aufnahmeauflösung |
| Web | Eingeschränkte Unterstützung, siehe Plugin-README für die aktuelle Web-Oberfläche |
Kernfunktionen
Abschnitt mit dem Titel „Kernfunktionen“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.
Öffentliches API
Abschnitt mit dem Titel „Öffentliche API“| Methode | Beschreibung |
|---|---|
start | Startet die Kameravorschau. |
stop | Stoppt die Kameravorschau. |
capture | Nimmt ein Bild mit der Kamera auf. |
captureSample | Erfasst einen einzelnen Frame aus dem Kamera-Preview-Stream. |
getSupportedFlashModes | Ruft die von der aktiven Kamera unterstützten Blitzmodi ab. |
setAspectRatio | Setzt das Seitenverhältnis der Kameravorschau. |
getAspectRatio | Ruft das aktuelle Seitenverhältnis der Kameravorschau ab. |
setGridMode | Legt den Rastermodus der Kamera-Vorschau-Überlagerung fest. |
getGridMode | Ruft den aktuellen Rastermodus des Kameravorschau-Overlays ab. |
checkPermissions | Prüft den aktuellen Berechtigungsstatus für Kamera (und optional Mikrofon), ohne den Systemdialog auszulösen. |
requestPermissions | Fordert 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. |
getHorizontalFov | Ruft den horizontalen Sichtfeldwinkel der aktiven Kamera ab. Hinweis: Bei einigen Geräten kann es sich um einen Schätzwert handeln. |
getSupportedPictureSizes | Gibt die unterstützten Bildgrößen für alle Kameras zurück. |
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 Orientation-Change-Events 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 storeToFile. Im 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’ oder ‘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
Abschnitt mit dem Titel „Referenzwerte“Verwenden Sie diese Werte aus CameraLens.deviceType oder LensInfo.deviceType um die physische Kamerablende auszuwählen.
Gerätetypen
Abschnitt mit dem Titel „Gerätetypen“| Wert | Der Benutzer findet |
|---|---|
ultraWide | Ultra-Weitwinkel-Kamerablende. |
wideAngle | Standard-Weitwinkel-Kamerablende. |
telephoto | Telefoto-Kamerablende. |
trueDepth | TrueDepth-Frontkamera. |
dual | Doppelsystemkamera. |
dualWide | Dual-Weitwinkel-Kamerasystem. |
triple | Triple-Kamerasystem. |
Source of Truth
Abschnitt mit dem Titel „Source of Truth“Diese Referenz wird synchronisiert von src/definitions.ts in einem capacitor-camera-preview.
Weiter geht's mit @capgo/camera-preview
Abschnitt mit dem Titel „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 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.