Camera
系统相机
支持情况:
类型
ComponentType<CameraProps>
CameraProps
参数 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
mode | keyof Mode | "normal" | 否 | 模式,有效值为normal, scanCode |
resolution | keyof Resolution | "medium" | 否 | 分辨率,不支持动态修改 |
devicePosition | keyof DevicePosition | "back" | 否 | 摄像头朝向 |
flash | keyof Flash | "auto" | 否 | 闪光灯 |
frameSize | keyof FrameSize | "medium" | 否 | 指定期望的相机帧数据尺寸 |
outputDimension | "360P" or "540P" or "720P" or "1080P" or "max" | "720P" | 否 | 相机拍照,录制的分辨率。 |
onStop | CommonEventFunction | 否 | 摄像头在非正常终止时触发, 如退出后台等情况 | |
onError | CommonEventFunction | 否 | 用户不允许使用摄像头时触发 | |
onInitDone | CommonEventFunction<onInitDoneEventDetail> | 否 | 相机初始化完成时触发 | |
onReady | CommonEventFunction<onInitDoneEventDetail> | 否 | 相机初始化成功时触发。 | |
onScanCode | CommonEventFunction<onScanCodeEventDetail> | 否 | 在成功识别到一维码时触发, 仅在 mode="scanCode" 时生效 |
API 支持度
API | 微信小程序 | 百度小程序 | 支付宝小程序 | 抖音小程序 | QQ 小程序 | 京东小程序 | H5 | React Native | Harmony |
---|---|---|---|---|---|---|---|---|---|
CameraProps.mode | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | |||
CameraProps.resolution | ✔️ | ✔️ | |||||||
CameraProps.devicePosition | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ||
CameraProps.flash | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ||
CameraProps.frameSize | ✔️ | ✔️ | ✔️ | ||||||
CameraProps.outputDimension | ✔️ | ||||||||
CameraProps.onStop | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ||
CameraProps.onError | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ||
CameraProps.onInitDone | ✔️ | ✔️ | ✔️ | ||||||
CameraProps.onReady | ✔️ | ||||||||
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 | 最大变焦 |
onScanCodeEventDetail
参数 | 类型 | 说明 |
---|---|---|
charSet | string | 字符集 |
rawData | string | 原始数据 |
type | string | 码类型 |
result | string | 识别结果 |
fullResult | string | 识别结果(完整) |
API 支持度
API | 微信小程序 | 支付宝小程序 | H5 | React Native | Harmony |
---|---|---|---|---|---|
onScanCodeEventDetail.rawData | ✔️ | ||||
onScanCodeEventDetail.fullResult | ✔️ |