wx

立即使用

isInstalled shareText shareImage shareMusic shareVideo shareWebpage shareProgram launchMiniProgram subscribeMsg auth getToken getUserInfo refreshToken shareMutableImg

概述

此模块已停止维护，最新模块请转至wxPlus

微信简介

微信 (WeChat) 是腾讯公司于2011年1月21日推出的一个为智能终端提供即时通讯服务的免费应用程序，微信支持跨通信运营商、跨操作系统平台通过网络快速发送免费（需消耗少量网络流量）语音短信、视频、图片和文字。截止到2016年第一季度，微信已经覆盖中国 90% 以上的智能手机，月活跃用户达到 5.49 亿，用户覆盖 200 多个国家、超过 20 种语言。此外，各品牌的微信公众账号总数已经超过 800 万个，移动应用对接数量超过 85000 个，微信支付用户则达到了 4 亿左右。

微信提供公众平台、朋友圈、消息推送等功能，用户可以通过“摇一摇”、“搜索号码”、“附近的人”、扫二维码方式添加好友和关注公众平台，同时微信将内容分享给好友以及将用户看到的精彩内容分享到微信朋友圈。

微信功能服务

  • 朋友圈：用户可以通过朋友圈发表文字和图片，同时可通过其他软件将文章或者音乐分享到朋友圈。用户可以对好友新发的照片进行“评论”或“赞”，用户只能看相同好友的评论或赞。
  • 语音提醒：用户可以通过语音告诉Ta提醒打电话或是查看邮件。[19]
  • 通讯录安全助手：开启后可上传手机通讯录至服务器，也可将之前上传的通讯录下载至手机。[24]
  • QQ邮箱提醒：开启后可接收来自QQ邮件的邮件，收到邮件后可直接回复或转发。[24]
  • 私信助手：开启后可接收来自QQ微博的私信，收到私信后可直接回复。[24]
  • 漂流瓶：通过扔瓶子和捞瓶子来匿名交友。
  • 查看附近的人：微信将会根据您的地理位置找到在用户附近同样开启本功能的人。（LBS功能）
  • 语音记事本：可以进行语音速记，还支持视频、图片、文字记事。
  • 微信摇一摇：是微信推出的一个随机交友应用，通过摇手机或点击按钮模拟摇一摇，可以匹配到同一时段触发该功能的微信用户，从而增加用户间的互动和微信粘度。
  • 群发助手：通过群发助手把消息发给多个人。
  • 微博阅读：可以通过微信来浏览腾讯微博内容。
  • 流量查询：微信自身带有流量统计的功能，可以在设置里随时查看微信的流量动态。
  • 游戏中心：可以进入微信玩游戏（还可以和好友比高分）例如“飞机大战”。
  • 微信公众平台：通过这一平台，个人和企业都可以打造一个微信的公众号，可以群发文字、图片、语音三个类别的内容。目前有200万公众账号。
  • 微信在IPhone、Android、Windows Phone、Symbian、BlackBerry等手机平台上都可以使用，并提供有多种语言界面。

wx 模块概述

本模块封装了微信开放平台的原生 SDK，集成了微信登录、微信分享功能；可用于实现微信账号登录，分享内容到朋友圈或好友、收藏等功能；轻松、高效集成微信功能到自己的 app 内。使自己的 app 和微信实现无缝链接。

不能同时使用的模块：pingpp

模块使用攻略

使用之前须从微信开放平台申请开发者账号并创建应用，获取 appid 和 secret。wx 模块优化了 weiXin 模块的登录、分享功能，不包含微信支付功能。

微信平台接入流程参考微信平台接入文档

使用此模块之前建议先配置 config.xml 文件，配置完毕，需通过云端编译生效，配置方法如下：

  • 名称：wx
  • 参数：urlScheme、apiKey、apiSecret
  • 配置示例:
  1.   <feature name="wx">
  2.     <param name="urlScheme" value="wxd0d84bbf23b4a0e4"/>
  3.     <param name="apiKey" value="wxd0d84bbf23b4a0e4"/>
  4.     <param name="apiSecret" value="a354f72aa1b4c2b8eaad137ac81434cd"/>
  5.   </feature>

  • 字段描述:

    urlScheme：（必须配置）用于实现应用间跳转及数据交换，本应用可以启动微信客户端，也可以从微信客户端跳回本应用。urlScheme 的 value 值是从微信开放平台获取的 appid。appid 申请方法参考微信开放平台接入文档。

    apiKey：（必须配置）从微信开放平台获取的 appid，值与 urlScheme 相同。appid 申请方法参考微信开放平台接入文档。

    apiSecret：从微信开放平台获取的 secret。获取 accessToken 时需要配置此项。appid 申请方法参考微信开放平台接入文档。

Android 系统平台上需注意事项请参考微信集成注意事项 wx - 图1 wx - 图2

实例widget下载地址

模块接口

isInstalled

判断当前设备是否安装微信客户端

isInstalled(callback(ret, err))

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     installed: true      //布尔型；true||false，当前设备是否安装微信客户端
  3. }

err：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     code: 0     //数字类型；
  3.                 //错误码：
  4.                 //-1（未知错误），
  5.                 //0（成功）
  6. }

示例代码

  1. var wx = api.require('wx');
  2. wx.isInstalled(function(ret, err) {
  3.     if (ret.installed) {
  4.         alert("当前设备已安装微信客户端");
  5.     } else {
  6.         alert('当前设备未安装微信客户端');
  7.     }
  8. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

shareText

分享文本内容

shareText({params}, callback(ret, err))

params

apiKey：

  • 类型：字符串
  • 描述：（可选项）从微信开放平台获取的 appid，若不传则从当前 widget 的 config.xml 中读取。

scene：

  • 类型：字符串
  • 描述：（可选项）场景
  • 默认值：timeline
  • 取值范围：
    • timeline（朋友圈）

text：

  • 类型：字符串
  • 描述：分享的文本

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     status: true   //布尔型；true||false
  3. }

err：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     code: 0     //数字类型；
  3.                 //错误码：
  4.                 //-1（未知错误）
  5.                 //0（成功）
  6.                 //1（apiKey非法）
  7.                 //2（用户取消）
  8.                 //3（发送失败）
  9.                 //4（授权拒绝）
  10.                 //5（微信服务器返回的不支持错误）
  11.                 //7 (注册SDK失败)
  12. }

示例代码

  1. var wx = api.require('wx');
  2. wx.shareText({
  3.     apiKey: '',
  4.     scene: 'timeline',
  5.     text: '我分享的文本'
  6. }, function(ret, err) {
  7.     if (ret.status) {
  8.         alert('分享成功');
  9.     } else {
  10.         alert(err.code);
  11.     }
  12. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

shareImage

分享图片内容

shareImage({params}, callback(ret, err))

params

apiKey：

  • 类型：字符串
  • 描述：（可选项）从微信开放平台获取的 appid，若不传则从当前 widget 的 config.xml 中读取。

scene：

  • 类型：字符串
  • 描述：（可选项）场景
  • 默认值：timeline
  • 取值范围：
    • session（会话）
    • timeline（朋友圈）
    • favorite（收藏）

thumb：

  • 类型：字符串
  • 描述：缩略图片的地址，支持 fs://、widget:// 协议。大小不能超过32K，若 contentUrl 为本地图片地址则本参数忽略,需要路径包含图片格式后缀，否则如果原图片为非png格式，会分享失败

contentUrl：

  • 类型：字符串
  • 描述：分享图片的 url 地址（支持 fs://、widget://），长度不能超过10M，

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     status: true   //布尔型；true||false
  3. }

err：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     code: 0     //数字类型；
  3.                 //错误码：
  4.                 //-1（未知错误）
  5.                 //0（成功）
  6.                 //1（apiKey非法）
  7.                 //2（用户取消）
  8.                 //3（发送失败）
  9.                 //4（授权拒绝）
  10.                 //5（微信服务器返回的不支持错误）
  11.                 //7 (注册SDK失败)
  12. }

示例代码

  1. var wx = api.require('wx');
  2. wx.shareImage({
  3.     apiKey: '',
  4.     scene: 'session',
  5.     thumb: 'widget://a.jpg',
  6.     contentUrl: 'widget://b.jpg'
  7. }, function(ret, err) {
  8.     if (ret.status) {
  9.         alert('分享成功');
  10.     } else {
  11.         alert(err.code);
  12.     }
  13. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

shareMusic

分享网络音频资源

shareMusic({params}, callback(ret, err))

params

apiKey：

  • 类型：字符串
  • 描述：（可选项）从微信开放平台获取的 appid，若不传则从当前 widget 的 config.xml 中读取。

scene：

  • 类型：字符串
  • 描述：（可选项）场景
  • 默认值：timeline
  • 取值范围：
    • session（会话）
    • timeline（朋友圈）
    • favorite（收藏）

title：

  • 类型：字符串
  • 描述：（可选项）分享网络音频的标题。

description：

  • 类型：字符串
  • 描述：（可选项）分享网络音频的描述。

thumb：

  • 类型：字符串
  • 描述：（可选项）分享网络音频的缩略图地址，要求本地路径（fs://、widget://）大小不能超过32K,需要路径包含图片格式后缀，否则如果原图片为非png格式，会分享失败

musicDataUrl：

  • 类型：字符串
  • 描述：（可选项）分享的音频数据 url 地址，长度不能超过10k。

contentUrl：

  • 类型：字符串
  • 描述：分享网络音频的 url 地址，长度不能超过10k。

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     status: true   //布尔型；true||false
  3. }

err：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     code: 0     //数字类型；
  3.                 //错误码：
  4.                 //-1（未知错误）
  5.                 //0（成功）
  6.                 //1（apiKey非法）
  7.                 //2（用户取消）
  8.                 //3（发送失败）
  9.                 //4（授权拒绝）
  10.                 //5（微信服务器返回的不支持错误）
  11.                 //7 (注册SDK失败)
  12. }

示例代码

  1. var wx = api.require('wx');
  2. wx.shareMusic({
  3.     apiKey: '',
  4.     scene: 'timeline',
  5.     title: '测试标题',
  6.     description: '分享内容的描述',
  7.     thumb: 'widget://a.jpg',
  8.     contentUrl: 'http://docs.apicloud.com/test/m.mp3'
  9. }, function(ret, err) {
  10.     if (ret.status) {
  11.         alert('分享成功');
  12.     } else {
  13.         alert(err.code);
  14.     }
  15. });

补充说明

仅支持分享网络音频资源

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

shareVideo

分享网络视频资源

shareVideo({params}, callback(ret, err))

params

apiKey：

  • 类型：字符串
  • 描述：（可选项）从微信开放平台获取的 appid，若不传则从当前 widget 的 config.xml 中读取。

scene：

  • 类型：字符串
  • 描述：（可选项）场景
  • 默认值：timeline
  • 取值范围：
    • session（会话）
    • timeline（朋友圈）
    • favorite（收藏）

title：

  • 类型：字符串
  • 描述：（可选项）分享网络视频的标题。

description：

  • 类型：字符串
  • 描述：（可选项）分享网络视频的描述。由于微信平台限制，对不同平台部分场景本参数无效

thumb：

  • 类型：字符串
  • 描述：（可选项）分享网络视频的缩略图地址，要求本地路径（fs://、widget://）大小不能超过32K,需要路径包含图片格式后缀，否则如果原图片为非png格式，会分享失败

contentUrl：

  • 类型：字符串
  • 描述：分享网络视频的 url 地址，长度不能超过10k。

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     status: true   //布尔型；true||false
  3. }

err：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     code: 0     //数字类型；
  3.                 //错误码：
  4.                 //-1（未知错误）
  5.                 //0（成功）
  6.                 //1（apiKey非法）
  7.                 //2（用户取消）
  8.                 //3（发送失败）
  9.                 //4（授权拒绝）
  10.                 //5（微信服务器返回的不支持错误）
  11.                 //7 (注册SDK失败)
  12. }

示例代码

  1. var wx = api.require('wx');
  2. wx.shareVideo({
  3.     apiKey: '',
  4.     scene: 'timeline',
  5.     title: '测试标题',
  6.     description: '分享内容的描述',
  7.     thumb: 'widget://a.jpg',
  8.     contentUrl: 'http://resource.apicloud.com/video/apicloud.mp4'
  9. }, function(ret, err) {
  10.     if (ret.status) {
  11.         alert('分享成功');
  12.     } else {
  13.         alert(err.code);
  14.     }
  15. });

补充说明

仅支持分享网络视频资源

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

shareWebpage

分享网页

特别注意：

在微信最新版本 6.7.2 上取消分享时 status 也返回 true，此为微信bug，等待微信修复更新。

shareWebpage({params}, callback(ret, err))

params

apiKey：

  • 类型：字符串
  • 描述：（可选项）从微信开放平台获取的 appid，若不传则从当前 widget 的 config.xml 中读取。

scene：

  • 类型：字符串
  • 描述：（可选项）场景
  • 默认值：timeline
  • 取值范围：
    • session（会话）
    • timeline（朋友圈）
    • favorite（收藏）

title：

  • 类型：字符串
  • 描述：（可选项）分享网页的标题

description：

  • 类型：字符串
  • 描述：（可选项）分享网页的描述。由于微信平台限制，对不同平台部分场景本参数无效

thumb：

  • 类型：字符串
  • 描述：（可选项）分享网页的缩略图地址，要求本地路径（fs://、widget://）大小不能超过32K,需要路径包含图片格式后缀，否则如果原图片为非png格式，会分享失败

contentUrl：

  • 类型：字符串
  • 描述：分享网页的 url 地址，长度不能超过10k。

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     status: true   //布尔型；true||false
  3. }

err：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     code: 0     //数字类型；
  3.                 //错误码：
  4.                 //-1（未知错误）
  5.                 //0（成功）
  6.                 //1（apiKey非法）
  7.                 //2（用户取消）
  8.                 //3（发送失败）
  9.                 //4（授权拒绝）
  10.                 //5（微信服务器返回的不支持错误）
  11.                 //7 (注册SDK失败)
  12. }

示例代码

  1. var wx = api.require('wx');
  2. wx.shareWebpage({
  3.     apiKey: '',
  4.     scene: 'timeline',
  5.     title: '测试标题',
  6.     description: '分享内容的描述',
  7.     thumb: 'widget://a.jpg',
  8.     contentUrl: 'http://apicloud.com'
  9. }, function(ret, err) {
  10.     if (ret.status) {
  11.         alert('分享成功');
  12.     } else {
  13.         alert(err.code);
  14.     }
  15. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

shareProgram

分享小程序

shareProgram({params}, callback(ret, err))

params

apiKey：

  • 类型：字符串
  • 描述：（可选项）从微信开放平台获取的 appid，若不传则从当前 widget 的 config.xml 中读取。

scene：

  • 类型：字符串
  • 描述：（可选项）场景，目前只支持会话
  • 默认值：session

title：

  • 类型：字符串
  • 描述：（可选项）分享小程序的标题

description：

  • 类型：字符串
  • 描述：（可选项）分享小程序的描述。由于微信平台限制，对不同平台部分场景本参数无效

thumb：

  • 类型：字符串
  • 描述：（可选项）分享小程序的缩略图地址，要求本地路径（fs://、widget://）大小不能超过32K,需要路径包含图片格式后缀，否则如果原图片为非png格式，会分享失败

webpageUrl：

  • 类型：字符串
  • 描述：兼容低版本微信的网页
  • 注意：若客户端版本低于6.5.6，小程序类型分享将自动转成网页类型分享。开发者必须填写网页链接字段，确保低版本客户端能正常打开网页链接。

userName：

  • 类型：字符串
  • 描述：分享小程序的原始 id

path：

  • 类型：字符串
  • 描述：分享小程序的页面的路径

hdImageData：

  • 类型：字符串
  • 描述：小程序新版本的预览图的路径(128k)(android不支持)

withShareTicket：

  • 类型：布尔
  • 描述：是否使用带 shareTicket 的转发

miniProgramType：

  • 类型：字符串
  • 描述：分享小程序的版本（正式，开发，体验）
  • 取值范围：
    • release：正式版
    • test：开发测试版
    • preview：体验版

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     status: true   //布尔型；true||false
  3. }

err：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     code: 0     //数字类型；
  3.                 //错误码：
  4.                 //-1（未知错误）
  5.                 //0（成功）
  6.                 //1（apiKey非法）
  7.                 //2（用户取消）
  8.                 //3（发送失败）
  9.                 //4（授权拒绝）
  10.                 //5（微信服务器返回的不支持错误）
  11.                 //7 (注册SDK失败)
  12. }

示例代码

  1. var wx = api.require('wx');
  2. wx.shareProgram({
  3.     apiKey: '',
  4.     scene: 'session',
  5.     title: '测试标题',
  6.     description: '分享内容的描述',
  7.     thumb: 'widget://a.jpg',
  8.     webpageUrl: 'http://apicloud.com',
  9.     userName: '',
  10.     path: '',
  11. }, function(ret, err) {
  12.     if (ret.status) {
  13.         alert('分享成功');
  14.     } else {
  15.         alert(err.code);
  16.     }
  17. });

可用性

iOS系统，Android系统

可提供的1.0.2及更高版本

launchMiniProgram

拉起小程序功能

注：在同一开放平台账号下的移动应用及小程序无需关联即可完成跳转，非同一开放平台账号下的小程序需与移动应用（APP）成功关联后才支持跳转

launchMiniProgram({params}, callback(ret, err))

params

apiKey：

  • 类型：字符串
  • 描述：（可选项）从微信开放平台获取的 appid，若不传则从当前 widget 的 config.xml 中读取。

miniProgramType：

  • 类型：字符串
  • 描述：拉起小程序的类型
  • 默认：test
  • 取值范围：
    • test：开发版
    • preview：体验版
    • release：正式版

userName：

  • 类型：字符串
  • 描述：拉起的小程序的username，小程序的原始ID

path：

  • 类型：字符串
  • 描述：拉起小程序页面的可带参路径，不填默认拉起小程序首页

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     eventType: 'launch',   //字符串类型；交互事件类型，取值范围如下:
  3.                            //launch：跳转到微信并拉起小程序事件(android不支持)
  4.                            //back：跳转回本APP事件
  5.     status: true,          //布尔型；是否拉起成功，仅当 eventType 为 launch 有值
  6.     extMsg: ‘’             //字符串类型；对应JsApi navigateBackApplication中的extraData字段数据，仅当 eventType 为 back 有值
  7. }

err：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     code: 0     //数字类型；
  3.                 //错误码：
  4.                 //-1（未知错误）
  5.                 //0（成功）
  6.                 //1（apiKey非法）
  7.                 //7 (注册SDK失败)
  8. }

示例代码

  1. var wx = api.require('wx');
  2. wx.launchMiniProgram({
  3.     apiKey: '',
  4.     miniProgramType: 'test',
  5.     userName: '',
  6.     path: '',
  7. }, function(ret, err) {
  8.     if (ret.status) {
  9.         alert('成功');
  10.     } else {
  11.         alert(err.code);
  12.     }
  13. });

可用性

iOS系统，Android系统

可提供的1.0.4及更高版本

subscribeMsg

一键订阅，详情参考 微信文档。

subscribeMsg({params}, callback(ret, err))

params

apiKey：

  • 类型：字符串
  • 描述：（可选项）从微信开放平台获取的 appid，若不传则从当前 widget 的 config.xml 中读取。

scene：

  • 类型：数字
  • 描述：重定向后会带上scene参数，开发者可以填0-10000 的整形值，用来标识订阅场值

templateId：

  • 类型：字符串
  • 描述：订阅消息模板ID，在微信开放平台提交应用审核通过后获得

reserved：

  • 类型：字符串
  • 描述：（可选项）用于保持请求和回调的状态，授权请后原样带回给第三方。该参数可用于防止csrf攻击（跨站请求伪造攻击），建议第三方带上该参数，可设置为简单的随机数加session进行校验，开发者可以填写a-zA-Z0-9的参数值，最多128字节，要求做urlencode

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     eventTye: 'back'   //字符串类型；交互事件类型；取值范围：
  3.                        //start:开始跳转微信
  4.                        //error:发生错误
  5.                        //back:订阅成功并从微信跳转回来
  6.                        //backError：订阅失败并从微信跳转回来
  7.     templateId:,       //字符串类型；
  8.     action:            //字符串类型；
  9.     openId:            //字符串类型；
  10.     reserved:          //字符串类型；
  11.     scene:             //数字类型；
  12. }

err：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     code: 0     //数字类型；
  3.                 //错误码：
  4.                 //-1（未知错误）
  5.                 //0（成功）
  6.                 //1（templateId为空）
  7.                 //2（用户取消）
  8.                 //3（发送失败）
  9.                 //4（授权拒绝）
  10.                 //5（微信服务器返回的不支持错误）
  11.                 //7 (注册SDK失败)
  12. }

示例代码

  1. var wx = api.require('wx');
  2. wx.subscribeMsg({
  3.     apiKey: '',
  4.     scene: 2,
  5.     templateId: '测试标题',
  6.     reserved: '分享内容的描述'
  7. }, function(ret, err) {
  8.     if (ret.eventType == 'back') {
  9.         alert('订阅成功');
  10.     } else {
  11.         console.log(JSON.stringify(error));
  12.     }
  13. });

可用性

iOS 系统，Android 系统

可提供的 1.1.2 及更高版本

auth

登录授权（用于实现第三方登录），详情参考微信官方文档，移动登录开发指南

auth({params}, callback(ret, err))

params

apiKey：

  • 类型：字符串
  • 描述：（可选项）从微信开放平台获取的 appid，若不传则从当前 widget 的 config.xml 中读取，不传或传入错误的 apiKey，则无法打开微信进行登录。

scope：

  • 类型：字符串
  • 描述：（可选项）授权域，什么是授权域?
  • 默认：snsapi_userinfo

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.   status: true,       //布尔型；true||false
  3.   code: ''           //字符串类型；getToken 接口需传入此值，用于换取 accessToken
  4. }

err：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     code: 0     //数字类型；
  3.                 //错误码：
  4.                 //-1（未知错误），
  5.                 //0（成功，用户同意）
  6.                 //1 (用户取消)
  7.                 //2 (用户拒绝授权)
  8.                 //3 (当前设备未安装微信客户端)
  9. }

示例代码

  1. var wx = api.require('wx');
  2. wx.auth({
  3.     apiKey: ''
  4. }, function(ret, err) {
  5.     if (ret.status) {
  6.         alert(JSON.stringify(ret));
  7.     } else {
  8.         alert(err.code);
  9.     }
  10. });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

getToken

获取授权 accessToken（需要登录授权成功）

本接口封装的微信获取 token 的接口，详情参考微信官方文档之——-第二步：通过code获取access_token

开发者可不通过本接口来获取token，可自行访问微信接口获取。

getToken({params}, callback(ret, err))

params

apiKey：

  • 类型：字符串
  • 描述：（可选项）从微信开放平台获取的 appid，若不传则从当前 widget 的 config.xml 中读取。

apiSecret

  • 类型：字符串
  • 描述：（可选项）从微信开放平台获取的 secret，若不传则从当前 widget 的 config.xml 中读取。

code

  • 类型：字符串
  • 描述：通过 auth 接口授权成功后返回的 code 参数

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.   status: true,      //布尔型；true||false
  3.   accessToken: '',   //字符串类型；接口调用凭证，传给 getUserInfo 接口 获取用户信息；有效期2小时
  4.   dynamicToken: '',  //字符串类型；当 accessToken 过期时把该值传给 refreshToken 接口刷新 accessToken 的有效期。dynamicToken 的有效期为30天
  5.   expires: 7200,     //数字类型；accessToken 有效期，单位（秒）
  6.   openId: ''         //字符串类型；授权用户唯一标识
  7. }

err：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     code: 0     //数字类型；
  3.                 //错误码：
  4.                 //-1（未知错误），
  5.                 //0 （成功）
  6.                 //1 (apiKey值为空或非法)
  7.                 //2 (apiSecret值为空或非法)
  8.                 //3 (code值为空或非法)
  9.                 //4 (网络超时)
  10. }

示例代码

  1. var wx = api.require('wx');
  2. wx.getToken({
  3.     apiKey: '',
  4.     apiSecret: '',
  5.     code: "12346857684"
  6. }, function(ret, err) {
  7.     if (ret.status) {
  8.         alert(JSON.stringify(ret));
  9.     } else {
  10.         alert(err.code);
  11.     }
  12. });

补充说明

此接口需要访问网络，异步调用 callback 需要一段时间才能返回 accessToken

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

getUserInfo

获取用户信息（需要获取 accessToken 成功）

本接口封装的微信获取用户信息的接口，详情参考微信官方文档之——-第三步：通过access_token调用接口

开发者可不通过本接口来获取，可自行访问微信接口获取。

getUserInfo({params}, callback(ret, err))

params

accessToken：

  • 类型：字符串
  • 描述：getToken 接口或 refreshToken 接口成功获取的 accessToken 值

openId：

  • 类型：字符串
  • 描述：getToken 接口或 refreshToken 接口成功获取的 openId 值

lang：

  • 类型：字符串
  • 描述：（可选项）国家地区语言版本
  • 默认：zh_CN
  • 取值范围：
    • zh_CN 简体
    • zh_TW 繁体
    • en 英语

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     status: true,      //布尔型；true||false
  3.     openid: '',        //字符串类型；普通用户的标识，对当前开发者帐号唯一
  4.     nickname: '',      //字符串类型；普通用户昵称
  5.     sex: 1,            //数字类型；普通用户性别，1为男性，2为女性
  6.     headimgurl: '',    //字符串类型；用户头像，最后一个数值代表正方形头像大小（有0、46、64、96、132数值可选，0代表640*640正方形头像），用户没有头像时该项为空
  7.     privilege: [],     //数组类型；用户特权信息，如微信沃卡用户为（chinaunicom）
  8.     unionid: ''        //字符串类型；用户统一标识。针对一个微信开放平台帐号下的应用，同一用户的unionid是唯一的。
  9. }

err：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     code: 0     //数字类型；
  3.                 //错误码：
  4.                 //-1（未知错误），
  5.                 //0 （成功）,
  6.                 //1 （accessToken 过期）,
  7.                 //2  (openId非法),
  8.                 //3  (openId值为空),
  9.                 //4     (accessToken值为空),
  10.                 //5     (accessToken非法)
  11.                 //6     (网络超时)
  12. }

示例代码

  1. var wx = api.require('wx');
  2. wx.getUserInfo({
  3.     accessToken: '',
  4.     openId: ''
  5. }, function(ret, err) {
  6.     if (ret.status) {
  7.         alert(JSON.stringify(ret));
  8.     } else {
  9.         alert(err.code);
  10.     }
  11. });

补充说明

此接口需要访问网络，异步调用 callback 需要一段时间才能返回用户信息

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

refreshToken

调用 getUserInfo 接口错误码返回1时，代表 accessToken 过期，调用此接口刷新 accessToken

本接口封装的微信刷新 token 的接口。详情参考微信官方文档之——-第三步：通过access_token调用接口

开发者可不通过本接口刷新，可自行访问微信接口刷新。

refreshToken({params}, callback(ret, err))

params

apiKey：

  • 类型：字符串
  • 描述：（可选项）从微信开放平台获取的 appid，若不传则从当前 widget 的 config.xml 中读取。

dynamicToken：

  • 类型：字符串
  • 描述：getToken 接口或 refreshToken 接口获取的 dynamicToken 值

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     status: true,      //布尔型；true||false
  3.     accessToken: '',   //字符串类型；接口调用凭证，传给 getUserInfo 接口 获取用户信息；有效期2小时
  4.     dynamicToken: '',  //字符串类型；当 accessToken 过期时把该值传给 refreshToken 接口刷新 accessToken 的有效期。dynamicToken 的有效期为30天
  5.     expires: 7200,     //数字类型；accessToken 有效期，单位（秒）
  6.     openId: ''         //字符串类型；授权用户唯一标识
  7. }

err：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     code: 0     //数字类型；
  3.                 //错误码：
  4.                 //-1（未知错误），
  5.                 //0（成功）,
  6.                 //1（apiKey值为空或非法），
  7.                 //2（refreshToken值为空）,
  8.                 //3（refreshToken非法），
  9.                 //4（网络超时）
  10. }

示例代码

  1. var wx = api.require('wx');
  2. wx.refreshToken({
  3.     apiKey: '',
  4.     dynamicToken: ''
  5. }, function(ret, err) {
  6.     if (ret.status) {
  7.         alert(JSON.stringify(ret));
  8.     } else {
  9.         alert(err.code);
  10.     }
  11. });

补充说明

此接口需要访问网络，异步调用 callback 需要一段时间才能返回 accessToken

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

shareMutableImg

分享多张图片到朋友圈，暂仅支持 Android 平台，iOS 平台可使用 shareAction 模块来实现多图分享。注意：由于不是使用的官方sdk进行的分享，而是直接调用的微信客户端的分享界面，分享后无法回到原应用，且微信端不会给出是否分享成功的反馈，所以本接口暂无回调

shareMutableImg({params})

params

imgs：

  • 类型：数组
  • 描述：要分享的图片的路径组成的数组，要求本地路径（fs://、widget://）

description：

  • 类型：字符串
  • 描述：分享的文字
  • 注意：由于微信升级的原因，此字段废除，

示例代码

  1. var wx = api.require('wx');
  2. wx.shareMutableImg({
  3.     description: 'weixin share image test description',
  4.     imgs: ['widget://res/1.png', 'widget://res/12.jpg', 'widget://res/123.jpg']
  5. });

可用性

Android系统

可提供的1.0.0及更高版本