Anleitung
Verwendung der Kamera-Vorschau in Capacitor
Verwenden Sie @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 jede Plugin-Upgrade durchgeführt wurde.
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 |
Erstellt ein einzelnes Bild von der Kamera-Vorschau-Strömung. |
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-Einstellung für die Kameravorschau-Überlagerung. |
getGridMode |
Erhält den aktuellen Gittermodus der Kamera-Vorschau-Überlagerung. |
checkPermissions |
Überprüft den aktuellen Kamerazugriff (und optional den Mikrofonzugriff) ohne das Systemdialog zu öffnen. |
requestPermissions |
Bittet um Kamerazugriff (und optional Mikrofonzugriff). Wenn die Berechtigungen bereits erteilt oder abgelehnt wurden, wird der aktuelle Status ohne Aufforderung zurückgegeben. showSettingsAlert Wenn wahr und die Berechtigungen abgelehnt wurden, wird eine plattform-spezifische Warnung vorgestellt, die den Benutzer zu den App-Einstellungen leitet. |
getHorizontalFov |
Ermittelt den horizontalen Sichtbereich (FoV) für die aktive Kamera. Hinweis: Dies kann eine Schätzung auf einigen Geräten sein. |
getSupportedPictureSizes |
Ermittelt die unterstützten Bildgrößen für alle Kameras. |
setFlashMode |
Setzt den Blitzmodus für die aktive Kamera. |
flip |
Schaltet zwischen der Vorder- und 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 |
Ermittelt die aktuelle Videoaufnahmeeinstellung. |
getSupportedVideoQualities |
Gibt die unterstützten Videokalitäten der aktiven Kamera zurück. |
setVideoCodec |
Setzt das verwendete Video-Codec für die Aufzeichnung. |
getVideoCodec |
Gibt den aktuellen Video-Codec für die Aufzeichnung zurück. |
getSupportedVideoCodecs |
Gibt die von der aktiven Kamera unterstützten Video-Codec 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 |
Gibt alle verfügbaren Kamera-Geräte zurück. |
getAvailableDevices |
Alle verfügbaren Kamera-Geräte abrufen. |
getZoom |
Ermittelt den aktuellen Zoomzustand, einschließlich Min/Max und aktuellen Linseninformationen. |
getZoomButtonValues |
Gibt die Zoomschaltwerte zurück, um schnell umzuschalten. - 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 den Zoom-Level der Kamera. |
getFlashMode |
Ermittelt den aktuellen Blitzmodus. |
setDeviceId |
Schaltet die aktive Kamera auf die mit der angegebenen ID. deviceId. |
getDeviceId |
Ermittelt die ID der Kamera, die derzeit gebunden ist. Bei Android, wenn eine physische-Linsen-Anfrage auf eine logische Kamera zurückfällt, gibt diese 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 ein Datei am 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 |
Gibt die aktuelle Geräteorientierung in einer plattformübergreifenden Format zurück. |
getExposureModes |
Rückgabemöglichkeiten der von der aktiven Kamera unterstützten Belichtungsmodi. Mögliche Modi umfassen: 'eingefroren', 'automatisch', 'kontinuierlich', '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 Belichtungsanpassungswert (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ßabgleichmodi zurück. Modi können beinhalten: 'AUTO', 'LOCK', 'CONTINUOUS'. CUSTOM wird nicht gelistet, bis die Unterstützung für manuelle Gewinne 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 einen warmen/Gelbton). LOCK erstellt die aktuellen Gewinne, AUTO führt eine einmalige Anpassung durch. CUSTOM ist reserviert und wird abgelehnt, bis die manuelle Gewinnsupport-Implementierung umgesetzt ist. |
getSupportedVideoFrameRates |
Listet die von der aktiven Kamera für die aktuelle Format unterstützten Videobildraten auf. Unterstützte Werte hängen von der ausgewählten Kamera, dem Objektiv und der Videoqualität ab. |
getVideoFrameRate |
Gibt die konfigurierte Videobildrate für die aktive Kamera zurück. Bei Android kann der tatsächliche Aufnahmebildrate in niedrigen Lichtverhältnissen oder unter thermischer Belastung noch variieren. |
setVideoFrameRate |
Setzt das Zielbildrate für die aktive Kamera-Sitzung fest. Vorziehen Sie die Übermittlung frameRate zu startRecordVideo() während der Aufzeichnung. Ablehnt un unterstützte Werte mit einer klaren Fehlermeldung. |
Examples
start()
Startet die Kamera-Vorschau.
import { CameraPreview } from '@capgo/camera-preview';
const result = await CameraPreview.start({ parent: 'parent' });
console.log(result);
stop()
Beendet die Kamera-Vorschau.
import { CameraPreview } from '@capgo/camera-preview';
await CameraPreview.stop();
capture()
Startet die Kameravorschau.
import { CameraPreview } from '@capgo/camera-preview';
const result = await CameraPreview.capture({ height: 1920 });
console.log(result);
captureSample()
Fängt ein einzelnes Bild aus dem Kameravorschau-Stream ein.
import { CameraPreview } from '@capgo/camera-preview';
const result = await CameraPreview.captureSample({
quality: 85,
mirrorFrontCamera: false,
});
console.log(result);
startBarcodeScanner()
Startet das Barcode-Scannen auf der aktiven Kameravorschau.
import { CameraPreview } from '@capgo/camera-preview';
await CameraPreview.startBarcodeScanner();
stopBarcodeScanner()
Beendet das Barcode-Scannen, während die Kameravorschau weiterläuft.
import { CameraPreview } from '@capgo/camera-preview';
await CameraPreview.stopBarcodeScanner();
Die Tabelle oben listet die 56 Kernmethoden auf. Helfer für Listener und Versionen sowie die vollständige Vertragsvereinbarung jeder Methode sind im GitHub Repository.
Höre auf Ereignisse
addListener gibt einen Handle zurück. Ruf handle.remove() auf, wenn die Bildschirmabmeldung aufgehoben wird, oder CameraPreview.removeAllListeners() um jeden Listener zu löschen.
Vollständige Referenz
Weitermachen von Using @capgo/camera-preview
Wenn Sie Using @__CAPGO_KEEP_0__/camera-preview verwenden Verwenden von Using @capgo/camera-preview um native Medien- und Schnittstellenverhalten zu planen, verbinden Sie es mit @capgo/camera-preview für die Implementierungsdetails in @capgo/camera-preview, Um die Implementierungsdetails in Getting Started zu verstehen, besuchen Sie Getting Started Verwenden von Using @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-live-activities Verwendung von @capgo/capacitor-Live-Activities für die native Fähigkeit in Verwendung von @capgo/capacitor-live-Aktivitäten, @capgo/capacitor-live-Aktivitäten für die Implementierungsdetails in @capgo/capacitor-live-aktivitäten und Mit @capgo/capacitor-video-player für die native Fähigkeit in Mit @capgo/capacitor-video-player.