项目实战:微信JS-SDK使用教程
1、查阅资料
登录微信开发平台




这样子就能根据文档来使用js-sdk了。
2、绑定域名
可登录微信公众平台进入“服务号设置”的“功能设置”里填写“JS接口安全域名”。或者前往微信开发者平台 - 服务号或服务号 - 基本信息 - 开发信息 进行修改。

点击设置:

最多只能填三个。注意上面图片的第三条。我们以test.yunp.top为例。
3、引入js-sdk
在需要调用JS接口的页面引入如下JS文件,(支持https):http://res.wx.qq.com/open/js/jweixin-1.6.0.js。如需进一步提升服务稳定性,当上述资源不可访问时,可改访问:http://res2.wx.qq.com/open/js/jweixin-1.6.0.js (支持https)。
备注:支持使用 AMD/CMD 标准模块加载方法加载。

4、通过config接口注入权限验证配置
所有需要使用JS-SDK的页面必须先注入配置信息,否则将无法调用(同一个url仅需调用一次,对于变化url的SPA的web app可在每次url变化时进行调用,目前Android微信客户端不支持pushState的H5新特性,所以使用pushState来实现web app的页面会导致签名失败,此问题会在Android6.2中修复)。
wx.config({
debug: true, // 开启调试模式,调用的所有api的返回值会在客户端alert出来,若要查看传入的参数,可以在pc端打开,参数信息会通过log打出,仅在pc端时才会打印。
appId: '', // 必填,服务号的唯一标识
timestamp: , // 必填,生成签名的时间戳
nonceStr: '', // 必填,生成签名的随机串
signature: '',// 必填,签名
jsApiList: [] // 必填,需要使用的JS接口列表
});
appId:

timestamp和nonceStr:
我们可以自己按规则生成
jsApiList:

重点是signature的生成。 详细过程参见https://developers.weixin.qq.com/doc/service/guide/h5/jssdk.html#62。
4.1 创建应用服务器


运行一个该服务器项目:


4.2 获取access_token


appId和grant_type如上表格很容易理解。主要看secret:


我们需要通过express的http来获取接口信息:

如上发现域名不在白名单里面。我们需要将该域名添加到白名单:


再重启服务器:

4.3 异步化获取access_token
新建一个Wx.js:

改一下如下:


4.4 获取jsapi_ticket

如上。两个通信方式格式都一样,我们可以封装一下方法:



打印jsapi-ticket:

4.5 缓存jsapi-ticket
添加一个成员:

要注意下面7100s比7200s小一点点,反之临界值问题。


4.6 生成签名
有了jsapi_ticket之后,我们就可以生成签名。

我们会发现noncestr和timestamp都是前端自行生成。对于url,有一些注意点:

所以我们需要对url进行拼接:

4.7 配置API


然后可以在微信开发工具进行测试。
5、调用js-sdk的API

然后可以在微信开发者工具中进行测试:

6、其它注意点
有时候在企业微信中我们有很多个小型应用,点击每个应用都要进行相应界面。这里每个应用都占有一个路由。我们从企业微信跳到网页应用,就需要用到js-sdk。在进行鉴权时候跳转页面的时候url参数带有关于签名相关的信息,我们通过获取url上参数进行解析,然后按相应方法完成接口鉴权。
由于每个应用都占有一个路由,因此我们需要在导航守卫中进行jssdk接口鉴权。

9550

被折叠的 条评论
为什么被折叠?



