引言
微信官方提供许多实用的接口,通过这些接口我们可以更加丰富应用的功能,完善自己的公众号,通过配置我们就可以使用微信原生的功能,比如扫一扫,拍照、生成图片等等。下面我们来看一下使用JSJDK的步骤(笔者在微信测试号里调试的)
步骤1:添加安全域名
步骤2:引入JS
步骤3:config接口注入权限验证
wx.config({
debug: true, // 开启调试模式,调用的所有api的返回值会在客户端alert出来,若要查看传入的参数,可以在pc端打开,参数信息会通过log打出,仅在pc端时才会打印。
appId: '', // 必填,公众号的唯一标识
timestamp: , // 必填,生成签名的时间戳
nonceStr: '', // 必填,生成签名的随机串
signature: '',// 必填,签名
jsApiList: [] // 必填,需要使用的JS接口列表
});
这一步很关键,许多小伙伴都止步于此,首先我们先来看一下signature的生成过程,要获得signature,必须通过access_token来换取jsapi_ticket,接着 jsapi_ticket和其它参数排序后通过sha1算法才能得到signature
3.1 获取access_token
https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1421140183
3.2 获取jsapi_ticket
https://api.weixin.qq.com/cgi-bin/ticket/getticket?access_token=ACCESS_TOKEN&type=jsapi
3.3 拼接字符串
jsapi_ticket=sM4AOVdWfPE4DxkXGEs8VMCPGGVi4C3VM0P37wVUCFvkVAy_90u5h9nbSlYy3-Sl-HhTdfl2fzFy1AOcHKP7qg&noncestr=Wm3WZYTPz0wzccnW×tamp=1414587457&url=http://mp.weixin.qq.com?params=value
jsapi_ticket :通过access_token获取的jsapi_ticket
noncestr :随机字符串
timestamp :时间戳
url :调用JSSDK页面的url,必须在安全域名下
3.4 对拼接的字符串进行sha1签名,得到signature
$signature = sha1($str);
注:在开发过程中,为了方便调试,我们也可以先用验证工具来生成signature
步骤4:ready接口处理成功验证
wx.ready(function(){
// config信息验证后会执行ready方法,所有接口调用都必须在config接口获得结果之后,config是一个客户端的异步操作,所以如果需要在页面加载时就调用相关接口,则须把相关接口放在ready函数中调用来确保正确执行。对于用户触发时才调用的接口,则可以直接调用,不需要放在ready函数中。
});
步骤5:error接口处理失败验证
wx.error(function(res){
// config信息验证失败会执行error函数,如签名过期导致验证失败,具体错误信息可以打开config的debug模式查看,也可以在返回的res参数中查看,对于SPA可以在这里更新签名。
});