Skip to main content
Version: 3.x

Camera

系统相机

支持情况:

参考文档

类型

ComponentType<CameraProps>

CameraProps

参数类型默认值必填说明
modekeyof Mode"normal"模式,有效值为normal, scanCode
resolutionkeyof Resolution"medium"分辨率,不支持动态修改
devicePositionkeyof DevicePosition"back"摄像头朝向
flashkeyof Flash"auto"闪光灯
frameSizekeyof FrameSize"medium"指定期望的相机帧数据尺寸
scanAreanumber[]扫码识别区域,格式为[x, y, w, h]
x,y是相对于camera显示区域的左上角,
w,h为区域宽度,单位px,仅在 mode="scanCode" 时生效
onStopCommonEventFunction摄像头在非正常终止时触发,
如退出后台等情况
onErrorCommonEventFunction用户不允许使用摄像头时触发
onInitDoneCommonEventFunction<onInitDoneEventDetail>相机初始化完成时触发
onScanCodeCommonEventFunction在成功识别到一维码时触发,
仅在 mode="scanCode" 时生效

API 支持度

API微信小程序H5React 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

参数类型说明
maxZoomnumber最大变焦