# API 总览
- 当前最新版 多端 SDK( 即 Android SDK >= 1.5 以及 iOS SDK >= 1.5.3 版本) 对齐小程序基础库的版本是 3.6.5;其余版本 SDK 对齐小程序基础库的版本是 3.2.5
- 其他通用接口的接口文档可查看 小程序 API 文档中心,如果与小程序 API 有所区别的即可点击跳转对应接口文档
- 是否支持:指的是是否适用于多端框架;由于和小程序是同源 API,“否“表示的是只支持小程序环境中使用,不适用于多端框架使用
- 如果测试出现了不符合预期的情况,可先检查一下 SDK 是否已经是最新的,以及是否配置了扩展 SDK ,如自查依旧无法定位问题可联系社区小助手进行参考
- 如开发者的 App 中需使用到下方标记的尚未支持的 API,可联系社区小助手进行需求反馈
图表中
是[1]: 表示支持,但 API 返回的内容和小程序的存在差异
否[1]: 表示不支持,原因是有替代方案
支持的类型
- 支持,但 API 返回内容有差异
- 支持,但交互行为存在差异
- 支持,但停止维护
不支持的原因
- 有其他替代方案
- 尚未支持,后续会支持
- 尚未支持,后续会支持,但是 API 含义会有差异
- 微信特有交互流程,后续不会支持
- 已废弃,后续不会支持
- 特定系统才有的 API,后续不会支持
补充:
- 点此查看基础SDK包含的 JSAPI
- 点此查看JSAPI 对应依赖的 扩展 SDK
# 基础
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.env | 环境变量 | 是 |
wx.canIUse | 判断应用的API,回调,参数,组件等是否在当前版本可用 | 是 |
wx.base64ToArrayBuffer | 将 Base64 字符串转成 ArrayBuffer 对象 | 是[3] |
wx.arrayBufferToBase64 | 将 ArrayBuffer 对象转成 Base64 字符串 | 是[3] |
# 系统
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.getSystemInfo | 获取系统信息 | 是[1] |
wx.openSystemBluetoothSetting | 跳转系统蓝牙设置页 | 否[2] |
wx.openAppAuthorizeSetting | 跳转系统授权管理页 | 是 |
wx.getAppAuthorizeSetting | 获取 App 授权设置 | 是 |
wx.getWindowInfo | 获取窗口信息 | 是 |
wx.getSystemSetting | 获取设备设置 | 是 |
wx.getSystemInfoSync | wx.getSystemInfo 的同步版本 | 是[1] |
wx.getSystemInfoAsync | 异步获取系统信息 | 是[1] |
wx.getDeviceInfo | 获取设备基础信息 | 是 |
wx.getAppBaseInfo | 获取 App 基础信息 | 是[1] |
# 更新
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.updateWeChatApp | 更新客户端版本 | 否[4] |
wx.getUpdateManager | 获取全局唯一的版本更新管理器,用于管理小程序更新 | 否[4] |
# 生命周期
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.getLaunchOptionsSync | 获取应用启动时的参数 | 是[1] |
wx.getEnterOptionsSync | 获取本次应用启动时的参数 | 是[1] |
# 应用级事件
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.onUnhandledRejection | 监听未处理的 Promise 拒绝事件 | 是 |
wx.onThemeChange | 监听系统主题改变事件 | 是 |
wx.onPageNotFound | 监听应用要打开的页面不存在事件 | 是 |
wx.onLazyLoadError | 监听应用异步组件加载失败回调 | 是 |
wx.onError | 监听应用错误事件 | 是 |
wx.onAudioInterruptionEnd | 监听音频中断结束事件 | 是 |
wx.onAudioInterruptionBegin | 监听音频因为受到系统占用而被中断开始事件 | 是 |
wx.onAppShow | 应用切前台事件 | 是 |
wx.onAppHide | 监听应用切后台事件 | 是 |
wx.offUnhandledRejection | 取消监听未处理的 Promise 拒绝事件 | 是 |
wx.offThemeChange | 取消监听系统主题改变事件 | 是 |
wx.offPageNotFound | 取消监听应用要打开的页面不存在事件 | 是 |
wx.offLazyLoadError | 取消监听应用异步组件加载失败回调 | 是 |
wx.offError | 取消监听应用错误事件 | 是 |
wx.offAudioInterruptionEnd | 取消监听音频中断结束事件 | 是 |
wx.offAudioInterruptionBegin | 取消监听音频因为受到系统占用而被中断开始事件 | 是 |
wx.offAppShow | 取消监听应用切前台事件 | 是 |
wx.offAppHide | 取消监听应用切后台事件 | 是 |
# 调试
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.setEnableDebug | 设置是否打开调试开关 | 是 |
wx.getRealtimeLogManager | 获取实时日志管理器对象 | 是[2],但日志只在本地生效,尚未有系统可以查询 |
wx.getLogManager | 获取日志管理器对象 | 是[2],但日志只在本地生效,尚未有系统可以查询 |
# 性能
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.reportPerformance | 小程序测速上报 | 否[2] |
wx.preloadWebview | 预加载下个页面的 WebView | 否[2] |
wx.preloadSkylineView | 预加载下个页面所需要的 Skyline 运行环境 | 否[2] |
wx.preloadAssets | 为视图层预加载媒体资源文件, 目前支持:font,image | 否[2] |
wx.getPerformance | 获取当前应用性能相关的信息 | 是 |
# 加密
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.getUserCryptoManager | 获取用户加密模块 | 否[1],可使用安全网关替代 |
# 路由
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.switchTab | 跳转到 tabBar 页面,并关闭其他所有非 tabBar 页面 | 是 |
wx.reLaunch | 关闭所有页面,打开到应用内的某个页面 | 是 |
wx.redirectTo | 关闭当前页面,跳转到应用内的某个页面 | 是 |
wx.navigateTo | 保留当前页面,跳转到应用内的某个页面 | 是 |
wx.navigateBack | 关闭当前页面,返回上一页面或多级页面 | 是 |
# EventChannel
名称 | 功能说明 | 是否支持 |
---|---|---|
EventChannel.emit | 触发一个事件 | 是 |
EventChannel.off | 取消监听一个事件 | 是 |
EventChannel.on | 持续监听一个事件 | 是 |
EventChannel.once | 监听一个事件一次,触发后失效 | 是 |
# 跳转
- wx.navigateToMiniProgram 不支持,开发者可使用新接口 wx.miniapp.launchMiniProgram 实现
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.openEmbeddedMiniProgram | 打开半屏小程序 | 否[4] |
wx.navigateToMiniProgram | 打开另一个小程序 | 否[4] |
wx.navigateBackMiniProgram | 返回到上一个小程序 | 否[4] |
wx.exitMiniProgram | 退出当前小程序 | 否[4] |
# 转发
- 可以通过新接口实现分享到微信的功能,详情可查看 wx.miniapp.shareImageMessage、 wx.miniapp.shareMiniProgramMessage、 wx.miniapp.shareTextMessage、 wx.miniapp.shareWebPageMessage、 wx.miniapp.shareVideoMessage
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.updateShareMenu | 更新转发属性 | 否[4] |
wx.showShareMenu | 显示当前页面的转发按钮 | 否[4] |
wx.showShareImageMenu | 打开分享图片弹窗,可以将图片发送给朋友、收藏或下载 | 否[4] |
wx.shareVideoMessage | 转发视频到聊天 | 否[1] |
wx.shareFileMessage | 转发文件到聊天 | 否[1] |
wx.onCopyUrl | 监听用户点击右上角菜单的「复制链接」按钮时触发的事件 | 否[4] |
wx.offCopyUrl | 移除用户点击右上角菜单的「复制链接」按钮时触发的事件的监听函数 | 否[4] |
wx.hideShareMenu | 隐藏当前页面的转发按钮 | 否[4] |
wx.getShareInfo | 获取转发详细信息 | 否[4] |
wx.authPrivateMessage | 验证私密消息 | 否[4] |
# 界面
# 交互
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.showToast | 显示消息提示框 | 是 |
wx.showModal | 显示模态对话框 | 是 |
wx.showLoading | 显示 loading 提示框 | 是 |
wx.showActionSheet | 显示操作菜单 | 是 |
wx.hideToast | 隐藏消息提示框 | 是 |
wx.hideLoading | 隐藏 loading 提示框 | 是 |
wx.enableAlertBeforeUnload | 开启应用页面返回询问对话框 | 是 |
wx.disableAlertBeforeUnload | 关闭应用页面返回询问对话框 | 是 |
# 导航栏
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.showNavigationBarLoading | 在当前页面显示导航条加载动画 | 是 |
wx.setNavigationBarTitle | 动态设置当前页面的标题 | 是 |
wx.setNavigationBarColor | 设置页面导航条颜色 | 是 |
wx.hideNavigationBarLoading | 在当前页面隐藏导航条加载动画 | 是 |
wx.hideHomeButton | 隐藏返回首页按钮 | 是 |
# 背景
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.setBackgroundTextStyle | 动态设置下拉背景字体、loading 图的样式 | 是 |
wx.setBackgroundColor | 动态设置窗口的背景色 | 是 |
# Tab Bar
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.showTabBarRedDot | 显示 tabBar 某一项的右上角的红点 | 是 |
wx.showTabBar | 显示 tabBar | 是 |
wx.setTabBarStyle | 动态设置 tabBar 的整体样式 | 是 |
wx.setTabBarItem | 动态设置 tabBar 某一项的内容,2.7.0 起图片支持临时文件和网络文件 | 是 |
wx.setTabBarBadge | 为 tabBar 某一项的右上角添加文本 | 是 |
wx.removeTabBarBadge | 移除 tabBar 某一项右上角的文本 | 是 |
wx.hideTabBarRedDot | 隐藏 tabBar 某一项的右上角的红点 | 是 |
wx.hideTabBar | 隐藏 tabBar |
# 字体
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.loadFontFace | 动态加载网络字体,文件地址需为下载类型 | 是 |
# 下拉刷新
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.stopPullDownRefresh | 停止当前页面下拉刷新 | 是 |
wx.startPullDownRefresh | 开始下拉刷新 | 是 |
# 滚动
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.pageScrollTo | 将页面滚动到目标位置,支持选择器和滚动距离两种方式定位 | 是 |
# ScrollViewContext
名称 | 功能说明 | 是否支持 |
---|---|---|
ScrollViewContext.scrollIntoView | 滚动至指定位置 | 是 |
ScrollViewContext.scrollTo | 滚动至指定位置 | 是 |
# 动画
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.createAnimation | 创建一个动画实例 animation(Animation | 是 |
# 置顶
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.setTopBarText | 动态设置置顶栏文字内容 | 否[5] |
# 自定义组件
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.nextTick | 延迟一部分操作到下一个时间片再执行 | 是 |
# 菜单
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.getMenuButtonBoundingClientRect | 获取菜单按钮(右上角胶囊按钮)的布局位置信息 | 是[2], App里不再呈现胶囊标识,该接口依旧返回相关坐标信息,便于开发者进行多端兼容 |
# 窗口
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.setWindowSize | 设置窗口大小,该接口仅适用于 PC 平台 | 否[6] |
wx.onWindowResize | 监听窗口尺寸变化事件 | 否[6] |
wx.offWindowResize | 移除窗口尺寸变化事件的监听函数 | 否[6] |
# worklet 动画
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.worklet | 获取 worklet 对象 | 否[2] |
# 网络
# 发起请求
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.request | 发起 HTTPS 网络请求 | 是 |
# 下载
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.downloadFile | 下载文件资源到本地 | 是[2],下载允许的最大文件已调整为 2G |
# 上传
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.uploadFile | 将本地资源上传到服务器 | 是 |
# WebSocket
- 下方 WebSocket 相关的 JSAPI 依赖扩展 SDK "Network SDK" ,开发者需在项目中的
project.miniapp.json
配置勾选对应的 SDK 方可生效; - 注意:Android 和 iOS 的扩展 SDK 有所区别,详情查看
project.miniapp.json
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.sendSocketMessage | 通过 WebSocket 连接发送数据 | 是 |
wx.onSocketOpen | 监听 WebSocket 连接打开事件 | 是 |
wx.onSocketMessage | 监听 WebSocket 接受到服务器的消息事件 | 是 |
wx.onSocketError | 监听 WebSocket 错误事件 | 是 |
wx.onSocketClose | 监听 WebSocket 连接关闭事件 | 是 |
wx.connectSocket | 创建一个 WebSocket 连接 | 是 |
wx.closeSocket | 关闭 WebSocket 连接 | 是 |
# mDNS
- 下方 mDNS 相关的 JSAPI 依赖扩展 SDK "Network SDK" ,开发者需在项目中的
project.miniapp.json
配置勾选对应的 SDK 方可生效; - 注意:Android 和 iOS 的扩展 SDK 有所区别,详情查看
project.miniapp.json
名称 | 功能说明 | 是否支持 |
---|---|---|
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 服务停止搜索的事件 | 是 |
# TCP 通信
- 下方 TCP 通信相关的 JSAPI 依赖扩展 SDK "Network SDK" ,开发者需在项目中的
project.miniapp.json
配置勾选对应的 SDK 方可生效; - 注意:Android 和 iOS 的扩展 SDK 有所区别,详情查看
project.miniapp.json
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.createTCPSocket | 创建一个 TCP Socket 实例 | 支持 |
# UDP 通信
- 下方 UDP 通信相关的 JSAPI 依赖扩展 SDK 「Network SDK」 ,开发者需在项目中的
project.miniapp.json
配置勾选对应的 SDK 方可生效; - 注意:Android 和 iOS 的扩展 SDK 有所区别,详情查看
project.miniapp.json
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.createUDPSocket | 创建一个 UDP Socket 实例 | 支持 |
# 支付
- 需使用 wx.miniapp.requestPayment
- iOS 的部分场景,需使用苹果内购 IAP(In-App Purchase),详情可查看wx.miniapp.IAP
- 如果是 iOS ,则需要在项目中的
project.miniapp.json
配置勾选 「OpenFuns SDK(含支付)」这个扩展 SDK
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.requestPluginPayment | 插件中发起支付 | 否[1] |
wx.requestPayment | 发起微信支付 | 否[1] |
# 监听Scheme/UniversalLink进入多端App
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.miniapp.registOpenURL | 监听通过Scheme/UniversalLink进入App的事件 | 是 |
# 数据缓存
- 多端应用模式下,wx.setStorage 的限制有所提升,单个 key 允许存储的最大数据长度为 100 MB,所有数据存储上限为 2G
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.setStorageSync | 将数据存储在本地缓存中指定的 key 中 | 支持 |
wx.setStorage | 将数据存储在本地缓存中指定的 key 中 | 支持 |
wx.revokeBufferURL | 根据 URL 销毁存在内存中的数据 | 支持 |
wx.removeStorageSync | wx.removeStorage 的同步版本 | 支持 |
wx.removeStorage | 从本地缓存中移除指定 key | 支持 |
wx.getStorageSync | 从本地缓存中同步获取指定 key 的内容 | 支持 |
wx.getStorageInfoSync | wx.getStorageInfo 的同步版本 | 支持 |
wx.getStorageInfo | 异步获取当前storage的相关信息 | 支持 |
wx.getStorage | 从本地缓存中异步获取指定 key 的内容 | 支持 |
wx.createBufferURL | 根据传入的 buffer 创建一个唯一的 URL 存在内存中 | 支持 |
wx.clearStorageSync | wx.clearStorage 的同步版本 | 支持 |
wx.clearStorage | 清理本地数据缓存 | 支持 |
wx.batchSetStorageSync | 将数据批量存储在本地缓存中指定的 key 中 | 支持 |
wx.batchSetStorage | 将数据批量存储在本地缓存中指定的 key 中 | 支持 |
wx.batchGetStorageSync | 从本地缓存中同步批量获取指定 key 的内容 | 支持 |
wx.batchGetStorage | 从本地缓存中异步批量获取指定 key 的内容 | 支持 |
# 周期性更新
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.setBackgroundFetchToken | 设置自定义登录态,在周期性拉取数据时带上,便于第三方服务器验证请求合法性 | 否[2] |
wx.onBackgroundFetchData | 监听收到 backgroundFetch 数据事件 | 否[2] |
wx.getBackgroundFetchToken | 获取设置过的自定义登录态 | 否[2] |
wx.getBackgroundFetchData | 拉取 backgroundFetch 客户端缓存数据 | 否[2] |
# 缓存管理器
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.createCacheManager | 创建缓存管理器 | 否[2] |
# 数据分析
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.reportMonitor | 自定义业务数据监控上报接口 | 否[2] |
wx.reportEvent | 事件上报 | 否[2] |
wx.reportAnalytics | 自定义分析数据上报接口 | 否[2] |
wx.getExptInfoSync | 给定实验参数数组,获取对应的实验参数值 | 否[2] |
# 画布
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.createOffscreenCanvas | 创建离屏 canvas 实例 | 是 |
wx.createCanvasContext | 创建 canvas 的绘图上下文 CanvasContext(CanvasContext对象 | 是 |
wx.canvasToTempFilePath | 把当前画布指定区域的内容导出生成指定大小的图片 | 是 |
wx.canvasPutImageData | 将像素数据绘制到画布 | 是 |
wx.canvasGetImageData | 获取 canvas 区域隐含的像素数据 | 是 |
# 媒体
# 地图
- 如下支持的地图相关接口能力,需配置 LBS SDK ,且需前往腾讯位置服务平台注册开发者账号并创建应用 Key,详情可查看位置服务使用指南
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.createMapContext | 创建 map上下文 MapContext对象 | 是[2] |
# MapContext
# 图片
- 图片、音视频、相机、相册、录音等多媒体相关 JSAPI 依赖扩展 SDK "Media SDK" ,开发者需在项目中的
project.miniapp.json
配置勾选对应的 SDK 方可生效; - 注意:在 iOS SDK >= 1.3.11 以及 开发者工具版本 >= 1.06.2405102,iOS Media SDK 已经被拆分为:Audio SDK、Video SDK、Image SDK、Camera SDK,开发者需按需勾选
- wx.previewMedia:iOS SDK >= 1.5.2 且需勾选 Video SDK;Android 尚未支持
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.saveImageToPhotosAlbum | 保存图片到系统相册 | 是 |
wx.previewMedia | 预览图片和视频 | iOS 已支持,但参数有差异 |
wx.previewImage | 在新页面中全屏预览图片 | 是[2],长按识别功能暂时还不支持 |
wx.getImageInfo | 获取图片信息 | 是 |
wx.editImage | 编辑图片接口 | 否[2] |
wx.cropImage | 裁剪图片接口 | 否[2] |
wx.compressImage | 压缩图片接口,可选压缩质量 | 是 |
wx.chooseMessageFile | 从客户端会话选择文件 | 否[4],可使用wx.miniapp.chooseFile代替 |
wx.chooseImage | 从本地相册选择图片或使用相机拍照 | 是,已不维护;建议使用wx.chooseMedia |
# 视频
- 图片、音视频、相机、相册、录音等多媒体相关 JSAPI 依赖扩展 SDK "Media SDK" ,开发者需在项目中的
project.miniapp.json
配置勾选对应的 SDK 方可生效; - 注意:在 iOS SDK >= 1.3.11 以及 开发者工具版本 >= 1.06.2405102,iOS Media SDK 已经被拆分为:Audio SDK、Video SDK、Image SDK、Camera SDK,开发者需按需勾选
- 补充:iOS 应用中,如果使用
wx.chooseMedia
则必须勾选 Video SDK - wx.compressVideo:Android SDK >= 1.4.13;iOS SDK >= 1.5.4
- wx.getVideoInfo:iOS SDK >= 1.5.4;
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.saveVideoToPhotosAlbum | 保存视频到系统相册 | 是 |
wx.getVideoInfo | 获取视频详细信息 | 是 |
wx.createVideoContext | 创建 video(video上下文 VideoContext(VideoContext对象 | 是 |
wx.compressVideo | 压缩视频接口 | 是 |
wx.chooseVideo | 拍摄视频或从手机相册中选视频 | 是 |
wx.chooseMedia | 拍摄或从手机相册中选择图片或视频(需查看接口文档进行权限配置方可使用) | 是[2] |
# 音频
- 图片、音视频、相机、相册、录音等多媒体相关 JSAPI 依赖扩展 SDK "Media SDK" ,开发者需在项目中的
project.miniapp.json
配置勾选对应的 SDK 方可生效; - 注意:在 iOS SDK >= 1.3.11 以及 开发者工具版本 >= 1.06.2405102,iOS Media SDK 已经被拆分为:Audio SDK、Video SDK、Image SDK、Camera SDK,开发者需按需勾选
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.stopVoice | 结束播放语音 | 是 |
wx.setInnerAudioOption | 设置 InnerAudioContext 的播放选项 | 是 |
wx.playVoice | 开始播放语音 | 是 |
wx.pauseVoice | 暂停正在播放的语音 | 是 |
wx.getAvailableAudioSources | 获取当前支持的音频输入源 | 是 |
wx.createWebAudioContext | 创建 WebAudioContext | 是 |
wx.createMediaAudioPlayer | 创建媒体音频播放器对象 MediaAudioPlayer 对象,可用于播放视频解码器 VideoDecoder 输出的音频 | 是 |
wx.createInnerAudioContext | 创建内部 audio 上下文 InnerAudioContext 对象 | 是 |
wx.createAudioContext | 创建 audio 上下文 AudioContext 对象 | 是 |
# 背景音频
- 图片、音视频、相机、相册、录音等多媒体相关 JSAPI 依赖扩展 SDK "Media SDK" ,开发者需在项目中的
project.miniapp.json
配置勾选对应的 SDK 方可生效; - 注意:在 iOS SDK >= 1.3.11 以及 开发者工具版本 >= 1.06.2405102,iOS Media SDK 已经被拆分为:Audio SDK、Video SDK、Image SDK、Camera SDK,开发者需按需勾选
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.stopBackgroundAudio | 停止播放音乐 | 是 |
wx.seekBackgroundAudio | 控制音乐播放进度 | 是 |
wx.playBackgroundAudio | 使用后台播放器播放音乐 | 是 |
wx.pauseBackgroundAudio | 暂停播放音乐 | 是 |
wx.onBackgroundAudioStop | 监听音乐停止事件 | 是 |
wx.onBackgroundAudioPlay | 监听音乐播放事件 | 是 |
wx.onBackgroundAudioPause | 监听音乐暂停事件 | 是 |
wx.getBackgroundAudioPlayerState | 获取后台音乐播放状态 | 是 |
wx.getBackgroundAudioManager | 获取全局唯一的背景音频管理器 | 是 |
# 实时音视频
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.createLivePusherContext | 创建 live-pusher 上下文 LivePusherContext 对象 | 否[4] |
wx.createLivePlayerContext | 创建 live-player 上下文 LivePlayerContext 对象 | 否[4] |
# 录音
- 图片、音视频、相机、相册、录音等多媒体相关 JSAPI 依赖扩展 SDK "Media SDK" ,开发者需在项目中的
project.miniapp.json
配置勾选对应的 "Media SDK" 方可生效; - RecorderManager 相关接口还需要在
project.miniapp.json
配置下列权限方可生效- Android:「Android 权限描述配置」 -> 「允许应用程序录制音频」
- iOS:「隐私信息访问许可描述」 -> 「麦克风」
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.stopRecord | 停止录音 | 是 |
wx.startRecord | 开始录音 | 是 |
wx.getRecorderManager | 获取全局唯一的录音管理器 RecorderManager | 是 |
# 相机
- 图片、音视频、相机、相册、录音等多媒体相关 JSAPI 依赖扩展 SDK "Media SDK" ,开发者需在项目中的
project.miniapp.json
配置勾选对应的 SDK 方可生效;
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.createCameraContext | 创建 camera 上下文 CameraContext 对象 | 是 |
# 富文本
名称 | 功能说明 | 是否支持 |
---|---|---|
EditorContext | EditorContext 实例 | 是 |
# EditorContext
名称 | 功能说明 | 是否支持 |
---|---|---|
EditorContext.blur | 编辑器失焦,同时收起键盘 | 是 |
EditorContext.clear | 清空编辑器内容 | 是 |
EditorContext.format | 修改样式 | 是 |
EditorContext.getContents | 获取编辑器内容 | 是 |
EditorContext.getSelectionText | 获取编辑器已选区域内的纯文本内容 | 是 |
EditorContext.insertDivider | 插入分割线 | 是 |
EditorContext.insertImage | 插入图片 | 是 |
EditorContext.insertText | 覆盖当前选区,设置一段文本 | 是 |
EditorContext.redo | 恢复 | 是 |
EditorContext.removeFormat | 清除当前选区的样式 | 是 |
EditorContext.scrollIntoView | 使得编辑器光标处滚动到窗口可视区域内 | 是 |
EditorContext.setContents | 初始化编辑器内容,html和delta同时存在时仅delta生效 | 是 |
EditorContext.undo | 撤销 | 是 |
# 音视频合成
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.createMediaContainer | 创建音视频处理容器,最终可将容器中的轨道合成一个视频 | 否[2] |
# 实时语音
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.updateVoIPChatMuteConfig | 更新实时语音静音设置 | 否[4] |
wx.subscribeVoIPVideoMembers | 订阅视频画面成员 | 否[4] |
wx.setEnable1v1Chat | 开启双人通话 | 否[4] |
wx.onVoIPVideoMembersChanged | 监听实时语音通话成员视频状态变化事件 | 否[4] |
wx.onVoIPChatStateChanged | 监听房间状态变化事件 | 否[4] |
wx.onVoIPChatSpeakersChanged | 监听实时语音通话成员通话状态变化事件 | 否[4] |
wx.onVoIPChatMembersChanged | 监听实时语音通话成员在线状态变化事件 | 否[4] |
wx.onVoIPChatInterrupted | 监听被动断开实时语音通话事件 | 否[4] |
wx.offVoIPVideoMembersChanged | 移除实时语音通话成员视频状态变化事件的监听函数 | 否[4] |
wx.offVoIPChatStateChanged | 移除房间状态变化事件的监听函数 | 否[4] |
wx.offVoIPChatSpeakersChanged | 移除实时语音通话成员通话状态变化事件的监听函数 | 否[4] |
wx.offVoIPChatMembersChanged | 移除实时语音通话成员在线状态变化事件的监听函数 | 否[4] |
wx.offVoIPChatInterrupted | 移除被动断开实时语音通话事件的监听函数 | 否[4] |
wx.joinVoIPChat | 加入 (创建) 实时语音通话 | 否[4] |
wx.join1v1Chat | 加入(创建)双人通话 | 否[4] |
wx.exitVoIPChat | 退出(销毁)实时语音通话 | 否[4] |
# 画面录制器
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.createMediaRecorder | 创建 WebGL 画面录制器,可逐帧录制在 WebGL 上渲染的画面并导出视频文件 | 否[2] |
# 视频解码器
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.createVideoDecoder | 创建视频解码器,可逐帧获取解码后的数据 | 否[2] |
# 位置
- 如下支持的位置相关接口能力,需配置 LBS SDK ,且需前往腾讯位置服务平台注册开发者账号并创建应用 Key,详情可查看位置服务使用指南
wx.startLocationUpdateBackground
在 iOS 应用中使用前,需前往project.miniapp.json
开启 「Location updates of Background Modes」,并且还需要填写对应的隐私信息许可描述,如下图
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.stopLocationUpdate | 关闭监听实时位置变化,前后台都停止消息接收 | 是 |
wx.startLocationUpdateBackground | 开启小程序进入前后台时均接收位置消息,需引导用户开启授权 | 是 |
wx.startLocationUpdate | 开启小程序进入前台时接收位置消息 | 是 |
wx.openLocation | 使用微信内置地图查看位置 | 是 |
wx.onLocationChangeError | 监听持续定位接口返回失败时触发 | 是 |
wx.onLocationChange | 监听实时地理位置变化事件,需结合 wx.startLocationUpdateBackground、wx.startLocationUpdate 使用 | 是 |
wx.offLocationChangeError | 移除持续定位接口返回失败时触发 | 是 |
wx.offLocationChange | 移除实时地理位置变化事件的监听函数 | 是 |
wx.getLocation | 获取当前的地理位置、速度 | 是 |
wx.getFuzzyLocation | 获取当前的模糊地理位置 | 否[2] |
wx.choosePoi | 打开POI列表选择位置,支持模糊定位(精确到市)和精确定位混选 | 否[2] |
wx.chooseLocation | 打开地图选择位置 | 是[2] |
# 文件
wx.openDocument 补充说明
- 在 Android 端使用该接口实现在应用内部预览,需在 project.miniapp.json 中将 XWEB 扩展 SDK 勾上,并且 Android SDK 版本需大于或等于 1.4.10
- 此外该接口在 Android 端使用时新增入参
openInternal
用于控制是否应用内打开文件(仅当开启xweb时生效);该值的枚举值为true
和false
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.saveFileToDisk | 保存文件系统的文件到用户磁盘,仅在 PC 端支持 | 是 |
wx.openDocument | 新开页面打开文档 | 是 |
wx.getFileSystemManager | 获取全局唯一的文件管理器 | 是 |
wx.saveFile | 保存文件到本地。wx.saveFile 即将废弃,请使用 wx.getFileSystemManager().saveFile | 是 |
wx.removeSavedFile | 删除本地缓存文件。wx.removeSavedFile 即将废弃,请使用 wx.getFileSystemManager().removeSavedFile | 是 |
wx.getSavedFileList | 获取该小程序下已保存的本地缓存文件列表。wx.getSavedFileList 即将废弃,请使用 wx.getFileSystemManager().getSavedFileList | 是 |
wx.getSavedFileInfo | 获取本地文件的文件信息。wx.getSavedFileInfo 即将废弃,请使用 wx.getFileSystemManager().getFileInfo | 是 |
wx.getFileInfo | 获取文件信息。wx.getFileInfo 即将废弃,请使用 wx.getFileSystemManager().getFileInfo | 是 |
# 蓝牙-通用
蓝牙相关 JSAPI 依赖扩展 SDK "Bluetooth SDK" ,开发者需在项目中的
project.miniapp.json
配置勾选对应的 SDK 方可生效;系统要求,手机上需要开启地理位置权限后才可以搜索到蓝牙
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.stopBluetoothDevicesDiscovery | 停止搜寻附近的蓝牙外围设备 | 是 |
wx.startBluetoothDevicesDiscovery | 开始搜寻附近的蓝牙外围设备 | 是 |
wx.openBluetoothAdapter | 初始化蓝牙模块 | 是 |
wx.onBluetoothDeviceFound | 监听搜索到新设备的事件 | 是 |
wx.onBluetoothAdapterStateChange | 监听蓝牙适配器状态变化事件 | 是 |
wx.offBluetoothDeviceFound | 移除搜索到新设备的事件的监听函数 | 是 |
wx.offBluetoothAdapterStateChange | 移除蓝牙适配器状态变化事件的监听函数 | 是 |
wx.makeBluetoothPair | 蓝牙配对接口,仅安卓支持 | 是 |
wx.isBluetoothDevicePaired | 查询蓝牙设备是否配对,仅安卓支持 | 是 |
wx.getConnectedBluetoothDevices | 根据主服务 UUID 获取已连接的蓝牙设备 | 是 |
wx.getBluetoothDevices | 获取在蓝牙模块生效期间所有搜索到的蓝牙设备 | 是 |
wx.getBluetoothAdapterState | 获取本机蓝牙适配器状态 | 是 |
wx.closeBluetoothAdapter | 关闭蓝牙模块 | 是 |
# 蓝牙-低功耗中心设备
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.writeBLECharacteristicValue | 向蓝牙低功耗设备特征值中写入二进制数据 | 是 |
wx.setBLEMTU | 协商设置蓝牙低功耗的最大传输单元 (Maximum Transmission Unit, MTU) | 是 |
wx.readBLECharacteristicValue | 读取蓝牙低功耗设备特征值的二进制数据 | 是 |
wx.onBLEMTUChange | 监听蓝牙低功耗的最大传输单元变化事件(仅安卓触发) | 是 |
wx.onBLEConnectionStateChange | 监听蓝牙低功耗连接状态改变事件 | 是 |
wx.onBLECharacteristicValueChange | 监听蓝牙低功耗设备的特征值变化事件 | 是 |
wx.offBLEMTUChange | 移除蓝牙低功耗的最大传输单元变化事件的监听函数 | 是 |
wx.offBLEConnectionStateChange | 移除蓝牙低功耗连接状态改变事件的监听函数 | 是 |
wx.offBLECharacteristicValueChange | 移除蓝牙低功耗设备的特征值变化事件的监听函数 | 是 |
wx.notifyBLECharacteristicValueChange | 启用蓝牙低功耗设备特征值变化时的 notify 功能,订阅特征 | 是 |
wx.getBLEMTU | 获取蓝牙低功耗的最大传输单元 | 是 |
wx.getBLEDeviceServices | 获取蓝牙低功耗设备所有服务 (service) | 是 |
wx.getBLEDeviceRSSI | 获取蓝牙低功耗设备的信号强度 (Received Signal Strength Indication, RSSI) | 是 |
wx.getBLEDeviceCharacteristics | 获取蓝牙低功耗设备某个服务中所有特征 (characteristic) | 是 |
wx.createBLEConnection | 连接蓝牙低功耗设备 | 是 |
wx.closeBLEConnection | 断开与蓝牙低功耗设备的连接 | 是 |
# 蓝牙-低功耗外围设备
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.onBLEPeripheralConnectionStateChanged | 监听当前外围设备被连接或断开连接事件 | 是 |
wx.offBLEPeripheralConnectionStateChanged | 移除当前外围设备被连接或断开连接事件的监听函数 | 是 |
wx.createBLEPeripheralServer | 建立本地作为蓝牙低功耗外围设备的服务端,可创建多个 | 是 |
# 蓝牙-信标(Beacon)
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.stopBeaconDiscovery | 停止搜索附近的 Beacon 设备 | 是 |
wx.startBeaconDiscovery | 开始搜索附近的 Beacon 设备 | 是 |
wx.onBeaconUpdate | 监听 Beacon 设备更新事件,仅能注册一个监听 | 是 |
wx.onBeaconServiceChange | 监听 Beacon 服务状态变化事件,仅能注册一个监听 | 是 |
wx.offBeaconUpdate | 移除 Beacon 设备更新事件的监听函数 | 是 |
wx.offBeaconServiceChange | 移除 Beacon 服务状态变化事件的监听函数 | 是 |
wx.getBeacons | 获取所有已搜索到的 Beacon 设备 | 是 |
BeaconInfo | Beacon 设备 | 是 |
# 近场通讯(NFC)
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.getNFCAdapter | 获取 NFC 实例 | 否[2] |
# Wi-Fi
- 下方 WIFI 相关的 JSAPI 依赖扩展 SDK "Network SDK" ,开发者需在项目中的
project.miniapp.json
配置勾选对应的 SDK 方可生效; - 注意:Android 和 iOS 的扩展 SDK 有所区别,详情查看
project.miniapp.json
- 注意:iOS 13及以上系统,获取当前连接的Wi-Fi信息需要先获取系统定位权限,因此在iOS 13及以上系统使用此接口时,需要先调用
wx.getLocation
,触发定位权限申请的弹窗,待用户授权后才可以正常获取到 wifi 信息
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.stopWifi | 关闭 Wi-Fi 模块 | 是 |
wx.startWifi | 初始化 Wi-Fi 模块 | 是 |
wx.setWifiList | 设置 wifiList 中 AP 的相关信息 | 是 |
wx.onWifiConnected | 监听连接上 Wi-Fi 的事件 | 是 |
wx.offWifiConnected | 移除连接上 Wi-Fi 的事件的监听函数 | 是 |
wx.onGetWifiList | 监听获取到 Wi-Fi 列表数据事件 | 是 |
wx.offGetWifiList | 移除获取到 Wi-Fi 列表数据事件的监听函数 | 是 |
wx.onWifiConnectedWithPartialInfo | 监听连接上 Wi-Fi 的事件 | 否[2] |
wx.offWifiConnectedWithPartialInfo | 移除连接上 Wi-Fi 的事件的监听函数 | 否[2] |
wx.getWifiList | 请求获取 Wi-Fi 列表 | 是 |
wx.getConnectedWifi | 获取已连接中的 Wi-Fi 信息 | 是 |
wx.connectWifi | 连接 Wi-Fi | 是 |
WifiInfo | Wifi 信息 | 是 |
# 日历
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.addPhoneRepeatCalendar | 向系统日历添加重复事件 | 是 |
wx.addPhoneCalendar | 向系统日历添加事件 | 是 |
# 联系人
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.chooseContact | 拉起手机通讯录,选择联系人 | 是 |
wx.addPhoneContact | 添加手机通讯录联系人 | 是 |
# 无障碍
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.checkIsOpenAccessibility | 检测是否开启视觉无障碍功能 | 否[4] |
# 电量
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.getBatteryInfoSync | wx.getBatteryInfo 的同步版本 | 是 |
wx.getBatteryInfo | 获取设备电量 | 是 |
# 剪贴板
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.setClipboardData | 设置系统剪贴板的内容 | 是 |
wx.getClipboardData | 获取系统剪贴板的内容 | 是 |
# NFC 主机卡模拟
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.stopHCE | 关闭 NFC 模块 | 否[2] |
wx.startHCE | 初始化 NFC 模块 | 否[2] |
wx.sendHCEMessage | 发送 NFC 消息 | 否[2] |
wx.onHCEMessage | 监听接收 NFC 设备消息事件 | 否[2] |
wx.offHCEMessage | 移除接收 NFC 设备消息事件的监听函数 | 否[2] |
wx.getHCEState | 判断当前设备是否支持 HCE 能力 | 否[2] |
# 网络
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.onNetworkWeakChange | 监听弱网状态变化事件 | 是 |
wx.onNetworkStatusChange | 监听网络状态变化事件 | 是 |
wx.offNetworkWeakChange | 移除弱网状态变化事件的监听函数 | 是 |
wx.offNetworkStatusChange | 移除网络状态变化事件的监听函数 | 是 |
wx.getNetworkType | 获取网络类型 | 是 |
wx.getLocalIPAddress | 获取局域网IP地址 | 否[2] |
# 加密
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.getRandomValues | 获取密码学安全随机数 | 是 |
# 屏幕
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.setVisualEffectOnCapture | 设置截屏/录屏时屏幕表现,仅支持在 Android 端调用 | 否[2] |
wx.setScreenBrightness | 设置屏幕亮度 | 是 |
wx.setKeepScreenOn | 设置是否保持常亮状态 | 是 |
wx.onUserCaptureScreen | 监听用户主动截屏事件 | 是 |
wx.onScreenRecordingStateChanged | 监听用户录屏事件 | 是 |
wx.offUserCaptureScreen | 用户主动截屏事件 | 是 |
wx.offScreenRecordingStateChanged | 移除用户录屏事件的监听函数 | 是 |
wx.getScreenRecordingState | 查询用户是否在录屏 | 是 |
wx.getScreenBrightness | 获取屏幕亮度 | 是 |
# 键盘
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.onKeyboardHeightChange | 监听键盘高度变化事件 | 是 |
wx.offKeyboardHeightChange | 移除键盘高度变化事件的监听函数 | 是 |
wx.hideKeyboard | 在input、textarea等focus拉起键盘之后,手动调用此接口收起键盘 | 是 |
wx.getSelectedTextRange | 在input、textarea等focus之后,获取输入框的光标位置 | 是 |
# 电话
注:此接口在 iOS 多端应用中使用需前往project.miniapp.json
勾选「Others SDK」
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.makePhoneCall | 拨打电话 | 是 |
# 加速计
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.stopAccelerometer | 停止监听加速度数据 | 是 |
wx.startAccelerometer | 开始监听加速度数据 | 是 |
wx.onAccelerometerChange | 监听加速度数据事件 | 是 |
wx.offAccelerometerChange | 移除加速度数据事件的监听函数 | 是 |
# 罗盘
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.stopCompass | 停止监听罗盘数据 | 是 |
wx.startCompass | 开始监听罗盘数据 | 是 |
wx.onCompassChange | 监听罗盘数据变化事件 | 是 |
wx.offCompassChange | 移除罗盘数据变化事件的监听函数 | 是 |
# 设备方向
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.stopDeviceMotionListening | 停止监听设备方向的变化 | 是 |
wx.startDeviceMotionListening | 开始监听设备方向的变化 | 是 |
wx.onDeviceMotionChange | 监听设备方向变化事件 | 是 |
wx.offDeviceMotionChange | 移除设备方向变化事件的监听函数 | 是 |
# 内存
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.onMemoryWarning | 监听内存不足告警事件 | 是 |
wx.offMemoryWarning | 移除内存不足告警事件的监听函数 | 是 |
# 陀螺仪
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.stopGyroscope | 停止监听陀螺仪数据 | 是 |
wx.startGyroscope | 开始监听陀螺仪数据 | 是 |
wx.onGyroscopeChange | 监听陀螺仪数据变化事件 | 是 |
# 扫码
注:
- 此接口在 iOS 多端应用中使用需前往project.miniapp.json勾选「Others SDK」
- 如果是iOS,则需要在project.miniapp.json中配置“NSCameraUsageDescription”
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.scanCode | 调起客户端扫码界面进行扫码 | 是 |
# 短信
- 此接口在 iOS 多端应用中使用需前往project.miniapp.json勾选「Others SDK」
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.sendSms | 拉起手机发送短信界面 | 支持 |
# 振动
注:此接口在 iOS 多端应用中使用需前往project.miniapp.json勾选「Others SDK」
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.vibrateShort | 使手机发生较短时间的振动(15 ms) | 是 |
wx.vibrateLong | 使手机发生较长时间的振动(400 ms) | 是 |
# AI
# 视觉算法
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.isVKSupport | 判断支持版本 | 否[4] |
wx.createVKSession | 创建 vision kit 会话对象 | 否[4] |
# 人脸检测
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.stopFaceDetect | 停止人脸检测 | 否[4] |
wx.initFaceDetect | 初始化人脸检测 | 否[4] |
wx.faceDetect | 人脸检测,使用前需要通过 wx.initFaceDetect 进行一次初始化,推荐使用相机接口返回的帧数据 | 否[4] |
# Worker
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.createWorker | 创建一个 Worker 线程 | 是 |
# WXML
wx.createSelectorQuery 在 Android端需使用需前往 project.miniapp.json 勾选「XWEB SDK」
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.createSelectorQuery | 返回一个 SelectorQuery 对象实例 | 是 |
wx.createIntersectionObserver | 创建并返回一个 IntersectionObserver 对象实例 | 是 |
# 第三方平台
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.getExtConfigSync | wx.getExtConfig 的同步版本 | 否[2] |
wx.getExtConfig | 获取 ext.json 自定义的数据字段 | 否[2] |
# 广告
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.createRewardedVideoAd | 创建激励视频广告组件 | 是,详情可查看腾讯优量汇广告使用指南 |
wx.createInterstitialAd | 创建插屏广告组件 | 否[2] |
# 开放接口
# 登录
名称 | 功能说明 | 是否支持 | 备注 |
---|---|---|---|
wx.pluginLogin | 该接口仅在小程序插件中可调用,调用接口获得插件用户标志凭证(code) | 否[2] | |
wx.login | 调用接口获取登录凭证(code) | 是[2] | 需替换新接口,点击查看接口详情 |
wx.checkSession | 检查登录态是否过期 | 否[1] | 使用多端身份管理 |
# 账号信息
- 与小程序模式下返回的信息有差异,详情看接口文档
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.getAccountInfoSync | 获取当前账号信息 | 是 |
# 用户信息
- 在 App 中开发者可以通过对接“微信登录”的接口获取用户微信的头像和昵称,详情可查看wx.miniapp.login
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.getUserProfile | 获取用户信息 | 否[2] |
wx.getUserInfo | 获取用户信息 | 否[2] |
# 授权
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.authorizeForMiniProgram | 仅小程序插件中能调用该接口,用法同 wx.authorize | 否[4] |
wx.authorize | 提前向用户发起授权请求 | 否[4] |
# 设置
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.openSetting | 调起客户端小程序设置界面,返回用户设置的操作结果 | 否[4] |
wx.getSetting | 获取用户的当前设置 | 否[4] |
AuthSetting | 用户授权设置信息,详情参考权限 | 否[4] |
SubscriptionsSetting | 订阅消息设置 | 否[4] |
# 收货地址
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.chooseAddress | 获取用户收货地址 | 否[4] |
# 卡券
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.openCard | 查看微信卡包中的卡券 | 否[4] |
wx.addCard | 批量添加卡券 | 否[4] |
# 发票
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.chooseInvoiceTitle | 选择用户的发票抬头 | 否[4] |
wx.chooseInvoice | 选择用户已有的发票 | 否[4] |
# 生物认证
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.startSoterAuthentication | 开始 SOTER 生物认证 | 否[4] |
wx.checkIsSupportSoterAuthentication | 获取本机支持的 SOTER 生物认证方式 | 否[4] |
wx.checkIsSoterEnrolledInDevice | 获取设备内是否录入如指纹等生物信息的接口 | 否[4] |
# 微信运动
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.shareToWeRun | 分享数据到微信运动 | 否[4] |
wx.getWeRunData | 获取用户过去三十天微信运动步数 | 否[4] |
# 订阅消息
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.requestSubscribeMessage | 调起客户端小程序订阅消息界面,返回用户订阅消息的操作结果 | 否[4] |
wx.requestSubscribeDeviceMessage | 订阅设备消息接口,调用后弹出授权框,用户同意后会允许开发者给用户发送订阅模版消息 | 否[4] |
# 微信红包
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.showRedPackage | 拉取h5领取红包封面页 | 否[4] |
# 收藏
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.addVideoToFavorites | 收藏视频 | 否[4] |
wx.addFileToFavorites | 收藏文件 | 否[4] |
# 车牌
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.chooseLicensePlate | 选择车牌号 | 否[4] |
# 视频号
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.reserveChannelsLive | 预约视频号直播 | 否[4] |
wx.openChannelsUserProfile | 打开视频号主页 | 否[4] |
wx.openChannelsLive | 打开视频号直播 | 否[4] |
wx.openChannelsEvent | 打开视频号活动页 | 否[4] |
wx.openChannelsActivity | 打开视频号视频 | 否[4] |
wx.getChannelsShareKey | 获取视频号直播卡片/视频卡片的分享来源,仅当卡片携带了分享信息、同时用户已授权该小程序获取视频号分享信息且启动场景值为 1177、1184、1195、1208 时可用 | 否[4] |
wx.getChannelsLiveNoticeInfo | 获取视频号直播预告信息 | 否[4] |
wx.getChannelsLiveInfo | 获取视频号直播信息 | 否[4] |
# 微信群
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.getGroupEnterInfo | 获取微信群聊场景下的小程序启动信息 | 不支持 |
# 微信客服
名称 | 功能说明 | 是否支持 |
---|---|---|
wx.openCustomerServiceChat | 打开微信客服,页面产生点击事件(例如 button 上 bindtap 的回调中)后才可调用 | 不支持;可使用 wx.miniapp.openCustomerServiceChat 替代 |