uni.createCameraContext()

创建 camera 上下文 CameraContext 对象。

createCameraContext 兼容性

Web	微信小程序	Android	iOS	HarmonyOS
-	4.41	4.57	4.57	-

返回值

类型	必备
CameraContext	否

CameraContext 的方法

onCameraFrame(callback : (frame : CameraContextOnCameraFrame) => void) : CameraContextCameraFrameListener | null;

获取 Camera 实时帧数据

onCameraFrame 兼容性

Web	微信小程序	Android	iOS	HarmonyOS
-	-	4.57	4.57	-

参数

名称	类型	必填	默认值	兼容性	描述
callback	(frame: CameraContextOnCameraFrame) => void	是	-	-	-

CameraContextOnCameraFrame 的属性值

名称	类型	必备	默认值	兼容性	描述
width	number	否	-	Web 微信小程序 Android iOS HarmonyOS - - 4.57 4.57 -	图像数据矩形的宽度
height	number	否	-	Web 微信小程序 Android iOS HarmonyOS - - 4.57 4.57 -	图像数据矩形的高度
data	ArrayBuffer	否	-	Web 微信小程序 Android iOS HarmonyOS - - 4.57 4.57 -	图像像素点数据，一维数组，每四项表示一个像素点的 rgba

返回值

类型	必备
CameraContextCameraFrameListener	否

CameraContextCameraFrameListener 的方法

start(options : CameraContextCameraFrameListenerStartOptions) : void;

开始监听帧数据

start 兼容性

Web	微信小程序	Android	iOS	HarmonyOS
-	-	4.57	4.57	-

参数

名称	类型	必填	默认值	兼容性	描述
options	CameraContextCameraFrameListenerStartOptions	是	-	-	-
名称 类型 必备 默认值 兼容性 描述 success (result: any) => void 否 null Web 微信小程序 Android iOS HarmonyOS - - 4.57 4.57 - 接口调用成功的回调函数 fail (result: any) => void 否 null Web 微信小程序 Android iOS HarmonyOS - - 4.57 4.57 - 接口调用失败的回调函数 complete (result: any) => void 否 null Web 微信小程序 Android iOS HarmonyOS - - 4.57 4.57 - 接口调用结束的回调函数（调用成功、失败都会执行）

stop(options : CameraContextCameraFrameListenerStopOptions) : void;

停止监听帧数据

stop 兼容性

Web	微信小程序	Android	iOS	HarmonyOS
-	-	4.57	4.57	-

参数

名称	类型	必填	默认值	兼容性	描述
options	CameraContextCameraFrameListenerStopOptions	是	-	-	-
名称 类型 必备 默认值 兼容性 描述 success (result: any) => void 否 null Web 微信小程序 Android iOS HarmonyOS - - 4.57 4.57 - 接口调用成功的回调函数 fail (result: any) => void 否 null Web 微信小程序 Android iOS HarmonyOS - - 4.57 4.57 - 接口调用失败的回调函数 complete (result: any) => void 否 null Web 微信小程序 Android iOS HarmonyOS - - 4.57 4.57 - 接口调用结束的回调函数（调用成功、失败都会执行）

setZoom(options : CameraContextSetZoomOptions) : void;

设置缩放级别

setZoom 兼容性

Web	微信小程序	Android	iOS	HarmonyOS
-	-	4.57	4.57	-

参数

名称	类型	必填	默认值	兼容性	描述
options	CameraContextSetZoomOptions	是	-	-	-
名称 类型 必备 默认值 兼容性 描述 zoom number 是 - Web 微信小程序 Android iOS HarmonyOS - - 4.57 4.57 - 缩放级别，范围[1, maxZoom]zoom 可取小数，精确到小数后一位。maxZoom 可在 initdone 返回值中获取。 success (result: any) => void 否 null Web 微信小程序 Android iOS HarmonyOS - - 4.57 4.57 - 接口调用成功的回调函数 fail (result: any) => void 否 null Web 微信小程序 Android iOS HarmonyOS - - 4.57 4.57 - 接口调用失败的回调函数 complete (result: any) => void 否 null Web 微信小程序 Android iOS HarmonyOS - - 4.57 4.57 - 接口调用结束的回调函数（调用成功、失败都会执行）

takePhoto(options : CameraContextTakePhotoOptions) : void;

拍摄照片

takePhoto 兼容性

Web	微信小程序	Android	iOS	HarmonyOS
-	-	4.57	4.57	-

参数

名称	类型	必填	默认值	兼容性	描述
options	CameraContextTakePhotoOptions	是	-	-	-
名称 类型 必备 默认值 兼容性 描述 quality string 否 'normal' Web 微信小程序 Android iOS HarmonyOS - - 4.57 4.57 - 成像质量 合法值 兼容性 描述 high - - normal - - low - - original - - selfieMirror boolean 否 true Web 微信小程序 Android iOS HarmonyOS - - 4.57 4.57 - 是否开启镜像 success (result: CameraContextTakePhotoResult) => void 否 null Web 微信小程序 Android iOS HarmonyOS - - 4.57 4.57 - 接口调用成功的回调函数 fail (result: any) => void 否 null Web 微信小程序 Android iOS HarmonyOS - - 4.57 4.57 - 接口调用失败的回调函数 complete (result: any) => void 否 null Web 微信小程序 Android iOS HarmonyOS - - 4.57 4.57 - 接口调用结束的回调函数（调用成功、失败都会执行）

CameraContextTakePhotoResult 的属性值

名称	类型	必备	默认值	兼容性	描述
tempImagePath	string	否	-	Web 微信小程序 Android iOS HarmonyOS - - 4.57 4.57 -	照片文件的临时路径 (本地路径)，安卓是jpg图片格式，ios是png

startRecord(options: CameraContextStartRecordOptions): void;

开始录像

startRecord 兼容性

Web	微信小程序	Android	iOS	HarmonyOS
-	-	4.57	4.57	-

参数

名称	类型	必填	默认值	兼容性	描述
options	CameraContextStartRecordOptions	是	-	-	-
名称 类型 必备 默认值 兼容性 描述 timeout number 否 30 Web 微信小程序 Android iOS HarmonyOS - - 4.57 4.57 - 录制时长上限，单位为秒，最长不能超过 5 分钟 selfieMirror boolean 否 true Web 微信小程序 Android iOS HarmonyOS - - 4.57 4.57 - 是否开启镜像 success (result: any) => void 否 null Web 微信小程序 Android iOS HarmonyOS - - 4.57 4.57 - 接口调用成功的回调函数 fail (result: any) => void 否 null Web 微信小程序 Android iOS HarmonyOS - - 4.57 4.57 - 接口调用失败的回调函数 complete (result: any) => void 否 null Web 微信小程序 Android iOS HarmonyOS - - 4.57 4.57 - 接口调用结束的回调函数（调用成功、失败都会执行）

CameraContextStartRecordOptions 的方法

timeoutCallback: (result: any) => void

超过录制时长上限时会结束录像并触发此回调，录像异常退出时也会触发此回调

timeoutCallback 兼容性

Web	微信小程序	Android	iOS	HarmonyOS
-	-	4.57	4.57	-

参数

名称	类型	必填	默认值	兼容性	描述
result	any	是	-	-	-

stopRecord(options: CameraContextStopRecordOptions) : void;

结束录像

stopRecord 兼容性

Web	微信小程序	Android	iOS	HarmonyOS
-	-	4.57	4.57	-

参数

名称	类型	必填	默认值	兼容性	描述
options	CameraContextStopRecordOptions	是	-	-	-
名称 类型 必备 默认值 兼容性 描述 compressed boolean 否 false Web 微信小程序 Android iOS HarmonyOS - - 4.57 4.57 - 启动视频压缩，压缩效果同chooseVideo success (result: CameraContextStopRecordResult) => void 否 null Web 微信小程序 Android iOS HarmonyOS - - 4.57 4.57 - 接口调用成功的回调函数 fail (result: any) => void 否 null Web 微信小程序 Android iOS HarmonyOS - - 4.57 4.57 - 接口调用失败的回调函数 complete (result: any) => void 否 null Web 微信小程序 Android iOS HarmonyOS - - 4.57 4.57 - 接口调用结束的回调函数（调用成功、失败都会执行）

CameraContextStopRecordResult 的属性值

名称	类型	必备	默认值	兼容性	描述
tempThumbPath	string	否	-	Web 微信小程序 Android iOS HarmonyOS - - 4.57 4.57 -	封面图片文件的临时路径 (本地路径)
tempVideoPath	string	否	-	Web 微信小程序 Android iOS HarmonyOS - - 4.57 4.57 -	视频的文件的临时路径 (本地路径)

参见

• 相关 Bug
• 微信小程序文档
• 支付宝小程序文档
• 百度小程序文档
• 抖音小程序文档
• 飞书小程序文档
• 钉钉小程序文档
• QQ小程序文档
• 快手小程序文档
• 京东小程序文档
• 华为快应用文档
• 360小程序文档

通用类型

GeneralCallbackResult

名称	类型	必备	默认值	兼容性	描述
errMsg	string	是	-	Web 微信小程序 Android iOS HarmonyOS - 4.41 - - -	错误信息