Version: 3.x
Camera
系统相机
类型#
CameraProps#
| 参数 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| mode | "normal" | "scanCode" | "normal" | 否 | 模式，有效值为normal, scanCode |
| resolution | "low" | "medium" | "high" | "medium" | 否 | 分辨率，不支持动态修改 |
| devicePosition | "front" | "back" | "back" | 否 | 摄像头朝向 |
| flash | "auto" | "on" | "off" | "torch" | "auto" | 否 | 闪光灯 |
| frameSize | "medium" | "small" | "large" | "medium" | 否 | 指定期望的相机帧数据尺寸 |
| scanArea | number[] | 否 | 扫码识别区域，格式为[x, y, w, h]， x,y是相对于camera显示区域的左上角， w,h为区域宽度，单位px，仅在 mode="scanCode" 时生效 | |
| onStop | BaseEventOrigFunction<any> | 否 | 摄像头在非正常终止时触发， 如退出后台等情况 | |
| onError | BaseEventOrigFunction<any> | 否 | 用户不允许使用摄像头时触发 | |
| onInitDone | BaseEventOrigFunction<onInitDoneEventDetail> | 否 | 相机初始化完成时触发 | |
| onScanCode | BaseEventOrigFunction<any> | 否 | 在成功识别到一维码时触发， 仅在 mode="scanCode" 时生效 |
API 支持度#
| API | 微信小程序 | H5 | React Native |
|---|---|---|---|
| CameraProps.mode | ✔️ | ✔️ | |
| CameraProps.resolution | ✔️ | ||
| CameraProps.devicePosition | ✔️ | ✔️ | |
| CameraProps.flash | ✔️ | ✔️ | |
| CameraProps.frameSize | ✔️ | ||
| CameraProps.scanArea | ✔️ | ||
| CameraProps.onStop | ✔️ | ✔️ | |
| CameraProps.onError | ✔️ | ✔️ | |
| CameraProps.onInitDone | ✔️ | ✔️ | |
| CameraProps.onScanCode | ✔️ | ✔️ |
mode#
mode 的合法值
| 参数 | 说明 |
|---|---|
| normal | 相机模式 |
| scanCode | 扫码模式 |
resolution#
resolution 的合法值
| 参数 | 说明 |
|---|---|
| low | 低 |
| medium | 中 |
| high | 高 |
devicePosition#
device-position 的合法值
| 参数 | 说明 |
|---|---|
| front | 前置 |
| back | 后置 |
flash#
flash 的合法值
| 参数 | 说明 |
|---|---|
| auto | 自动 |
| on | 打开 |
| off | 关闭 |
| torch | 常亮 |
frameSize#
frame-size 的合法值
| 参数 | 说明 |
|---|---|
| small | 小尺寸帧数据 |
| medium | 中尺寸帧数据 |
| large | 大尺寸帧数据 |
onInitDoneEventDetail#
| 参数 | 类型 | 说明 |
|---|---|---|
| maxZoom | number | 最大变焦 |
API 支持度#
| API | 微信小程序 | H5 | React Native |
|---|---|---|---|
| Camera | ✔️ | ✔️ |