"api工厂" 使用手册

api接口开箱即用,云后台管理,助力前端,解放后端开发;

不懂编程也能独立开发应用,小步快跑,快速创业!

旨为更懂你!

微信公众号js-sdk签名方法

https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/JS-SDK.html


请先查阅官方的说明文档,本教程主要是帮助你如何获取当前页面的签名数据,签名正确有方可调用文档中的各种js方法:


image.png


签名正确后,将会回调 wx.ready 方法,反之会调用 wx.error 方法,开发阶段,建议设置 debug: true ,将会输出丰富的调试信息。


签名接口


详见前端接口文档中的:“微信公众号js-sdk获取sign签名” 接口:


image.png


示例代码


下面将举例 vue 开发模式下的使用方法:


vue调用分享

npm install weixin-js-sdk --save 

安装好插件以后,创建一个公共js文件,方便后续调用:


wxShare.js


/* eslint-disable */
import Vue from 'vue';
import wx from 'weixin-js-sdk';

//存储各个链接的签名信息
const signMap = new Map(); 
// 设置默认的分享信息,因为如分享图、请求授权项、隐藏授权项等基本不变,此处设置直接引用,避免使用时繁琐设置
const defaultWxShareConfig = { 
    title: "分享标题(通常是动态的)", 
    desc: '分享描述(通常是动态的)',
    link: window.location.href,
    imgUrl: '分享图片地址',
    jsApiList: ['onMenuShareTimeline', 'onMenuShareAppMessage', 'hideMenuItems', 'closeWindow'],
    hideMenuList: ['menuItem:editTag', 'menuItem:delete', 'menuItem:originPage', 'menuItem:readMode','menuItem:openWithQQBrowser', 'menuItem:openWithSafari', 'menuItem:share:email', 'menuItem:share:brand']
} 
//存储临时的分享信息
const wxShareConfig = {
    
}
 
const wxShare = {
    //各个页面加载后,调用此方法,传入的参数config是对象,其属性参考defaultWxShareConfig
    updateWxShareConfig(config = {}) {
        wxShareConfig.title = config.title || defaultWxShareConfig.title;
        wxShareConfig.desc = config.desc || defaultWxShareConfig.desc;
        wxShareConfig.link = config.link || defaultWxShareConfig.link;
        wxShareConfig.imgUrl = config.imgUrl || defaultWxShareConfig.imgUrl;
        wxShareConfig.jsApiList = config.jsApiList || defaultWxShareConfig.jsApiList;
        wxShareConfig.hideMenuList = config.hideMenuList || defaultWxShareConfig.hideMenuList;

        var authUrl = window.location.href
        const ua = navigator.userAgent
        const isAndroid = ua.indexOf('Android') > -1 || ua.indexOf('Adr') > -1
        const isiOS = !!ua.match(/\(i[^;]+;( U;)? CPU.+Mac OS X/)
        if (isiOS) {
            authUrl = 'ios系统,授权地址必须使用第一次打开时候的地址,中途换的地址不识别'
        }
        //判断是否已经签名了
        if (signMap.has(authUrl)) {
            this._wxConfigJSSDK(signMap.get(authUrl), wxShareConfig);
        } else {
            this.wxShareAuth(authUrl);
        }
 
    },
 
    //从服务器获取某分享链接的签名信息,并存储起来
    async wxShareAuth(authUrl) {
        //此处我使用的是自己封装的网络请求方法
        var postData = {
            url: authUrl
        }
        const res = await requestApi('/gooking/wx/jssdk/sign', 'post', postData)
        if (res.code == 0) {
            //分享链接授权签名信息
            const sign = res.data;
            signMap.set(authUrl, sign);
            this._wxConfigJSSDK(sign);
        }
    },
 
    //将签名信息更新到微信的SDK中
    _wxConfigJSSDK(shareSign) {
        wx.config({
            debug: false,
            appId: shareSign.appid,
            timestamp: shareSign.timestamp,
            nonceStr: shareSign.noncestr,
            signature: shareSign.sign,
            jsApiList: ['onMenuShareAppMessage', 'onMenuShareTimeline']
        })
        // config信息验证后会执行ready方法,所有接口调用都必须在config接口获得结果之后,config是一个客户端的异步操作,所以如果需要在页面加载时就调用相关接口,则须把相关接口放在ready函数中调用来确保正确执行。对于用户触发时才调用的接口,则可以直接调用,不需要放在ready函数中。
        wx.ready(function() {
            const {title,desc,link,imgUrl} = wxShareConfig;
            wx.onMenuShareAppMessage({
                title,
                desc,
                link,
                imgUrl,
                success: function() {
                    console.log("分享成功");
                },
                fail: function() {
                    console.log("分享失败");
                },
                cancel: function() {
                    console.log("取消分享");
                }
            })
            wx.onMenuShareTimeline({
                title,
                link,
                imgUrl,
                success: function() {
                    console.log("分享成功");
                },
                cancel: function() {
                    console.log("取消分享");
                }
            })
            
        });
                  
        // config信息验证失败会执行error函数,如签名过期导致验证失败,具体错误信息可以打开config的debug模式查看,也可以在返回的res参数中查看,对于SPA可以在这里更新签名。    
        wx.error(function(res) {
            console.log("分享失败: error", res);
        });
        
    }
}
//导出工具类
export default wxShare;
//将工具类添加到Vue静态方法方便调用
Vue.prototype.$wxShare = wxShare;

上述代码中,调用接口的代码,根据你自己的实际情况调用


main.js 中全局引入:


import './utils/wxShare'

需要分享的页面,直接调用:

this.$wxShare.updateWxShareConfig({
    title: '分享标题',
    desc: '分享介绍',
    imgUrl: '分享图片地址',
    link:  '链接地址'
})


Copyright © 杭州于芯科技有限公司

浙ICP备15041833号