微信jssdk总结

绑定域名
引入js文件
在需要调用JS接口的页面引入如下JS文件，（支持https）：http://res.wx.qq.com/open/js/jweixin-1.0.0.js

请注意，如果你的页面启用了https，务必引入 https://res.wx.qq.com/open/js/jweixin-1.0.0.js ，否则将无法在iOS9.0以上系统中成功使用JSSDK
通过config接口注入权限验证配置
这一步是通过用当前的url向后台发请求拿到一系列参数。即后台会拿我的url去向微信进行认证。这里需要注意的事用于验证的当前的url写法，

let url = location.href.split(‘#’)[0];

务必写成以上形势。否则会在进行config时报invalid signature，

确认url是页面完整的url(请在当前页面alert(location.href.split(‘#‘)[0])确认)，包括‘http(s)://‘部分，以及‘？‘后面的GET参数部分,但不包括‘#‘hash后面的部分。
确保你获取用来签名的url是动态获取的，动态页面可参见实例代码中php的实现方式。如果是html的静态页面在前端通过ajax将url传到后台签名，前端需要用js获取当前页面除去‘#‘hash部分的链接（可用location.href.split(‘#‘)[0]获取,而且需要encodeURIComponent），因为页面一旦分享，微信客户端会在你的链接末尾加入其它参数，如果不是动态获取当前链接，将导致分享后的页面签名失败。
注意这里的动态，不要随便自己拼接，同时encodeURIComponent。

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

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

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

wx.ready (()=> {
           // alert(‘ready‘);
           //$(‘#onMenuShareAppMessage‘).on(‘click‘, ()=> {
                // 分享给朋友
                wx.onMenuShareAppMessage({
                  title: ‘‘,
                  desc: ‘‘,
                  link: shareUrl,
                  imgUrl: ‘‘,
                  trigger: function (res) {
                    // alert(‘用户点击发送给朋友‘);
                  },
                  success: function (res) {
                    alert(‘已分享‘);
                  },
                  cancel: function (res) {
                    alert(‘已取消‘);
                  },
                  fail: function (res) {
                    alert(JSON.stringify(res));
                  }
                });
            //});
            //分享到朋友圈
            wx.onMenuShareTimeline({
                title: ‘‘, // 分享标题
                link: shareUrl, // 分享链接
                imgUrl: ‘‘, // 分享图标
                success: function () {
                    alert(‘已分享‘);
                    // alert($(‘.no-num‘).html());
                },
                cancel: function () {
                    alert(‘已取消‘);
                    // 用户取消分享后执行的回调函数
                    // alert(‘取消‘);
                }
            });
        });

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

config信息验证失败会执行error函数，如签名过期导致验证失败，具体错误信息可以打开config的debug模式查看，也可以在返回的res参数中查看

wx.error((res)=> {
      alert(res.errMsg);
})

6.基础接口

分享到朋友圈接口

wx.onMenuShareTimeline({
    title: ‘‘, // 分享标题
    link: ‘‘, // 分享链接
    imgUrl: ‘‘, // 分享图标
    success: function () {
        // 用户确认分享后执行的回调函数
    },
    cancel: function () {
        // 用户取消分享后执行的回调函数
    }
});

分享给好友的接口

wx.onMenuShareAppMessage({
    title: ‘‘, // 分享标题
    desc: ‘‘, // 分享描述
    link: ‘‘, // 分享链接
    imgUrl: ‘‘, // 分享图标
    type: ‘‘, // 分享类型,music、video或link，不填默认为link
    dataUrl: ‘‘, // 如果type是music或video，则要提供数据链接，默认为空
    success: function () {
        // 用户确认分享后执行的回调函数
    },
    cancel: function () {
        // 用户取消分享后执行的回调函数
    }
});

如果这里需要在分享的内容中加入用ajax异步请求拿到的内容，必须在ajax请求返回后的成功函数中再调用一次该分享接口，但是必须将分享接口放在wx.ready函数中，不能单独调用。因为客户端分享操作是一个同步操作，这时候使用 ajax的数据还没有返回。

7. 这些步骤看起来似乎比较简单，但是调试的过程中难免会遇到很多问题，因为jssdk接口还是有很多的限制的。一不小心就踩到了坑。

8. 最后，我将这个接口进行了一下封装。

‘use strict‘;
let wxDefaultOptions = {
    debug: true,
    appId: ‘‘,
    timestamp: 0,
    nonceStr: ‘‘,
    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‘
  ]
};
//let shareUrl = ‘http://xxx‘ + location.pathname;

let getWxParam = (url, wxOptions) => {
    let url = location.href.split(‘#‘)[0];
   url = encodeURIComponent(url);
    let promise = new Promise((resolve, reject)=> {
        $.ajax({
            type:‘GET‘,
            url: ‘http://xxx/xxx?param=‘+url,
            dataType: ‘jsonp‘
        })
        .then((data)=> {
            let wxParam = data;
            console.log(wxParam);
            wxOptions.appId = ‘wxeb5c3f4a03b880f0‘;
            wxOptions.timestamp = wxParam.timestamp;
            wxOptions.nonceStr = wxParam.nonceStr;
            wxOptions.signature = wxParam.signature;
            wx.config(wxOptions);
            wx.error((res)=> {
                alert(res.errMsg);
            })
            resolve();
        }, (error)=> {
            console.log(error);
        })
    });
    return promise;
}

//分享到朋友圈
let shareSocial = (param)=> {
    wx.onMenuShareTimeline({
          title: param.title, // 分享标题
          link: param.link, // 分享链接
          imgUrl: param.imgUrl, // 分享图标
          success: function () {
              // 用户确认分享后执行的回调函数
              param.suCallback();
          },
          cancel: function () {
              // 用户取消分享后执行的回调函数
              param.failCalback();
          }
        });
}
//分享给好友
let shareToFriends = (param) => {

    wx.onMenuShareAppMessage({
          title: param.title,
          desc: param.desc,
          link: param.link,
          imgUrl: param.imgUrl,
          trigger: function (res) {

          },
          success: function (res) {
            param.suCallback();
          },
          cancel: function (res) {
          },
          fail: function (res) {
            param.failCalback();
            console.alert(JSON.stringify(res));
          }
    });
}
//title,desc,link,imgUrl,suCallback, failCalback
let jssdk = (param) => {
  wx.ready(()=> {
        //分享到朋友圈
        shareSocial(param);
        shareToFriends(param);

  })
}

function callWx(param, wxoptions) {
    getWxParam(param.url, wxOptions).then(()=> {
        jssdk(param);
    })
}
//param = {url: ‘‘, title:‘‘,desc:‘‘,link:‘‘,imgUrl:‘‘,suCallback:func, failCalback: func}
module.exports = {
    wxDefaultOptions,//更改配置
    callWx, //默认配置，进行config配置 和ready后定制微信分享内容,
}

时间： 2024-07-28 19:39:31

微信jssdk总结

微信jssdk总结的相关文章

微信JS-SDK实现上传图片功能

微信JS-SDK说明文档及常见问题处理

微信JSSDK与录音相关的坑

微信jssdk已无力吐槽

使用微信JSSDK自定义微信分享标题、描述、和图标

微信JS-SDK接口 + FLASK实现图片上传

微信JS-SDK

微信js-sdk调用

微信 JSSDK .NET版

配置并学习微信JS-SDK（1）