@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	切换到具有指定 ID 的摄像头。 deviceId.
getDeviceId	获取当前绑定的摄像头设备 ID。 在 Android 上，如果物理镜头请求 fallback 到逻辑摄像头，这将返回绑定的逻辑摄像头 ID。
getPreviewSize	获取当前预览大小和位置。
setPreviewSize	设置预览大小和位置。
setFocus	设置预览中的特定点为相机焦点。
addListener	添加屏幕重绘事件的监听器。
addListener	添加屏幕旋转事件的监听器。
deleteFile	删除设备上的绝对路径下的文件。使用此方法快速清理使用 storeToFile创建的临时图像。 在 web 上，这个方法不受支持并且会抛出异常。
getSafeAreaInsets	获取设备的安全区域边距。返回方向感知的凹槽/摄像头切口边距和当前方向。 在竖屏模式下：返回顶部边距（凹槽位于顶部）。 在横屏模式下：返回左边距（凹槽移动到侧面）。 这个方法特别针对现代手机上的切口区域（凹槽，孔洞等）。
getOrientation	获取当前设备方向的跨平台格式。
getExposureModes	返回当前激活相机支持的曝光模式。 模式可以包括：‘锁定’，‘自动’，‘连续’，‘自定义’。
getExposureMode	返回当前曝光模式。
setExposureMode	设置曝光模式。
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/相机预览 用于原生能力在使用 @capgo/相机预览 使用 @capgo/capacitor-直播活动 用于原生能力在使用 @capgo/capacitor-直播活动 @capgo/capacitor-直播活动 用于在 @capgo/capacitor-直播活动 中的实现细节 使用@capgo/capacitor-视频播放器 用于@capgo/capacitor-视频播放器的本地能力，以及 @capgo/capacitor-视频播放器 用于@capgo/capacitor-视频播放器的实现细节。