小程序开放平台

文档中心
基础
路由
跳转
转发
界面
网络
支付
数据缓存
媒体
图片
地图
视频
富文本
相机
xhs.createCameraContext()
CameraContext
takePhoto
setZoom
音频
录音
位置
开放接口
设备
XHSML
性能
第三方平台
文件
数据分析
画布

takePhoto

开发
>
JS API
>
媒体
>
相机
>
CameraContext
>
takePhoto
>
更新时间:2026-03-19 17:32:46

以Promise风格调用: 支持

takePhoto

拍摄照片。需要先通过

xhs.createCameraContext()
获取 camera 组件的上下文对象,再调用此方法。

参数

Object object

属性
类型
默认值
必填
说明
qualitystringoriginal成像质量
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

quality 的合法值

说明
low低质量
normal普通质量
original原图质量
high高质量

object.success 回调函数

属性
类型
说明
tempImagePathstring照片临时文件路径,为 xhsfile:// 协议路径
errMsgstring

实例代码

xhs.createCameraContext().takePhoto({
  quality: 'normal', // 成像质量:low / normal / original / high
  success: (res) => {
    console.log('拍照成功:', res);
    console.log('照片路径:', res.tempImagePath); // xhsfile:// 协议的临时路径
  },
  fail: (err) => {
    console.error('拍照失败:', err.errMsg);
  },
  complete: () => {
    console.log('takePhoto 调用结束');
  }
});