API

版本:v2.21.0 更新:2021 年 12 月 25 日

基础

名称

功能说明

wx.canIUse()

判断小程序的API,回调,参数,组件等是否在当前版本可用

wx.base64ToArrayBuffer()

将 Base64 字符串转成 ArrayBuffer 对象

wx.arrayBufferToBase64()

将 ArrayBuffer 对象转成 Base64 字符串

系统信息

更新

名称

功能说明

wx.getUpdateManager()

获取全局唯一的版本更新管理器,用于管理小程序更新

UpdateManager()

UpdateManager.applyUpdate()

强制小程序重启并使用新版本

UpdateManager.onCheckForUpdate()

监听向微信后台请求检查更新结果事件

UpdateManager.onUpdateFailed()

监听小程序更新失败事件

UpdateManager.onUpdateReady()

监听小程序有版本更新事件

小程序

生命周期

名称

功能说明

wx.getLaunchOptionsSync()

获取小程序启动时的参数

应用级事件

名称

功能说明

wx.onPageNotFound()

监听小程序要打开的页面不存在事件

wx.onError()

监听小程序错误事件

wx.onAudioInterruptionEnd()

监听音频中断结束事件

wx.onAudioInterruptionBegin()

监听音频因为受到系统占用而被中断开始事件

wx.onAppShow()

监听小程序切前台事件

wx.onAppHide()

监听小程序切后台事件

wx.offPageNotFound()

取消监听小程序要打开的页面不存在事件

wx.offError()

取消监听小程序错误事件

wx.offAudioInterruptionEnd()

取消监听音频中断结束事件

wx.offAudioInterruptionBegin()

取消监听音频因为受到系统占用而被中断开始事件

wx.offAppShow()

取消监听小程序切前台事件

wx.offAppHide()

取消监听小程序切后台事件

调试

LogManager

名称

功能说明

wx.setEnableDebug()

设置是否打开调试开关

wx.getLogManager()

获取日志管理器对象

LogManager()

日志管理器对象

LogManager.debug()

写 debug 日志

LogManager.info()

写 info 日志

LogManager.log()

写 log 日志

LogManager.warn()

写 warn 日志

console

名称

功能说明

console.debug()

向调试面板中打印 debug 日志

console.error()

向调试面板中打印 error 日志

console.group()

在调试面板中创建一个新的分组

console.groupEnd()

结束由 console.group 创建的分组

console.info()

向调试面板中打印 info 日志

console.log()

向调试面板中打印 log 日志

console.warn()

向调试面板中打印 warn 日志

路由

名称

功能说明

wx.switchTab()

跳转到 tabBar 页面,并关闭其他所有非 tabBar 页面

wx.reLaunch()

关闭所有页面,打开到应用内的某个页面

wx.redirectTo()

关闭当前页面,跳转到应用内的某个页面

wx.navigateTo()

保留当前页面,跳转到应用内的某个页面

wx.navigateBack()

关闭当前页面,返回上一页面或多级页面

界面

交互

名称

功能说明

wx.showToast()

显示消息提示框

wx.hideToast()

隐藏消息提示框

wx.showLoading()

显示 loading 提示框

wx.hideLoading()

隐藏 loading 提示框

wx.showModal()

显示模态对话框

wx.showActionSheet()

显示操作菜单

导航栏

名称

功能说明

wx.showNavigationBarLoading()

在当前页面显示导航条加载动画

wx.setNavigationBarTitle()

动态设置当前页面的标题

wx.setNavigationBarColor()

设置页面导航条颜色

wx.hideNavigationBarLoading()

在当前页面隐藏导航条加载动画

背景

名称

功能说明

wx.setBackgroundTextStyle()

动态设置下拉背景字体、loading 图的样式

wx.setBackgroundColor()

动态设置窗口的背景色

Tab Bar

名称

功能说明

wx.showTabBarRedDot()

显示 tabBar 某一项的右上角的红点

wx.showTabBar()

显示 tabBar

wx.setTabBarStyle()

动态设置 tabBar 的整体样式

wx.setTabBarItem()

动态设置 tabBar 某一项的内容

wx.setTabBarBadge()

为 tabBar 某一项的右上角添加文本

wx.removeTabBarBadge()

移除 tabBar 某一项右上角的文本

wx.hideTabBarRedDot()

隐藏 tabBar 某一项的右上角的红点

wx.hideTabBar()

隐藏 tabBar

字体

名称

功能说明

wx.loadFontFace()

动态加载网络字体

下拉刷新

名称

功能说明

wx.startPullDownRefresh()

开始下拉刷新

wx.stopPullDownRefresh()

停止当前页面下拉刷新

滚动

名称

功能说明

wx.pageScrollTo()

将页面滚动到目标位置

动画

名称

功能说明

wx.createAnimation()

创建一个动画实例 animation

Animation

名称

功能说明

Animation.translateZ()

对 Z 轴平移

Animation.translateY()

对 Y 轴平移

Animation.translateX()

对 X 轴平移

Animation.translate3d()

对 xyz 坐标进行平移变换

Animation.translate()

平移变换

Animation.top()

设置 top 值

Animation.step()

表示一组动画完成

Animation.skewY()

对 Y 轴坐标进行倾斜

Animation.skewX()

对 X 轴坐标进行倾斜

Animation.skew()

对 X、Y 轴坐标进行倾斜

Animation.scaleZ()

缩放 Z 轴

Animation.scaleY()

缩放 Y 轴

Animation.scaleX()

缩放 X 轴

Animation.scale3d()

缩放

Animation.scale()

缩放

Animation.rotateZ()

从 Z 轴顺时针旋转一个角度

Animation.rotateY()

从 Y 轴顺时针旋转一个角度

Animation.rotateX()

从 X 轴顺时针旋转一个角度

Animation.rotate3d()

从 X 轴顺时针旋转一个角度

Animation.rotate()

从原点顺时针旋转一个角度

Animation.right()

设置 right 值

Animation.opacity()

设置透明度

Animation.matrix3d()

同 transform-function matrix3d

Animation.matrix()

同 transform-function matrix

Animation.backgroundColor()

设置背景色

Animation.left()

设置 left 值

Animation.height()

设置高度

Animation.width()

设置宽度

Animation.export()

导出动画队列

Animation.bottom()

设置 bottom 值

置顶

名称

功能说明

wx.setTopBarText()

动态设置置顶栏文字内容

自定义组件

名称

功能说明

wx.nextTick()

延迟一部分操作到下一个时间片再执行

菜单

名称

功能说明

wx.getMenuButtonBoundingClientRect()

获取菜单按钮(右上角胶囊按钮)的布局位置信息

窗口

名称

功能说明

wx.onWindowResize()

监听窗口尺寸变化事件

wx.offWindowResize()

取消监听窗口尺寸变化事件

网络

发起请求

名称

功能说明

wx.request()

发起 HTTPS 网络请求

RequestTask

名称

功能说明

RequestTask.abort()

中断请求任务

RequestTask.offHeadersReceived()

取消监听 HTTP Response Header 事件

RequestTask.onHeadersReceived()

监听 HTTP Response Header 事件

下载

名称

功能说明

wx.downloadFile()

下载文件资源到本地

DownloadTask

名称

功能说明

DownloadTask.abort()

中断下载任务

DownloadTask.offHeadersReceived()

取消监听 HTTP Response Header 事件

DownloadTask.offProgressUpdate()

取消监听下载进度变化事件

DownloadTask.onHeadersReceived()

监听 HTTP Response Header 事件

DownloadTask.onProgressUpdate()

监听下载进度变化事件

上传

名称

功能说明

wx.uploadFile()

将本地资源上传到服务器

UploadTask

名称

功能说明

UploadTask.abort()

中断上传任务

UploadTask.offHeadersReceived()

取消监听 HTTP Response Header 事件

UploadTask.offProgressUpdate()

取消监听上传进度变化事件

UploadTask.onHeadersReceived()

监听 HTTP Response Header 事件

UploadTask.onProgressUpdate()

监听上传进度变化事件

WebSocket

名称

功能说明

wx.sendSocketMessage()

通过 WebSocket 连接发送数据

wx.onSocketOpen()

监听 WebSocket 连接打开事件

wx.onSocketMessage()

监听 WebSocket 接受到服务器的消息事件

wx.onSocketError()

监听 WebSocket 错误事件

wx.onSocketClose()

监听 WebSocket 连接关闭事件

wx.connectSocket()

创建一个 WebSocket 连接

wx.closeSocket()

关闭 WebSocket 连接

SocketTask

名称

功能说明

SocketTask.close()

关闭 WebSocket 连接

SocketTask.onClose()

监听 WebSocket 连接关闭事件

SocketTask.onError()

监听 WebSocket 错误事件

SocketTask.onMessage()

监听 WebSocket 接受到服务器的消息事件

SocketTask.onOpen()

监听 WebSocket 连接打开事件

SocketTask.send()

通过 WebSocket 连接发送数据

mDNS

名称

功能说明

wx.stopLocalServiceDiscovery()

停止搜索 mDNS 服务

wx.startLocalServiceDiscovery()

开始搜索局域网下的 mDNS 服务

wx.onLocalServiceResolveFail()

监听 mDNS 服务解析失败的事件

wx.onLocalServiceLost()

监听 mDNS 服务离开的事件

wx.onLocalServiceFound()

监听 mDNS 服务发现的事件

wx.onLocalServiceDiscoveryStop()

监听 mDNS 服务停止搜索的事件

wx.offLocalServiceResolveFail()

取消监听 mDNS 服务解析失败的事件

wx.offLocalServiceLost()

取消监听 mDNS 服务离开的事件

wx.offLocalServiceFound()

取消监听 mDNS 服务发现的事件

wx.offLocalServiceDiscoveryStop()

取消监听 mDNS 服务停止搜索的事件

UDP 通信

名称

功能说明

wx.createUDPSocket()

创建一个 UDP Socket 实例

UDPSocket()

UDPSocket.bind()

绑定一个系统随机分配的可用端口

UDPSocket.close()

关闭 UDP Socket 实例,相当于销毁

UDPSocket.offClose()

取消监听关闭事件

UDPSocket.offError()

取消监听错误事件

UDPSocket.offListening()

取消监听开始监听数据包消息的事件

UDPSocket.offMessage()

取消监听收到消息的事件

UDPSocket.onClose()

监听关闭事件

UDPSocket.onError()

监听错误事件

UDPSocket.onListening()

监听开始监听数据包消息的事件

UDPSocket.onMessage()

监听收到消息的事件

UDPSocket.send()

向指定的 IP 和 port 发送消息

数据缓存

媒体

地图

名称

功能说明

wx.createMapContext()

创建 map 上下文 MapContext 对象

MapContext()

MapContext 对象

MapContext.getCenterLocation()

获取当前地图中心的经纬度

MapContext.getRegion()

获取当前地图的视野范围

MapContext.getScale()

获取当前地图的缩放级别

MapContext.includePoints()

缩放视野展示所有经纬度

MapContext.moveToLocation()

将地图中心移动到当前定位点

MapContext.translateMarker()

平移marker,带动画

图片

名称

功能说明

wx.saveImageToPhotosAlbum()

保存图片到系统相册

wx.previewImage()

在新页面中全屏预览图片

wx.getImageInfo()

获取图片信息

wx.compressImage()

压缩图片接口,可选压缩质量

wx.chooseMessageFile()

从客户端会话选择文件

wx.chooseImage()

从本地相册选择图片或使用相机拍照

视频

名称

功能说明

wx.saveVideoToPhotosAlbum()

保存视频到系统相册

wx.chooseVideo()

拍摄视频或从手机相册中选视频

wx.createVideoContext()

创建 video 上下文 VideoContext 对象

VideoContext()

通过 wx.createVideoContext() 获取

VideoContext.seek()

跳转到指定位置

VideoContext.exitFullScreen()

退出全屏

VideoContext.hideStatusBar()

隐藏状态栏,仅在iOS全屏下有效

VideoContext.pause()

暂停视频

VideoContext.play()

播放视频

VideoContext.playbackRate()

设置倍速播放

VideoContext.requestFullScreen()

进入全屏

VideoContext.sendDanmu()

发送弹幕

VideoContext.showStatusBar()

显示状态栏,仅在iOS全屏下有效

VideoContext.stop()

停止视频

音频

名称

功能说明

wx.getAvailableAudioSources()

获取当前支持的音频输入源

wx.createInnerAudioContext()

创建内部 audio 上下文 InnerAudioContext 对象

wx.setInnerAudioOption()

设置 InnerAudioContext 的播放选项

InnerAudioContext.destroy()

销毁当前实例

InnerAudioContext.offCanplay()

取消监听音频进入可以播放状态的事件

InnerAudioContext.offEnded()

取消监听音频自然播放至结束的事件

InnerAudioContext.offError()

取消监听音频播放错误事件

InnerAudioContext.offPause()

取消监听音频暂停事件

InnerAudioContext.offPlay()

取消监听音频播放事件

InnerAudioContext.offSeeked()

取消监听音频完成跳转操作的事件

InnerAudioContext.offSeeking()

取消监听音频进行跳转操作的事件

InnerAudioContext.offStop()

取消监听音频停止事件

InnerAudioContext.offTimeUpdate()

取消监听音频播放进度更新事件

InnerAudioContext.offWaiting()

取消监听音频加载中事件

InnerAudioContext.onCanplay()

监听音频进入可以播放状态的事件

InnerAudioContext.onEnded()

监听音频自然播放至结束的事件

InnerAudioContext.onError()

监听音频播放错误事件

InnerAudioContext.onPause()

监听音频暂停事件

InnerAudioContext.onPlay()

监听音频播放事件

InnerAudioContext.onSeeked()

监听音频完成跳转操作的事件

InnerAudioContext.onSeeking()

监听音频进行跳转操作的事件

InnerAudioContext.onStop()

监听音频停止事件

InnerAudioContext.onTimeUpdate()

监听音频播放进度更新事件

InnerAudioContext.onWaiting()

监听音频加载中事件

InnerAudioContext.pause()

暂停

InnerAudioContext.play()

播放

InnerAudioContext.seek()

跳转到指定位置

InnerAudioContext.stop()

停止

背景音频

名称

功能说明

wx.getBackgroundAudioManager()

获取全局唯一的背景音频管理器

BackgroundAudioManager()

全局唯一的背景音频管理器

BackgroundAudioManager.onCanplay()

监听背景音频进入可播放状态事件

BackgroundAudioManager.onEnded()

监听背景音频自然播放结束事件

BackgroundAudioManager.onError()

监听背景音频播放错误事件

BackgroundAudioManager.onNext()

监听用户在系统音乐播放面板点击下一曲事件(仅iOS)

BackgroundAudioManager.onPause()

监听背景音频暂停事件

BackgroundAudioManager.onPlay()

监听背景音频播放事件

BackgroundAudioManager.onPrev()

监听用户在系统音乐播放面板点击上一曲事件(仅iOS)

BackgroundAudioManager.onSeeked()

监听背景音频完成跳转操作事件

BackgroundAudioManager.onSeeking()

监听背景音频开始跳转操作事件

BackgroundAudioManager.onStop()

监听背景音频停止事件

BackgroundAudioManager.onTimeUpdate()

监听背景音频播放进度更新事件

BackgroundAudioManager.onWaiting()

监听音频加载中事件

BackgroundAudioManager.pause()

暂停音乐

BackgroundAudioManager.play()

播放音乐

BackgroundAudioManager.seek()

跳转到指定位置

BackgroundAudioManager.stop()

停止音乐

实时音视频

LivePusherContext

名称

功能说明

wx.createLivePusherContext()

创建 live-pusher 上下文 LivePusherContext 对象

LivePusherContext.pause()

暂停推流

LivePusherContext.pauseBGM()

暂停背景音

LivePusherContext.playBGM()

播放背景音

LivePusherContext.resume()

恢复推流

LivePusherContext.resumeBGM()

恢复背景音

LivePusherContext.setBGMVolume()

设置背景音音量

LivePusherContext.snapshot()

快照

LivePusherContext.start()

播放推流

LivePusherContext.stop()

停止推流

LivePusherContext.stopBGM()

停止背景音

LivePusherContext.switchCamera()

切换前后摄像头

LivePusherContext.toggleTorch()

切换

LivePlayerContext

名称

功能说明

wx.createLivePlayerContext()

创建 live-player 上下文 LivePlayerContext 对象

LivePlayerContext.exitFullScreen()

退出全屏

LivePlayerContext.mute()

静音

LivePlayerContext.pause()

暂停

LivePlayerContext.play()

播放

LivePlayerContext.requestFullScreen()

进入全屏

LivePlayerContext.resume()

恢复

LivePlayerContext.stop()

停止

录音 RecorderManager

名称

功能说明

wx.getRecorderManager()

获取全局唯一的录音管理器 RecorderManager

RecorderManager()

RecorderManager.onError()

监听录音错误事件

RecorderManager.onFrameRecorded()

监听已录制完指定帧大小的文件事件

RecorderManager.onInterruptionBegin()

监听录音因为受到系统占用而被中断开始事件

RecorderManager.onInterruptionEnd()

监听录音中断结束事件

RecorderManager.onPause()

监听录音暂停事件

RecorderManager.onResume()

监听录音继续事件

RecorderManager.onStart()

监听录音开始事件

RecorderManager.onStop()

监听录音结束事件

RecorderManager.pause()

暂停录音

RecorderManager.resume()

继续录音

RecorderManager.start()

开始录音

RecorderManager.stop()

停止录音

wx.stopRecord()

停止录音 .. deprecated:: 1.6.0

wx.startRecord()

开始录音 .. deprecated :: 1.6.0

相机 CameraContext

名称

功能说明

wx.createCameraContext()

创建 camera 上下文 CameraContext 对象

CameraContext()

CameraContext 实例

CameraContext.startRecord()

开始录像

CameraContext.stopRecord()

结束录像

CameraContext.takePhoto()

拍摄照片

富文本

名称

功能说明

EditorContext()

EditorContext.clear()

清空编辑器内容

EditorContext.format()

修改样式

EditorContext.getContents()

获取编辑器内容

EditorContext.insertDivider()

插入分割线

EditorContext.insertImage()

插入图片

EditorContext.insertText()

覆盖当前选区,设置一段文本

EditorContext.redo()

恢复

EditorContext.removeFormat()

清除当前选区的样式

EditorContext.setContents()

初始化编辑器内容,html 和 delta 同时存在时仅 delta api 生效

EditorContext.undo()

撤销

位置

名称

功能说明

wx.openLocation()

使用微信内置地图查看位置

wx.getLocation()

获取当前的地理位置、速度

wx.chooseLocation()

打开地图选择位置

转发

名称

功能说明

wx.updateShareMenu()

更新转发属性

wx.showShareMenu()

显示当前页面的转发按钮

wx.hideShareMenu()

隐藏转发按钮

wx.getShareInfo()

获取转发详细信息

画布

名称

功能说明

wx.createCanvasContext()

创建 canvas 的绘图上下文 CanvasContext 对象

wx.canvasToTempFilePath()

把当前画布指定区域的内容导出生成指定大小的图片

wx.canvasPutImageData()

将像素数据绘制到画布

wx.canvasGetImageData()

获取 canvas 区域隐含的像素数据

Color

颜色

CanvasGradient

名称

功能说明

CanvasGradient.addColorStop

添加颜色的渐变点

CanvasContext

名称

功能说明

CanvasContext.arc()

创建一条弧线

CanvasContext.arcTo()

根据控制点和半径绘制圆弧路径

CanvasContext.beginPath()

开始创建一个路径

CanvasContext.bezierCurveTo()

创建三次方贝塞尔曲线路径

CanvasContext.clearRect()

清除画布上在该矩形区域内的内容

CanvasContext.clip()

从原始画布中剪切任意形状和尺寸

CanvasContext.closePath()

关闭一个路径

CanvasContext.createCircularGradient()

创建一个圆形的渐变颜色

CanvasContext.createLinearGradient()

创建一个线性的渐变颜色

CanvasContext.createPattern()

对指定的图像创建模式的方法,可在指定的方向上重复元图像

CanvasContext.draw()

将之前在绘图上下文中的描述(路径、变形、样式)画到 canvas 中

CanvasContext.drawImage()

绘制图像到画布

CanvasContext.fill()

对当前路径中的内容进行填充

CanvasContext.fillRect()

填充一个矩形

CanvasContext.fillText()

在画布上绘制被填充的文本

CanvasContext.lineTo()

增加一个新点,然后创建一条从上次指定点到目标点的线

CanvasContext.measureText()

测量文本尺寸信息

CanvasContext.moveTo()

把路径移动到画布中的指定点,不创建线条

CanvasContext.quadraticCurveTo()

创建二次贝塞尔曲线路径

CanvasContext.rect()

创建一个矩形路径

CanvasContext.restore()

恢复之前保存的绘图上下文

CanvasContext.rotate()

以原点为中心顺时针旋转当前坐标轴

CanvasContext.save()

保存绘图上下文

CanvasContext.scale()

在调用后,之后创建的路径其横纵坐标会被缩放

CanvasContext.setFillStyle()

设置填充色

CanvasContext.setFontSize()

设置字体的字号

CanvasContext.setGlobalAlpha()

设置全局画笔透明度

CanvasContext.setLineCap()

设置线条的端点样式

CanvasContext.setLineDash()

设置虚线样式

CanvasContext.setLineJoin()

设置线条的交点样式

CanvasContext.setLineWidth()

设置线条的宽度

CanvasContext.setMiterLimit()

设置最大斜接长度

CanvasContext.setShadow()

设定阴影样式

CanvasContext.setStrokeStyle()

设置描边颜色

CanvasContext.setTextAlign()

设置文字的对齐

CanvasContext.setTextBaseline()

设置文字的竖直对齐

CanvasContext.setTransform()

使用矩阵重新设置(覆盖)当前变换的方法

CanvasContext.stroke()

画出当前路径的边框

CanvasContext.strokeRect()

画一个矩形(非填充)

CanvasContext.strokeText()

给定的 (x, y) 位置绘制文本描边的方法

CanvasContext.transform()

使用矩阵多次叠加当前变换的方法

CanvasContext.translate()

对当前坐标系的原点 (0, 0) 进行变换

文件

名称

功能说明

wx.saveFile()

保存文件到本地

wx.removeSavedFile()

删除本地缓存文件

wx.openDocument()

新开页面打开文档

wx.getSavedFileList()

获取该小程序下已保存的本地缓存文件列表

wx.getSavedFileInfo()

获取本地文件的文件信息

wx.getFileSystemManager()

获取全局唯一的文件管理器

wx.getFileInfo()

获取文件信息

Stats

名称

功能说明

Stats.isDirectory()

判断当前文件是否一个目录

Stats.isFile()

判断当前文件是否一个普通文件

FileSystemManager

名称

功能说明

FileSystemManager.access()

判断文件/目录是否存在

FileSystemManager.accessSync()

FileSystemManager.access() 的同步版本

FileSystemManager.appendFile()

在文件结尾追加内容

FileSystemManager.appendFileSync()

FileSystemManager.appendFile() 的同步版本

FileSystemManager.copyFile()

复制文件

FileSystemManager.copyFileSync()

FileSystemManager.copyFile() 的同步版本

FileSystemManager.getFileInfo()

获取该小程序下的 本地临时文件 或 本地缓存文件 信息

FileSystemManager.getSavedFileList()

获取该小程序下已保存的本地缓存文件列表

FileSystemManager.mkdir()

创建目录

FileSystemManager.mkdirSync()

FileSystemManager.mkdir() 的同步版本

FileSystemManager.readdir()

读取目录内文件列表

FileSystemManager.readdirSync()

FileSystemManager.readdir() 的同步版本

FileSystemManager.readFile()

读取本地文件内容

FileSystemManager.readFileSync()

FileSystemManager.readFile() 的同步版本

FileSystemManager.removeSavedFile()

删除该小程序下已保存的本地缓存文件

FileSystemManager.rename()

重命名文件

FileSystemManager.renameSync()

FileSystemManager.rename() 的同步版本

FileSystemManager.rmdir()

删除目录

FileSystemManager.rmdirSync()

FileSystemManager.rmdir() 的同步版本

FileSystemManager.saveFile()

保存临时文件到本地

FileSystemManager.saveFileSync()

FileSystemManager.saveFile() 的同步版本

FileSystemManager.stat()

获取文件 Stats 对象

FileSystemManager.statSync()

FileSystemManager.stat() 的同步版本

FileSystemManager.unlink()

删除文件

FileSystemManager.unlinkSync()

FileSystemManager.unlink() 的同步版本

FileSystemManager.unzip()

解压文件

FileSystemManager.writeFile()

写文件

FileSystemManager.writeFileSync()

FileSystemManager.writeFile() 的同步版本

开放接口

登录

名称

功能说明

wx.pluginLogin()

该接口仅在小程序插件中可调用,调用接口获得插件用户标志凭证(code)

wx.login()

调用接口获取登录凭证(code)

wx.checkSession()

检查登录态是否过期

小程序跳转

名称

功能说明

wx.navigateToMiniProgram()

打开另一个小程序

wx.navigateBackMiniProgram()

返回到上一个小程序

帐号信息

名称

功能说明

wx.getAccountInfoSync()

获取当前帐号信息

用户信息

名称

功能说明

wx.getUserInfo()

获取用户信息

UserInfo()

用户信息

数据上报

名称

功能说明

wx.reportMonitor()

自定义业务数据监控上报接口

数据分析

名称

功能说明

wx.reportAnalytics()

自定义分析数据上报接口

支付

名称

功能说明

wx.requestPayment()

发起微信支付

授权

名称

功能说明

wx.authorize()

提前向用户发起授权请求

设置

名称

功能说明

wx.openSetting()

调起客户端小程序设置界面,返回用户设置的操作结果

wx.getSetting()

获取用户的当前设置

AuthSetting()

用户授权设置信息,详情参考权限

收货地址

名称

功能说明

wx.chooseAddress()

获取用户收货地址

卡券

名称

功能说明

wx.openCard()

查看微信卡包中的卡券

wx.addCard()

批量添加卡券

发票

名称

功能说明

wx.chooseInvoiceTitle()

选择用户的发票抬头

wx.chooseInvoice()

选择用户已有的发票

生物认证

名称

功能说明

wx.startSoterAuthentication()

开始 SOTER 生物认证

wx.checkIsSupportSoterAuthentication()

获取本机支持的 SOTER 生物认证方式

wx.checkIsSoterEnrolledInDevice()

获取设备内是否录入如指纹等生物信息的接口

微信运动

名称

功能说明

wx.getWeRunData()

获取用户过去三十天微信运动步数

订阅消息

名称

功能说明

wx.requestSubscribeMessage()

调起客户端小程序订阅消息界面,返回用户订阅消息的操作结果

微信红包

名称

功能说明

wx.showRedPackage()

拉取h5领取红包封面页

收藏

名称

功能说明

wx.addVideoToFavorites()

收藏视频

wx.addFileToFavorites()

收藏文件

设备

Wi-Fi

名称

功能说明

wx.stopWifi()

关闭 Wi-Fi 模块

wx.startWifi()

初始化 Wi-Fi 模块

wx.setWifiList()

设置 wifiList 中 AP 的相关信息

wx.onWifiConnected()

监听连接上 Wi-Fi 的事件

wx.onGetWifiList()

监听获取到 Wi-Fi 列表数据事件

wx.getWifiList()

请求获取 Wi-Fi 列表

wx.getConnectedWifi()

获取已连接中的 Wi-Fi 信息

wx.connectWifi()

连接 Wi-Fi

WifiInfo()

Wifi 信息

iBeacon

名称

功能说明

wx.stopBeaconDiscovery()

停止搜索附近的 iBeacon 设备

wx.startBeaconDiscovery()

开始搜索附近的 iBeacon 设备

wx.onBeaconUpdate()

监听 iBeacon 设备更新事件

wx.onBeaconServiceChange()

监听 iBeacon 服务状态变化事件

wx.getBeacons()

获取所有已搜索到的 iBeacon 设备

IBeaconInfo

联系人

名称

功能说明

wx.addPhoneContact()

添加手机通讯录联系人

低功耗蓝牙

名称

功能说明

wx.writeBLECharacteristicValue()

向低功耗蓝牙设备特征值中写入二进制数据

wx.readBLECharacteristicValue()

读取低功耗蓝牙设备的特征值的二进制数据值

wx.onBLEConnectionStateChange()

监听低功耗蓝牙连接状态的改变事件

wx.onBLECharacteristicValueChange()

监听低功耗蓝牙设备的特征值变化事件

wx.notifyBLECharacteristicValueChange()

启用低功耗蓝牙设备特征值变化时的 notify 功能,订阅特征值

wx.getBLEDeviceServices()

获取蓝牙设备所有服务(service)

wx.getBLEDeviceCharacteristics()

获取蓝牙设备某个服务中所有特征值(characteristic)

wx.createBLEConnection()

连接低功耗蓝牙设备

wx.closeBLEConnection()

断开与低功耗蓝牙设备的连接

蓝牙

名称

功能说明

wx.stopBluetoothDevicesDiscovery()

停止搜寻附近的蓝牙外围设备

wx.startBluetoothDevicesDiscovery()

开始搜寻附近的蓝牙外围设备

wx.openBluetoothAdapter()

初始化蓝牙模块

wx.onBluetoothDeviceFound()

监听寻找到新设备的事件

wx.onBluetoothAdapterStateChange()

监听蓝牙适配器状态变化事件

wx.getConnectedBluetoothDevices()

根据 uuid 获取处于已连接状态的设备

wx.getBluetoothDevices()

获取在蓝牙模块生效期间所有已发现的蓝牙设备

wx.getBluetoothAdapterState()

获取本机蓝牙适配器状态

wx.closeBluetoothAdapter()

关闭蓝牙模块

电量

名称

功能说明

wx.getBatteryInfoSync()

wx.getBatteryInfo() 的同步版本

wx.getBatteryInfo()

获取设备电量

剪贴板

名称

功能说明

wx.setClipboardData()

设置系统剪贴板的内容

wx.getClipboardData()

获取系统剪贴板的内容

NFC

名称

功能说明

wx.stopHCE()

关闭 NFC 模块

wx.startHCE()

初始化 NFC 模块

wx.sendHCEMessage()

发送 NFC 消息

wx.onHCEMessage()

监听接收 NFC 设备消息事件

wx.getHCEState()

判断当前设备是否支持 HCE 能力

网络

名称

功能说明

wx.onNetworkStatusChange()

监听网络状态变化事件

wx.getNetworkType()

获取网络类型

屏幕

名称

功能说明

wx.setScreenBrightness()

设置屏幕亮度

wx.setKeepScreenOn()

设置是否保持常亮状态

wx.onUserCaptureScreen()

监听用户主动截屏事件

wx.getScreenBrightness()

获取屏幕亮度

电话

名称

功能说明

wx.makePhoneCall()

拨打电话

加速计

名称

功能说明

wx.stopAccelerometer()

停止监听加速度数据

wx.startAccelerometer()

开始监听加速度数据

wx.onAccelerometerChange()

监听加速度数据事件

罗盘

名称

功能说明

wx.stopCompass()

停止监听罗盘数据

wx.startCompass()

开始监听罗盘数据

wx.onCompassChange()

监听罗盘数据变化事件

设备方向

名称

功能说明

wx.stopDeviceMotionListening()

停止监听设备方向的变化

wx.startDeviceMotionListening()

开始监听设备方向的变化

wx.onDeviceMotionChange()

监听设备方向变化事件

陀螺仪

名称

功能说明

wx.stopGyroscope()

停止监听陀螺仪数据

wx.startGyroscope()

开始监听陀螺仪数据

wx.onGyroscopeChange()

监听陀螺仪数据变化事件

性能

名称

功能说明

wx.onMemoryWarning()

监听内存不足告警事件

扫码

名称

功能说明

wx.scanCode()

调起客户端扫码界面进行扫码

振动

名称

功能说明

wx.vibrateShort()

使手机发生较短时间的振动(15 ms)

wx.vibrateLong()

使手机发生较长时间的振动(400 ms)

Worker

名称

功能说明

wx.createWorker()

创建一个 Worker 线程

Worker()

Worker 线程

Worker.onMessage()

监听主线程/Worker 线程向当前线程发送的消息的事件

Worker.postMessage()

向主线程/Worker 线程发送的消息

Worker.terminate()

结束当前 Worker 线程

第三方平台

名称

功能说明

wx.getExtConfigSync()

wx.getExtConfig() 的同步版本

wx.getExtConfig()

获取第三方平台自定义的数据字段

WXML

名称

功能说明

wx.createSelectorQuery()

返回一个 SelectorQuery 对象实例

wx.createIntersectionObserver()

创建并返回一个 IntersectionObserver 对象实例

SelectorQuery

名称

功能说明

SelectorQuery.exec()

执行所有的请求

SelectorQuery.in()

将选择器的选取范围更改为自定义组件 component 内

SelectorQuery.select()

在当前页面下选择第一个匹配选择器 selector 的节点

SelectorQuery.selectAll()

在当前页面下选择匹配选择器 selector 的所有节点

SelectorQuery.selectViewport()

选择显示区域

NodesRef

名称

功能说明

NodesRef.boundingClientRect()

添加节点的布局位置的查询请求

NodesRef.context()

添加节点的 Context 对象查询请求

NodesRef.fields()

获取节点的相关信息

NodesRef.scrollOffset()

添加节点的滚动位置查询请求

IntersectionObserver

名称

功能说明

IntersectionObserver.disconnect()

停止监听

IntersectionObserver.observe()

指定目标节点并开始监听相交状态变化情况

IntersectionObserver.relativeTo()

使用选择器指定一个节点,作为参照区域之一

IntersectionObserver.relativeToViewport()

指定页面显示区域作为参照区域之一