小程序开放平台

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

setZoom

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

以Promise风格调用: 支持

setZoom

设置相机缩放级别。需要先通过

xhs.createCameraContext()
获取 camera 组件的上下文对象,再调用此方法。缩放级别的最大值
maxZoom
由 camera 组件的
bindinitdone
事件返回。

参数

Object object

属性
类型
默认值
必填
说明
zoomnumber缩放级别,取值范围为 1.0 到 maxZoom
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

object.success 回调函数

属性
类型
说明
zoomnumber实际设置的缩放级别
errMsgstring

实例代码

xhs.createCameraContext().setZoom({
  zoom: 2.0, // 缩放级别,需 >= 1.0 且 <= maxZoom
  success: (res) => {
    console.log('设置缩放成功,实际缩放级别:', res.zoom);
  },
  fail: (err) => {
    console.error('设置缩放失败:', err.errMsg);
  },
  complete: () => {
    console.log('setZoom 调用结束');
  }
});