HTML5 起航____微信JSSDK开发信息配置

引言

好像更加接近真相了,今天向大家介绍的是微信JSSDK开发。

重点

微信JS-SDK是微信公众平台面向网页开发者提供的基于微信内的网页开发工具包。

通过使用微信JS-SDK,网页开发者可借助微信高效地使用拍照、选图、语音、位置等手机系统的能力,同时可以直接使用微信分享、扫一扫、卡券、支付等微信特有的能力。

但是很多人在配置和使用的时候,老是出各种错误。最近项目也涉及到这个,就记录一下过程,并对方法进行封装。

配置基本步骤

参照微信JS-SDK官方文档说明

1. 绑定域名

先确保你使用的是认证的账号(订阅号,服务号),因为没认证的号是没有JS安全域名配置权限的。建议开发前先看看公众号类型的接口权限说明

登录微信公众平台进入“公众号设置”的“功能设置”里填写“JS接口安全域名”。

2. 引入JS文件

在需要调用JS接口的页面引入如下JS文件,(支持https):http://res.wx.qq.com/open/js/jweixin-1.2.0.js

请注意,如果你的页面启用了https,务必引入 https://res.wx.qq.com/open/js/jweixin-1.2.0.js ,否则将无法在iOS9.0以上系统中成功使用JSSDK

3. 通过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接口列表
});

签名算法见文末的附录1,所有JS接口列表见文末的附录2

4. 通过ready接口处理成功验证

wx.ready(function(){
    // config信息验证后会执行ready方法,所有接口调用都必须在config接口获得结果之后,config是一个客户端的异步操作,所以如果需要在页面加载时就调用相关接口,则须把相关接口放在ready函数中调用来确保正确执行。对于用户触发时才调用的接口,则可以直接调用,不需要放在ready函数中。
});

5. 通过error接口处理失败验证

wx.error(function(res){
    // config信息验证失败会执行error函数,如签名过期导致验证失败,具体错误信息可以打开config的debug模式查看,也可以在返回的res参数中查看,对于SPA可以在这里更新签名。
});

这些基本步骤在 微信JS-SDK官方文档说明 里边讲的很清楚了。但很多人在开发的时候用自己服务器不知道上边第3步配置信息该如何配置,我就具体说说方法吧。


1. 下载jssdk的demo

下载地址:http://demo.open.weixin.qq.com/jssdk/sample.zip

2. 解压demo,获取JSSDK的验证类

将jssdk.php放到自己的服务器上引入自己的程序。

3. 获取签名信息

初始化JSSDK类之后,获取签名信息,然后将签名信息填写到上边步骤3中配置项中就OK了。

require_once "jssdk.php";  
$jssdk = new JSSDK("yourAppID", "yourAppSecret");  
$signPackage = $jssdk->GetSignPackage();  
wx.config({  
   debug: true,  
   appId: '<?php echo $signPackage["appId"];?>',  
   timestamp: <?php echo $signPackage["timestamp"];?>,  
   nonceStr: '<?php echo $signPackage["nonceStr"];?>',  
   signature: '<?php echo $signPackage["signature"];?>',  
   jsApiList: [  
     // 所有要调用的 API 都要加到这个列表中  
   ]  
);  

方法的封装:

用法:
前端页面嵌入代码 <php>echo register_jssdk(true);</php> 或者{php echo register_jssdk(true);}根据自己使用的框架而定。

/** 
 * 微信jssdk 
 * @param  [bool]   $debug [是否是使用debug模式] 
 * @return [string] 微信jssdk代码 
 */  
function register_jssdk($debug=false){  
    require_once APP_ROOT.'/Api/jssdk.php';  
    $appid = 'wechat_appid';  
    $secret = 'wechat_secret';  
    $jssdk = new JSSDK($appid,$secret);  
    $signPackage = $jssdk->GetSignPackage();  
    if($debug){  
        $debug = 'true';  
    }else{  
        $debug = 'false';  
    }  
    $js = "<script src='http://res.wx.qq.com/open/js/jweixin-1.0.0.js'></script>  
    <script>  
    wx.config({  
    debug: ".$debug.",  
    appId: '".$signPackage["appId"]."',  
    timestamp: ".$signPackage["timestamp"].",  
    nonceStr: '".$signPackage["nonceStr"]."',  
    signature: '".$signPackage["signature"]."',  
    jsApiList: [  
        'checkJsApi',      
        'onMenuShareTimeline',      
        'onMenuShareAppMessage',      
        'onMenuShareQQ',      
        'onMenuShareWeibo',      
        'hideMenuItems',      
        'showMenuItems',      
        'hideAllNonBaseMenuItem',      
        'showAllNonBaseMenuItem',      
        'translateVoice',      
        'startRecord',      
        'stopRecord',      
        'onRecordEnd',      
        'playVoice',      
        'pauseVoice',      
        'stopVoice',      
        'uploadVoice',      
        'downloadVoice',      
        'chooseImage',      
        'previewImage',      
        'uploadImage',      
        'downloadImage',      
        'getNetworkType',      
        'openLocation',      
        'getLocation',      
        'hideOptionMenu',      
        'showOptionMenu',      
        'closeWindow',      
        'scanQRCode',      
        'chooseWXPay',      
        'openProductSpecificView',      
        'addCard',      
        'chooseCard',      
        'openCard'      
    ]  
  });</script>";  
    
  return $js;  
}  
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 213,864评论 6 494
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,175评论 3 387
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 159,401评论 0 349
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,170评论 1 286
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,276评论 6 385
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,364评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,401评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,179评论 0 269
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,604评论 1 306
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,902评论 2 328
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,070评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,751评论 4 337
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,380评论 3 319
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,077评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,312评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,924评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,957评论 2 351

推荐阅读更多精彩内容