概述
概述相机预览插件的主要界面。
核心功能
概述start- 启动相机预览。stop- 停止相机预览。capture- 从相机捕获照片。captureSample- 从相机预览流中捕获单个帧。
公共 API
公共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 | 删除设备上的给定绝对路径上的文件。 使用此方法快速清除使用 createObjectURL() 创建的临时图像 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-camera-preview.
从@capgo/camera-preview继续
名为“从@capgo/camera-preview继续”的部分如果您正在使用 @capgo/摄像头预览 来规划原生媒体和界面行为，连接它 使用@capgo/camera-preview 为native能力在使用@capgo/camera-preview 使用@capgo/capacitor-live-activities 为native能力在使用@capgo/capacitor-live-activities @capgo/capacitor-live-activities 为@capgo/capacitor-live-activities实现细节 使用@capgo/capacitor-video-player 为native能力在使用@capgo/capacitor-video-player, 和 @capgo/capacitor-视频播放器 为@capgo/capacitor-video-player实现细节
