Html5 微信分享以及自定义内容

4,562 阅读3分钟

最近一个项目有一个微信分享并且需要自定义微信分享内容的需求,因为是第一次接触到微信分享,所以记录一下期间遇到的一些问题,以及完成功能的整个流程。

以下为大概流程 (细节放在各个阶段)

  • 安装 weixin-js-sdk
  • 初始化微信分享
  • 配置微信分享自定义内容(发送给朋友,发送到朋友圈)

1、安装weixin-js-sdk

npm install weixin-js-sdk --save-dev

具体的使用说明查阅微信官方文档

2、 初始化微信分享

因为本人正在做的项目多处需要使用到微信分享的功能,所以这里会对微信分享的代码进行封装

下面的url其实就是页面的url,因为需要发到后端进行签名认证,但是这个url有个情况需要注意

当url为www.xx.com/index.html#/形式 当是这种情况的时候,假如你在安卓上使用页面完整的url去后端拿参数的时,在安卓端是可以完成配置的,但是在苹果端的时候,会莫名的出现有时候配置会报错,并且有可能在刷新页面的时候,就又可以完成配置。

解决方案:使用encodeURIComponent()函数编码url,并且是截取了#之前的url,例如:
let url = encodeURIComponent(window.location.href.split('#')[0])

具体的原因也不是很清楚,查看了资料说是进行了encodeURIComponent()编码就可以,但是为什么在安卓端是使用了base64编码又不会出现这种情况,并且在苹果端我这边是刷新一下页面就可以了,并且有时候又可以通过验证,不会返回签名错误。

import wx from 'weixin-js-sdk'
import api from '@/api'
const wxApi = {
    /**
   * [wxRegister 微信Api初始化]
   * @param  {Function} callback [ready回调函数]
   */
  wxRegister (callback, url) {
    let query = {
      url: url 
    }
    api.getWxJsSdk(query).then(res => {
      let data = res.data
      wx.config({
        debug: false, // 开启调试模式
        appId: data.appId, // 必填,公众号的唯一标识
        timestamp: data.timestamp, // 必填,生成签名的时间戳
        nonceStr: data.nonceStr, // 必填,生成签名的随机串
        signature: data.signature, // 必填,签名,见附录1
        jsApiList: data.jsApiList // 必填,需要使用的JS接口列表,所有JS接口列表见附录2
      })
    })
    wx.ready((res) => {
      // 如果需要定制ready回调方法
      if (callback) {
        callback()
      }
    })
  },
}

3、 配置微信分享自定义内容(发送给朋友,发送到朋友圈)

第二步对于微信初始化了封装配置,但是还缺少了相对应的分享等功能,这边就完善一下,

// 在wxRegister函数后面添加
/**
* [ShareTimeline 自定义微信分享到朋友圈]
* @param {[type]} option [分享信息]
* @param {[type]} success [成功回调]
* @param {[type]} error   [失败回调]
*/
ShareTimeline (option) {
wx.updateTimelineShareData({
  title: option.title, // 分享标题
  link: option.link, // 分享链接
  imgUrl: option.imgUrl, // 分享图标
  success () {
    // 设置成功
  },
  cancel () {
    // 设置失败
  }
})
},
/**
* [ShareAppMessage 自定义微信分享到朋友]
* @param {[type]} option [分享信息]
* @param {[type]} success [成功回调]
* @param {[type]} error   [失败回调]
*/
ShareAppMessage (option) {
wx.updateAppMessageShareData({
  title: option.title, // 分享标题
  desc: option.desc, // 分享描述
  link: option.link, // 分享链接
  imgUrl: option.imgUrl, // 分享图标
  success () {
    // 设置成功
  },
  cancel () {
    // 设置失败
  }
})
}

4、页面调用时

// vue 为例
// 以下的函数有形参请参考上面的方法
import wx from '你封装的文件'
mounted(){
    let base64 = require('js-base64').Base64
    let url = base64.encode(window.location.href)
    wx.wxRegister(this.wxRegCallback,url)
},
methods:{
    // 自定义的jdk回调
    wxRegCallback () {},
    // 自定义的分享给朋友的函数
    wxShareAppMessage(){
        let option = {
            title:'',// 分享标题
            desc: '', // 分享描述
            link: '', // 分享链接
            imgUrl: '' // 分享图标
        }
        // 注入通用方法
        wx.ShareAppMessage(option)
    },
    // 自定义的分享给朋友圈的函数
    wxShareTimeline(){
        let option = {
            title:'',// 分享标题
            desc: '', // 分享描述
            link: '', // 分享链接
            imgUrl: '' // 分享图标
        }
        // 注入通用方法
        wx.ShareTimeline(option)
    }
}

以上就是微信分享的流程,若有不足,欢迎指出
注:

  • 微信分享只能在真机上测试
  • 使用本地localhost形式的域名无法通过微信的校验