@capgo/camera-preview

Aperçu

@capgo/camera-preview affiche un couche caméra native derrière ou au-dessus de votre WebView avec aperçu continu, capture d'image, contrôle du flash, ratio d'aspect et option de lecture de codes-barres. Créez des scans pour paiement, des overlays de style RA, une UX d'obturateur personnalisée et des workflows de vision sans rediriger les utilisateurs vers l'application caméra native.

Associez avec @capgo/capacitor-uploader pour envoyer les captures depuis des chemins de disque plutôt que de charger des buffers complets en JavaScript.

Support des plateformes

Plateforme	Notes
iOS	Appareils multi-objectifs, pinch zoom, formats de codes-barres via le scanner natif
Android	Aperçu CameraX, résolution de capture configurable
Le Web	Support limité, voir le README du plugin pour la surface web actuelle

Fonctionnalités clés

• start - Lance l'aperçu de la caméra.
• stop - Arrête l'aperçu de la caméra.
• capture - Capture une photo avec la caméra.
• captureSample - Capture une seule image du flux d'aperçu de la caméra.

API public

Méthode	Description
start	Lance l'aperçu de la caméra.
stop	Arrête l'aperçu de la caméra.
capture	Capture une photo avec la caméra.
captureSample	Capture une seule image du flux de la preview caméra.
getSupportedFlashModes	Récupère les modes de flash supportés par la caméra active.
setAspectRatio	Définit le rapport d'aspect de l'aperçu caméra.
getAspectRatio	Récupère le rapport d'aspect actuel de l'aperçu caméra.
setGridMode	Définit le mode de grille de l'overlay de l'aperçu caméra.
getGridMode	Récupère le mode de grille actuel de l'overlay de l'aperçu caméra.
checkPermissions	Vérifie l'état actuel des permissions de la caméra (et optionnellement du micro) sans afficher la boîte de dialogue système.
requestPermissions	Demande les permissions pour la caméra (et le micro, optionnel). Si les permissions sont déjà accordées ou refusées, le statut actuel est renvoyé sans afficher de prompt. Si showSettingsAlert est à true et que les permissions sont refusées, une alerte spécifique à la plateforme guidera l'utilisateur vers les paramètres de l'appareil.
getHorizontalFov	Récupère le champ de vision horizontal de la caméra active. Note : cela peut être une estimation sur certains appareils.
getSupportedPictureSizes	Récupère les tailles d'image prises en charge pour toutes les caméras.
setFlashMode	Définit le mode flash de la caméra active.
flip	Bascule entre la caméra avant et la caméra arrière.
setOpacity	Définit l'opacité de l'aperçu de la caméra.
stopRecordVideo	Arrête l'enregistrement vidéo en cours.
startRecordVideo	Lance l'enregistrement d'une vidéo.
isRunning	Vérifie si l'aperçu de la caméra est actif.
getAvailableDevices	Récupère tous les appareils photo disponibles.
getZoom	Récupère l'état actuel du zoom, incluant le min/max et les infos sur l'objectif actuel.
getZoomButtonValues	Renvoie les valeurs des boutons de zoom pour un changement rapide. - iOS/Android : inclut 0,5 si l'ultra grand-angle est disponible ; 1 et 2 si le grand-angle est disponible ; 3 si le téléobjectif est disponible - Web : non pris en charge.
setZoom	Définit le niveau de zoom de la caméra.
getFlashMode	Récupère le mode flash actuel.
removeAllListeners	Supprime tous les écouteurs enregistrés.
setDeviceId	Bascule la caméra active vers celle dont l'ID est spécifié deviceId.
getDeviceId	Récupère l'ID de l'appareil photo actuellement lié. Sur Android, si une requête pour un objectif physique bascule sur une caméra logique, cela renvoie l'ID de la caméra logique liée.
getPreviewSize	Récupère la taille et la position actuelles de l'aperçu.
setPreviewSize	Définit la taille et la position de l'aperçu.
setFocus	Définit la mise au point de la caméra sur un point précis de l'aperçu.
addListener	Adds a listener for screen resize events.
addListener	Ajoute un écouteur pour les événements de changement d'orientation.
deleteFile	Supprime un fichier au chemin absolu donné sur l'appareil. Utilisez ceci pour nettoyer rapidement les images temporaires créées avec storeToFile. Sur le web, cela n'est pas supporté et générera une erreur.
getSafeAreaInsets	Récupère les insets de la safe area pour les appareils. Retourne l'inset de l'encoche/découpe caméra selon l'orientation et l'orientation actuelle. En mode portrait : retourne l'inset du haut (encoche en haut). En mode paysage : retourne l'inset de gauche (encoche sur le côté). Cela cible spécifiquement la zone de découpe (encoche, trou, etc.) présente sur tous les téléphones modernes.
getOrientation	Récupère l'orientation actuelle de l'appareil dans un format multiplateforme.
getExposureModes	Retourne les modes d'exposition supportés par la caméra active. Les modes peuvent inclure : ‘locked’, ‘auto’, ‘continuous’, ‘custom’.
getExposureMode	Retourne le mode d'exposition actuel.
setExposureMode	Définit le mode d'exposition.
getExposureCompensationRange	Retourne la plage de compensation d'exposition (biais EV) supportée.
getExposureCompensation	Retourne la compensation d'exposition actuelle (biais EV).
setExposureCompensation	Définit la compensation d'exposition (biais EV). La valeur sera limitée à la plage supportée.
getPluginVersion	Récupère la version du plugin natif Capacitor.

Valeurs de référence

Utilisez ces valeurs de CameraLens.deviceType ou LensInfo.deviceType pour choisir l'objectif de la caméra physique.

Types d'appareils

Valeur	L'utilisateur trouvera
ultraWide	Objectif ultra grand-angle.
wideAngle	Objectif grand-angle standard.
telephoto	Objectif téléobjectif.
trueDepth	Caméra frontale TrueDepth.
dual	Système de double caméra.
dualWide	Système de double caméra grand-angle.
triple	Système de triple caméra.

Source de vérité

Cette référence est synchronisée depuis src/definitions.ts dans capacitor-camera-preview.

Continuer avec @capgo/camera-preview

Si vous utilisez @capgo/camera-preview pour planifier le comportement des médias et de l'interface natifs, connectez-l’à Utiliser @capgo/camera-preview pour la capacité native dans l'utilisation de @capgo/camera-preview, Utiliser @capgo/capacitor-live-activities pour la capacité native dans Utiliser @capgo/capacitor-live-activities @capgo/capacitor-live-activities pour le détail d'implémentation dans @capgo/capacitor-live-activities Utiliser @capgo/capacitor-video-player pour la capacité native dans Utiliser @capgo/capacitor-video-player, et @capgo/capacitor-video-player pour le détail d'implémentation dans @capgo/capacitor-video-player.