VUE如何进行微信定位(使用微信JSSDK)

摘要

背景:在做高德地图的定位时,发现在微信浏览器中只要最开始把定位权限关闭后,就再也没有位置可以再次打开定位权限,导致在微信浏览器中再也无法定位(mmp,就离谱),所以本文要使用微信自带的定位接口,实现在微信浏览器里的定位,以防止定位权限再也无法打开的情况。
本文主要介绍两点:
1.使用微信JSSDK进行微信定位的开发流程(非原理)
2.VUE中具体实现,以及本地如何进行测试

一、使用微信JSSDK进行微信定位的开发流程

步骤一:绑定域名

先登录微信公众平台进入“公众号设置”的“功能设置”里填写“JS接口安全域名”,如下图
在这里插入图片描述
点击设置,进行安全域名设置
在这里插入图片描述
注意:这里写线上的安全域名,即使保存次数用完了也没关系,可以在本地进行测试。

步骤二:引入JS文件

在需要调用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 标准模块加载方法加载

在VUE中直接使用npm进行安装,在使用的地方import即可

npm isntall weixin-js-sdk --save

import wx from 'weixin-js-sdk'

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

wx.config({
  debug: true, // 开启调试模式,调用的所有api的返回值会在客户端alert出来,若要查看传入的参数,可以在pc端打开,参数信息会通过log打出,仅在pc端时才会打印。
  appId: '', // 必填,公众号的唯一标识
  timestamp: , // 必填,生成签名的时间戳,后端返回
  nonceStr: '', // 必填,生成签名的随机串,后端返回
  signature: '',// 必填,签名,后端返回
  jsApiList: [] // 必填,需要使用的JS接口列表
});

除了jsApiList,我们都需要从后端获取。
我们就向后端发起一个请求,然后后端封装一下返回给前端是不是就好了。

appId,直接从微信后台拿来用就行。

timestamp,后端返回,但要注意要以秒为单位。

nonceStr,后端返回,随机串。

signature,生成方式如下。

signature的生成(后端处理,与前端无关)

1、参考以下文档获取access_token(有效期7200秒,开发者必须在自己的服务全局缓存access_token):
https://developers.weixin.qq.com/doc/offiaccount/Basic_Information/Get_access_token.html
2、用第一步拿到的access_token 采用http GET方式请求获得jsapi_ticket(有效期7200秒,开发者必须在自己的服务全局缓存jsapi_ticket)
https://api.weixin.qq.com/cgi-bin/ticket/getticket?access_token=ACCESS_TOKEN&type=jsapi
成功返回如下JSON:

{
  "errcode":0,
  "errmsg":"ok",
  "ticket":"bxLdikRXVbTPdHSM05e5u5sUoXNKd8-41ZO3MhKoyN5OfkWITDGgnr2fwJ0m9E8NYzWKVZvdVtaUgWvsdshFKA",
  "expires_in":7200
}

3、签名算法
示例:

noncestr=Wm3WZYTPz0wzccnW // 后端随机生成的字符串
jsapi_ticket=sM4AOVdWfPE4DxkXGEs8VMCPGGVi4C3VM0P37wVUCFvkVAy_90u5h9nbSlYy3-Sl-HhTdfl2fzFy1AOcHKP7qg // 第二步从微信那里拿到的ticket
timestamp=1414587457 // 时间戳(秒)
url=http://mp.weixin.qq.com?params=value // 当前网页的URL,不包含#及其后面部分,前端传过来的

将以上四个变量按照字段名的ASCII 码从小到大排序(字典序)后,使用URL键值对的格式(即key1=value1&key2=value2…)拼接成字符串string1(所有参数名均为小写字符)
拼好后如下

jsapi_ticket=sM4AOVdWfPE4DxkXGEs8VMCPGGVi4C3VM0P37wVUCFvkVAy_90u5h9nbSlYy3-Sl-HhTdfl2fzFy1AOcHKP7qg&noncestr=Wm3WZYTPz0wzccnW&timestamp=1414587457&url=http://mp.weixin.qq.com?params=value

然后将拼好的string1进行sha1签名,得到signature:

0f9de62fce790f9a083d5c99e95740ceb90c27ed

注意事项

1.签名用的noncestr和timestamp必须与wx.config中的nonceStr和timestamp相同。

2.签名用的url必须是调用JS接口页面的完整URL。

3.出于安全考虑,开发者必须在服务器端实现签名的逻辑。

4.signature生成不对前端就会出现invalid signature错误,解决方法见下面的常见问题。

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

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

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

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

二、VUE中具体实现,以及本地如何进行测试

1、搭建本地测试环境

1.首先下载微信开发者工具下载地址
2.将本地的localhost改为 第一步中所绑定的js安全域名
(在这之前判断你的VUE工程调用接口的地址是否跟所绑定的js安全域名一样,如果一样,则通过服务器ip地址调用接口。)
修改host文件(位置 C:\Windows\System32\drivers\etc
如下图
在这里插入图片描述
3.VUE工程将本地端口号设为80
如下图,在跟目录的vue.config.js添加如下代码

devServer: {
    open: process.platform === 'darwin',
    host: '0.0.0.0',
    port: '80',
    disableHostCheck: true,
    https: false,
    hotOnly: false,
    overlay: {
      warnings: false,
      errors: true
    }
    // proxy: {
    //   '/api': {
    //     target: 'xxxxxx', // 自己的代理
    //     changeOrigin: true,
    //     pathRewrite: {
    //       '^/api': '/'
    //     }
    //   }
    // }
  },

4.查看本地80端口是否被占用
window下使用如下命令

netstat -aon|findstr "80"

如下图
在这里插入图片描述
打开任务管理器,将pid为上图19572的服务关闭,如下图
在这里插入图片描述
5.最后运行你的VUE项目,在微信开发者工具中打开,注意不要使用localhost访问,使用第一步所修改的域名,不需要加端口号,如下图
在这里插入图片描述
本地环境已搭建完毕

2、VUE中具体实现

1.引入JS文件

npm isntall weixin-js-sdk --save

2.配置微信

import wx from 'weixin-js-sdk'
import apis from '@/api'

// 初始化微信sdk方法
wxJsSdkInit() {
	const url = window.location.href
	const jsApiList = ['getLocation'] // 微信获取地理位置接口
	const request = { ...apis.ACCOUNT.WX_SIGN } // 接口地址
	request.params = { // 参数
	  url
	}
	this.$request(request) // 调用接口
	.asyncThen(
	  (resp) => {
	  	// 成功返回
	    wx.config({
	      debug: true, // 开发时设为true方便调试
	      signature: resp.data.signature,
	      nonceStr: resp.data.nonceStr,
	      timestamp: resp.data.timestamp,
	      appId: resp.data.appId,
	      jsApiList
	    })
	    wx.error((res) => {
	      // 微信配置失败
	      // console.log(res)
	      // config信息验证失败会执行error函数,如签名过期导致验证失败,具体错误信息可以打开config的debug模式查看,也可以在返回的res参数中查看,对于SPA可以在这里更新签名。
	    })
	    wx.ready((res) => {
	      // 微信配置成功
	      // config信息验证后会执行ready方法,所有接口调用都必须在config接口获得结果之后,config是一个客户端的异步操作,所以如果需要在页面加载时就调用相关接口,则须把相关接口放在ready函数中调用来确保正确执行。对于用户触发时才调用的接口,则可以直接调用,不需要放在ready函数中。
	      // console.log(res)
	    })
	  },
	  (err) => {
	    console.error(err)
	  }
	)
	.asyncErrorCatch((err) => {
	  console.error(err)
	})
}

配置好如下图所示
在这里插入图片描述

3.调用微信getLocation方法

import wx from 'weixin-js-sdk'

getLocationByWx() [
	const ua = window.navigator.userAgent.toLowerCase()
    if (ua.match(/micromessenger/i) != null) {
     wx.getLocation({
       type: 'gcj02', // 默认为wgs84的gps坐标,如果要返回直接给openLocation用的火星坐标,可传入'gcj02'
       success: (res) => {
         var lat = res.latitude // 纬度,浮点数,范围为90 ~ -90
         var lng = res.longitude // 经度,浮点数,范围为180 ~ -180。
         // var speed = res.speed // 速度,以米/每秒计
         // var accuracy = res.accuracy // 位置精度
       },
       fail: (error) => {
         // this.$message({
         //   type: 'error',
         //   message: `微信定位失败,请稍后重试`
         // })
       },
       cancel: (error) => {
         // this.$message({
         //   type: 'error',
         //   message: `微信定位未授权,请稍后重试`
         // })
       }
     })
    }
}

定位后如下图所示
在这里插入图片描述

三、常见问题

1.invalid url domain当前页面所在域名与使用的appid没有绑定,请确认正确填写绑定的域名,仅支持80(http)和443(https)两个端口,因此不需要填写端口号
2.invalid signature签名错误
按以下顺序进行

  1. 确认签名算法正确,可用http://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=jsapisign 页面工具进行校验。判断后端返回的signature是否正确。
  2. 确认config中nonceStr(js中驼峰标准大写S), timestamp与用以签名中的对应noncestr, timestamp一致。
  3. 确认url是页面完整的url(请在当前页面alert(location.href.split(’#’)[0])确认),包括’http(s)😕/‘部分,以及’?‘后面的GET参数部分,但不包括’#'hash后面的部分。
  4. 确认 config 中的 appid 与用来获取 jsapi_ticket 的 appid 一致。
  5. 确保一定缓存access_token和jsapi_ticket。
  6. 确保你获取用来签名的url是动态获取的

注意:如果以上都没有问题(部署到线上就是好的,本地就不行,mmp这就离谱,本地都失败了,谁敢部署到线上。死锁了。。。),那一定是本地测试所访问的地址和所配置的js安全域名不一致,本地用了localhost,而js安全域名是线上的地址,所以一定要搭建本地测试环境。

3.getLocation定位不准:只会在微信开发者工具上会有问题,不必担心。

四、参考地址

1.微信JS-SDK说明文档
2.https://www.cnblogs.com/xiaofeng-blog/p/10216988.html

  • 5
    点赞
  • 23
    收藏
    觉得还不错? 一键收藏
  • 1
    评论
要在Vue2中接入微信公众号JSSDK,您需要按照以下步骤进行操作: 1. 在公众号后台配置JS接口安全域名,确保您的域名已经添加到了微信公众平台的安全域名列表中。 2. 安装使用`weixin-js-sdk`库,可以通过npm进行安装: ``` npm install weixin-js-sdk ``` 3. 在需要使用JSSDK的组件或页面中引入`weixin-js-sdk`库: ```javascript import wx from 'weixin-js-sdk'; ``` 4. 在组件或页面的`mounted`生命周期钩子函数中初始化JSSDK,并进行相关配置: ```javascript mounted() { this.initWeChatJSSDK(); }, methods: { initWeChatJSSDK() { // 异步请求后端接口获取微信配置信息 axios.get('/api/getWeChatConfig') .then(response => { const { appId, timestamp, nonceStr, signature } = response.data; wx.config({ debug: false, appId, timestamp, nonceStr, signature, jsApiList: ['chooseImage', 'scanQRCode'] // 需要使用JSSDK接口 }); wx.ready(() => { // JSSDK配置成功后的回调函数 console.log('JSSDK配置成功'); }); wx.error((res) => { // JSSDK配置失败后的回调函数 console.error('JSSDK配置失败', res); }); }) .catch(error => { console.error('获取微信配置信息失败', error); }); } } ``` 5. 在需要使用JSSDK的地方调用对应的接口,比如选择图片接口`chooseImage`: ```javascript methods: { chooseImage() { wx.chooseImage({ count: 1, success: function (res) { // 选择图片成功后的处理逻辑 const localIds = res.localIds; // ... }, fail: function (error) { // 选择图片失败后的处理逻辑 console.error('选择图片失败', error); } }); } } ``` 以上是在Vue2中接入微信公众号JSSDK的基本步骤,您可以根据实际需求进行相应的配置和调用。

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值