小程序webview(H5)调用JSSDK功能指北

JavaScript021

小程序webview(H5)调用JSSDK功能指北,第1张

最核心的一个概念 :小程序 的webview(H5页面)中调用jssdk中的功能(比如获取位置信息),需要有一个和小程序申请主体一致的 公众号 账号,在公众号里去配置相关的jssdk信息.1 小程序账号因为webview不支持个人类型,所以需要申请一个企业法人及个体工商户类型的小程序账号2   公众号账号要求小程序和公众号的账号对应的主体信息必须一致,有两种途径达到此目的: 先申请公众号账号,然后通过公众号的快速生成小程序功能,生成步骤1的小程序账号,这样这两个自然满足同主体资格登录微信公众号平台,点击小程序管理-添加-快速注册并认证小程序:用和申请小程序账号完全一致的主体信息去申请公众号(主体类型,主体名称,主体证件号),也能保证两个账号的主体资格一致(目前没有小程序快速生成公众号账号的功能..)3 域名绑定这里需要两个账号都配置一下:业务域名首先webview指向一个外部网页链接(我们的H5页面) <web-view src="https://abc.xxx.com.cn/cc/index.html"></web-view> 这个地址要满足: 已经通过ICP备案域名 https协议 不支持自定义端口 不支持ip地址 不支持短链域名 那么首先要在 小程序 中的'开发'-'开发设置'的'业务域名'中,将https://abc.xxx.com.cn配置进去:JS接口安全域名在上述h5页面中,因为要调用jssdk的js文件: <script type="text/javascript" src="https://res.wx.qq.com/open/js/jweixin-1.3.2.js"></script> 因此要在公众号设置”的“功能设置”里填写“JS接口安全域名”注意 :以上两个配置地址时,都需要将配置时提供的一个文本文件按照要求上传到H5页面所在服务器并确保能被访问,用于腾讯验证服务器,否则是无法提交相关信息的4 应用jssdk提供了很多功能,但是webview中,只支持部分接口,自行查看web-view,这里以获取位置信息为例:通过config接口注入权限验证配置所有需要使用JSSDK的页面必须先注入配置信息,否则将无法调用: wx.config({ appId: '', // 必填,公众号的appid,注意不是小程序的appid timestamp: , // 必填,生成签名的时间戳 nonceStr: '', // 必填,生成签名的随机串 signature: '',// 必填,签名 debug: true, // 选填,开启调试模式,调用的所有api的返回值会在客户端alert出来。 jsApiList: ['getLocation'] // 必填,需要使用的JS接口列表,这里为获取位置信息 }) 以上参数除了最后两个,建议在后台服务中存储和计算,具体需参考jssdk,主要思路: 利用公众号的 appid 和 secret 去获取 access_token利用 access_token 去获取 ticket利用ticket和自行生成的( timestamp , nonceStr ,当前页面的 地址 )计算出最终的 签名 执行getLocation以上步骤执行成功后,方可执行wx.getLocation: var success=true // 之所以这里有个success变量,是因为发现wx.error触发也会调用wx.ready(如果有个wx.success就好了) //但其实这并不完美,因为还发现有时候wx.ready先执行,然后触发了wx.error ........ wx.ready(function(){ if(success){ wx.getLocation({ type: 'wgs84', success(res) { // res为坐标位置信息 }, fail(e) { // 获取失败 } }) } // config信息验证后会执行ready方法 }) wx.error(function(res){ success=false // config信息验证失败会执行error函数 }) 吐槽: wx.config有时候成功,有时候说签名失败 wx.ready代表配置验证完毕了,不代表验证成功了,那他的意义在于什么reference: jssdk: https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/JS-SDK.htmlweb-view: https://developers.weixin.qq.com/miniprogram/dev/component/web-view.html

一,首先在公众号管理后台“公众号设置”的“功能设置”里填写JS接口安全域名,域名需要通过ICP备案,没有备案域名可以用SAE、BAE等平台。此外,自定义分享功能需要通过微信认证才能使用,没有认证的可以跟关系好的朋友借用权限,在他的JS接口安全域名设置这里填上你的域名和共享同一个开发者ID。

二,在需要调用JS接口的页面引入微信JSSDK的JS文件:这个文件在需要分享的页面是必须要引用的,单独特别重申一下,其他方面请阅读官方文档。

微信开发交流群:148540125

欢迎留言、转发、打赏

系列文章参考地址 极速开发微信公众号

项目源码参考地址 点我点我--欢迎Start

服务号、订阅号可以通过登录 微信公众平台 查看 开发>接口权限

使用JSSDK主要包括

1、判断当前客户端版本是否支持指定JS接口、

2、分享接口(微信认证)

3、图像接口

4、音频接口

5、智能接口(识别语音并返回结果)

6、设备信息(获取网络状态)

7、地理位置

8、界面操作

9、微信扫一扫

10、微信小店(服务号必须通过微信认证)

11、微信卡券 (微信认证)

12、微信支付(服务号必须通过微信认证)

官方参考文档

步骤一:绑定域名

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

步骤二:引入JS文件

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

如需使用摇一摇周边功能,请引入 http://res.wx.qq.com/open/js/jweixin-1.1.0.js

备注:支持使用 AMD/CMD 标准模块加载方法加载

步骤三:通过config接口注入权限验证配置

签名算法生成规则

请 官方参考文档

下面具体来讲讲 开源项目 weixin_guide 中的封装。

使用的时候只要在Controller方法上添加一个拦截器 JSSDKInterceptor 来实现签名验证再将 wx.config 需要的参数设置对应的属性在页面上进行获取。

拦截器实现如下:

在Controller中使用

JSP页面上面使用

测试结果

在AppConfig 中添加路由 me.add("/jssdk", JSSDKController.class,"/view")手机中访问 http://域名[/项目名称]/jssdk ,如果设置了 debug= true 成功了就会弹出

如果出现 {"errorMsg":"config:invalid url domian"} 请检查 步骤一:绑定域名 与你访问的域名是否在安全域名列表当中

步骤四:通过ready接口处理成功验证

步骤五:通过error接口处理失败验证

步骤六:接口调用

拦截器具体实现 参考地址 点这里

js 接口调用参考地址 点这里

以上就是JSSDK使用的介绍。

欢迎留言、转发、打赏项目

源码参考地址 点我点我--欢迎Start