@capgo/camera-preview

概述

相机预览插件的主要界面。

核心功能

• start - 开始摄像头预览。
• stop - 停止摄像头预览。
• capture - 从摄像头捕获一张照片。
• captureSample - 从摄像头预览流中捕获一张单帧。

公开 API

方法	描述
start	开始摄像头预览。
stop	停止摄像头预览。
capture	从摄像头捕获一张照片。
captureSample	从摄像头预览流中捕获一张单帧。
getSupportedFlashModes	获取当前激活相机支持的闪光模式。
setAspectRatio	设置相机预览的比例。
getAspectRatio	获取当前相机预览的比例。
setGridMode	设置相机预览覆盖层的网格模式。
getGridMode	获取当前相机预览覆盖层的网格模式。
checkPermissions	检查当前相机（可选微型摄像头）权限状态，无提示系统对话。
requestPermissions	请求相机（可选微型摄像头）权限。如果权限已经授予或拒绝，则返回当前状态，无提示。 showSettingsAlert 当为真时，如果权限被拒绝，则会在用户设置中显示平台特定的提示。
getHorizontalFov	获取当前激活相机的水平视野。注意：在某些设备上，这可能是一个估计值。
getSupportedPictureSizes	获取所有相机支持的图片尺寸。
setFlashMode	设置当前激活相机的闪光模式。
flip	切换前置和后置摄像头。
setOpacity	设置摄像头预览的透明度。
stopRecordVideo	停止正在进行的视频录制。
startRecordVideo	开始录制视频。
isRunning	检查摄像头预览是否正在运行。
getAvailableDevices	获取所有可用的摄像头设备。
getZoom	获取当前的缩放状态，包括最小值/最大值和当前镜头信息。
getZoomButtonValues	返回缩放按钮值，用于快速切换。- iOS/Android：包括 0.5 如果超宽可用；1 和 2 如果宽可用；3 如果长焦可用 - Web：不支持。
setZoom	设置摄像头的缩放级别。
getFlashMode	获取当前的闪光模式。
removeAllListeners	移除所有注册的监听器。
setDeviceId	切换到指定的摄像头。 deviceId.
getDeviceId	获取当前绑定的摄像头设备的 ID。 在 Android 上，如果物理镜头请求 fallback 到逻辑摄像头，这将返回绑定的逻辑摄像头 ID。
getPreviewSize	获取当前预览大小和位置。
setPreviewSize	设置预览大小和位置。
setFocus	设置预览中的特定点为相机焦点。
addListener	添加屏幕重绘事件的监听器。
addListener	添加屏幕旋转事件的监听器。
deleteFile	删除设备上的绝对路径给定的文件。使用此方法快速清理使用创建的临时图像。 storeToFile获取安全区域的边距。返回方向感知的凹槽/摄像头切口边距和当前方向。在竖屏模式下：返回顶部边距（凹槽位于顶部）。在横屏模式下：返回左边边距（凹槽移动到侧面）。此方法专门针对现代手机的切口区域（凹槽，孔洞等）。
getSafeAreaInsets	获取当前设备的方向。
getOrientation	返回支持的活跃相机的曝光模式。模式可以包括：‘锁定’，‘自动’，‘连续’，‘自定义’。
getExposureModes	返回当前的曝光模式。
getExposureMode	设置曝光模式。
setExposureMode	__CAPGO_KEEP_0__
getExposureCompensationRange	返回曝光补偿（EV偏差）的支持范围。
getExposureCompensation	返回当前的曝光补偿（EV偏差）。
setExposureCompensation	设置曝光补偿（EV偏差）。值将被限制在范围内。
getPluginVersion	获取本地Capacitor插件版本。

参考值

使用这些值从 CameraLens.deviceType 或 LensInfo.deviceType 选择物理相机镜头。

设备类型

值	用户将发现
ultraWide	超广角摄像头镜头。
wideAngle	标准广角摄像头镜头。
telephoto	远摄摄像头镜头。
trueDepth	真深度前置摄像头。
dual	双摄像头系统。
dualWide	双宽摄像头系统。
triple	三摄像头系统。

真相来源

此参考资料是同步自 src/definitions.ts 在 capacitor-相机预览.

从 @capgo/相机预览 中继续

如果您正在使用 @capgo/相机预览 来规划原生媒体和界面行为，连接它与 使用 @capgo/相机预览 for the native capability in Using @capgo/camera-preview, Using @capgo/capacitor-live-activities for the native capability in Using @capgo/capacitor-live-activities, 使用 @capgo/capacitor-直播活动 用于原生能力的使用 @capgo/capacitor-直播活动， 使用@capgo/capacitor-视频播放器 用于本地能力的@capgo/capacitor-视频播放器， @capgo/capacitor-视频播放器 用于@capgo/capacitor-视频播放器的实现细节。