微信内分享网页自定义标题,图片,描述

背景描述:

公司有个需求,将一个微网站链接,网页,外部网站在微信中打开,然后分享给其他人,但是在分享过程中发现分享完微信中显示的是这样子,

      

标题有了,但是简介显示网址,图片没有,而我想要的是上面另一种样式。标题,简介和图片都可自定义的。由此产生了这篇文章。

必备要求:

  1. 有公众号,公众号必须认证过,如果不确定认证没认证过,就看下图,在微信公众平台https://mp.weixin.qq.com最下面接口权限中看分享接口后面状态是已获得还是未获得,已获得才可以用,未获得说明没有认证过,就不用往下看了。

2.必须要有已备案的域名和服务器。实现这个功能需要调用后台接口,而且接口的域名和分享网站,网页的域名是一样的。

参考资料:

  1. 简书网页分享到微信https://www.jianshu.com/p/bf743d52c6d3
  2. 微信公众平台https://mp.weixin.qq.com
  3. 微信JS-SDK说明文档

实现过程:

上面准备工作做完以后开始实现。

  1. 首先可以先阅读以下微信的JS-SDK的说明文档
    微信JS-SDK说明文档
  2. 绑定域名,登录微信公众平台,进入“公众号设置”的功能设置里面填写js接口安全域名,这个是要填写的是你微信浏览器要打开的域名地址。不能添加IP地址。

    设置时候点击设置里面有说明,如下图

    画红圈的要注意,下载完的那个文件放进去一定要在浏览器能访问才能进行下一步。我是把这个文件放到tomcat下面的ROOT文件夹中,可以直接域名后面加文件名访问。

    网页访问的效果:
  3. 在需要调用js接口的页面接入JS文件 http://res.wx.qq.com/open/js/jweixin-1.4.0.js  ,1.4.0是目前最新版本。网上有些地方用的是1.2.0.js,那个已经弃用了。
  4. 通过config接口注入权限并验证配置
    wx.config({
        debug: true, // 开启调试模式,调用的所有api的返回值会在客户端alert出来,若要查看传入的参数,可以在pc端打开,参数信息会通过log打出,仅在pc端时才会打印。
        appId: '', // 必填,公众号的唯一标识
        timestamp: , // 必填,生成签名的时间戳
        nonceStr: '', // 必填,生成签名的随机串
        signature: '',// 必填,签名
        jsApiList: [] // 必填,需要使用的JS接口列表
    });

     

  5. 这一步算是整个步骤中最关键的一步,必须正确的配置信息才可以进行调用JS-SDK。

获取配置

 获取签名实际是需要四步

1. 根据appId和appsecret获取access_token;

2. 使用access_token获取jsapi_ticket;

3. 使用时间戳,随机数,jsapi_ticket和要访问的url按照签名算法拼接字符串;

4. 对第三步的字符串进行SHA1加密,得到签名;
这步是在服务器后台写的一个工具类里面实现的,测试时候可以先后台获取,前台页面将参数写死,实际用的时候最好动态获取这些数据。如果参数写死的话会二次分享会出问题,在微信中第二次分享,微信会自己加一个参数上去,这样点开在分享的时候签名和url会匹配不上。

第一步,获取access_token

appId和appsecret可以在微信公众平台--开发-基本配置中查找

/**
	 * 第一步,获取access_token
	 *	appId和appsecret可以在微信公众平台--开发-基本配置中查找
	 */
	public static String getAccess_token(String appId, String appSecret){

        String url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=" + appId + "&secret=" + appSecret;
        String accessToken = null;
        try
        {
            URL urlGet = new URL(url);
            HttpURLConnection http = (HttpURLConnection) urlGet.openConnection();
            http.setRequestMethod("GET"); // 必须是get方式请求
            http.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
            http.setDoOutput(true);
            http.setDoInput(true);
            System.setProperty("sun.net.client.defaultConnectTimeout", "30000");// 连接超时30秒
            System.setProperty("sun.net.client.defaultReadTimeout", "30000"); // 读取超时30秒
            http.connect();
            InputStream is = http.getInputStream();
            int size = is.available();
            byte[] jsonBytes = new byte[size];
            is.read(jsonBytes);
            String message = new String(jsonBytes, "UTF-8");
            JSONObject jsonObj = JSONObject.fromObject(message);
            accessToken = jsonObj.getString("access_token");
        }
        catch (Exception e)
        {
            e.printStackTrace();
        }
        return accessToken;
    }
	

第二步 获取jsapi_ticket

/**
     * 第二步:获得ACCESS_TICKET
     * 
     * @Title: ACCESS_TICKET
     * @Description: 获得ACCESS_TICKET
     * @param @return 设定文件
     * @return String 返回类型
     * @throws
     */
    public static String getAccess_ticket(String access_token) {  
        String ticket = null;  
        String url = "https://api.weixin.qq.com/cgi-bin/ticket/getticket?access_token="+ access_token +"&type=jsapi";//这个url链接和参数不能变  
        try {  
            URL urlGet = new URL(url);  
            HttpURLConnection http = (HttpURLConnection) urlGet.openConnection();  
            http.setRequestMethod("GET"); // 必须是get方式请求  
            http.setRequestProperty("Content-Type","application/x-www-form-urlencoded");  
            http.setDoOutput(true);  
            http.setDoInput(true);  
            System.setProperty("sun.net.client.defaultConnectTimeout", "30000");// 连接超时30秒  
            System.setProperty("sun.net.client.defaultReadTimeout", "30000"); // 读取超时30秒  
            http.connect();  
            InputStream is = http.getInputStream();  
            int size = is.available();  
            byte[] jsonBytes = new byte[size];  
            is.read(jsonBytes);  
            String message = new String(jsonBytes, "UTF-8");  
            JSONObject demoJson = JSONObject.fromObject(message);  
            System.out.println("JSON字符串:"+demoJson);  
            ticket = demoJson.getString("ticket");  
            is.close();  
        } catch (Exception e) {  
                e.printStackTrace();  
        }  
        return ticket;  
    }  

这里拿到对应的jsapi_ticket之后就可以进行参数排序和拼接字符串并加密

第三步:SHA1加密

 /**
     * 第三步:SHA1加密
     */
    public static String SHA1(String decript) {  
        try {  
            MessageDigest digest = java.security.MessageDigest.getInstance("SHA-1");  
            digest.update(decript.getBytes());  
            byte messageDigest[] = digest.digest();  
            // Create Hex String  
            StringBuffer hexString = new StringBuffer();  
            // 字节数组转换为 十六进制 数  
                for (int i = 0; i < messageDigest.length; i++) {  
                    String shaHex = Integer.toHexString(messageDigest[i] & 0xFF);  
                    if (shaHex.length() < 2) {  
                        hexString.append(0);  
                    }  
                    hexString.append(shaHex);  
                }  
                return hexString.toString();  
       
            } catch (NoSuchAlgorithmException e) {  
                e.printStackTrace();  
            }  
            return "";  
    }  

加密算法转载自:http://www.open-open.com/lib/view/open1392185662160.html

第四步: 获取签名

/**
     * 第4步获取签名
     * 公众号
   	 * String appId="wx86b6597*****";
     * String appSecret="aeb428ffb9a8a071fc4******";
     */
    public static void main(String[] args) { 
    	String appId="wx118d752d*****";  //这里写自己的appId
    	String appSecret="947cce9d2808bca0976788d4*****";
        //1、获取AccessToken  
        String accessToken = getAccess_token(appId, appSecret);  
          
        //2、获取Ticket  
        String jsapi_ticket = getAccess_ticket(accessToken);  
          
        //3、时间戳和随机字符串  
        String noncestr = UUID.randomUUID().toString().replace("-", "").substring(0, 16);//随机字符串  
        String timestamp = String.valueOf(System.currentTimeMillis() / 1000);//时间戳  
          
        System.out.println("accessToken:"+accessToken+"\njsapi_ticket:"+jsapi_ticket+"\n时间戳:"+timestamp+"\n随机字符串:"+noncestr);  
          
        //4、获取url  
        String url="http://api.groupusonline.com/txrtWeb/test.html";  
        /*根据JSSDK上面的规则进行计算,这里比较简单,我就手动写啦 
        String[] ArrTmp = {"jsapi_ticket","timestamp","nonce","url"}; 
        Arrays.sort(ArrTmp); 
        StringBuffer sf = new StringBuffer(); 
        for(int i=0;i<ArrTmp.length;i++){ 
            sf.append(ArrTmp[i]); 
        } 
        */  
          
        //5、将参数排序并拼接字符串  
        String str = "jsapi_ticket="+jsapi_ticket+"&noncestr="+noncestr+"&timestamp="+timestamp+"&url="+url;  
         
        //6、将字符串进行sha1加密  
        String signature =SHA1(str);  
        System.out.println("参数:"+str+"\n签名:"+signature);  
    } 

上面是工具类里面的内容,接下来在控制类里面写调用接口。上面的这些内容就可以算出来签名和一些配置需要的东西,测试时候可以直接算出来在html页面里面将参数写死。

第五步:调用接口

/**
 * 微信分享相关
 * Created by yf on 2019/6/20.
 */
@Controller
@ResponseBody
@RequestMapping("wx")
public class WeChatHander {

    private Logger log = LoggerFactory.getLogger(WeChatHander.class);
    //公众号信息
    private static final String appId = "wx118d****12221";
    private static final String appSecret="947cce9***88d4b898db3e";
    //微信自动义分享
    @RequestMapping("share")
    public Object share(HttpSession session,String URL){
        String url="";
        //需要转换解码url
        try {
            url = java.net.URLDecoder.decode(URL,"UTF-8");
        } catch (UnsupportedEncodingException e) {
            e.printStackTrace();
        }
        //获取access_token,这里要从存到session,生成这个参数的wx调用接口有调用次数限制。这部分存session,下面的下载文件里面没有更新,自己添加进去吧,不然接口次数很快就用完了。
        String aeecss_token=(String) session.getAttribute("aeecss_token");
        if(aeecss_token==null){
        	aeecss_token = WeChatUtil.getAccess_token(appId, appSecret);
        	session.setAttribute("aeecss_token", aeecss_token);
        }
        //获取access_ticket
        String aeecss_ticket=(String) session.getAttribute("aeecss_ticket");
        if(aeecss_ticket==null){
        	aeecss_ticket = WeChatUtil.getAccess_ticket(aeecss_token);
        	session.setAttribute("aeecss_ticket", aeecss_ticket);
        }
        //String aeecss_ticket = WeChatUtil.getAccess_ticket(aeecss_token);
         //3、时间戳和随机字符串  
        String nonceStr = UUID.randomUUID().toString().replace("-", "").substring(0, 16);//随机字符串  
        String timestamp = String.valueOf(System.currentTimeMillis() / 1000);//时间戳  
        System.out.println("accessToken:"+aeecss_token+"\njsapi_ticket:"+aeecss_ticket+"\n时间戳:"+timestamp+"\n随机字符串:"+nonceStr);  
        //4、获取url  
        //5、将参数排序并拼接字符串  
        String str = "jsapi_ticket="+aeecss_ticket+"&noncestr="+nonceStr+"&timestamp="+timestamp+"&url="+url;   
        //6、将字符串进行sha1加密  
        String signature =WeChatUtil.SHA1(str);  
        System.out.println("参数:"+str+"\n签名:"+signature);  
        
        
        Map<String,String> map=new HashMap();
        map.put("appId",appId);
        map.put("timestamp",timestamp);
        map.put("accessToken",aeecss_token);
        map.put("ticket",aeecss_ticket);
        map.put("nonceStr",nonceStr);
        map.put("signature",signature);
    	return map;
    }
}

这样通过这个接口获取签名后把所有的信息都返回json格式了。概要的都有了,这是就可以配置config了,此时html页面中应该是:这是参数写死的时候测试用。



<script type="text/javascript">

    wx.config({
    debug: true, // 开启调试模式,调用的所有api的返回值会在客户端alert出来,若要查看传入的参数,可以在pc端打开,参数信息会通过log打出,仅在pc端时才会打印。
    appId: 'wx118d75***212221', // 必填,公众号的唯一标识
    timestamp:'1560929330' , // 必填,生成签名的时间戳
    nonceStr: 'ab1ef978a35f4d4f', // 必填,生成签名的随机串
    signature: '13159896a4f8f461e0f****9df4029818e6e',// 必填,签名
    jsApiList: [// 必填,需要使用的JS接口列表
        'updateAppMessageShareData',
        'updateTimelineShareData'
     
		], // 需要检测的JS接口列表,所有JS接口列表见附录2,
	});
    //ready
    wx.ready(function () {   //需在用户可能点击分享按钮前就先调用
    	shareData = {
    	        title: "测试标题",  // 分享标题
    	        desc: "测试描述",            // 分享描述
    	        link: "http://****.com/txrtWeb/test.html",                // 分享链接
    	        imgUrl: "http://****.com/images/logo.png",  // 分享图标
    	        success: function() {
    	          // 设置成功
    	        }
    	    };
    	    // 1.4.0 新接口 (只调用这个接口在安卓下是无效的)
    		wx.updateAppMessageShareData(shareData);
    	    wx.updateTimelineShareData(shareData);
	});            
</script>

参数从接口获取的时候如下:

<!--  Meta for OpenGraph -->
  <meta name="title" content="测试页面标题从meta获取">
  <meta name="description" content="描述">
  <!-- End -->
  <script src="include/jquery-1.7.1.min.js" language="JavaScript"></script>
  <script src="http://res2.wx.qq.com/open/js/jweixin-1.4.0.js"language="JavaScript"></script>    <!-- 微信js -->

<!--微信分享相关js -->
	<script type="text/javascript">
		var title=document.querySelector('meta[name="title"]').getAttribute('content');   //网页标题
		var desc=document.querySelector('meta[name="description"]').getAttribute('content');   //网页描述
			 $.ajax({
	             async : true,   //这里参数true和false在微信中打开会有不同效果,实际用的时候用false,用true时候测试会有提示性内容。
				 url : 'http://****.com/**/wx/share',
				 //url : 'http://localhost:8081/txrt_api/wx/share',
	             type : "POST",
	             dataType : "json", // 返回的数据类型,设置为JSONP方式	   
	             data : {
	                 URL : encodeURIComponent(window.location.href.split("#")[0])   
	             }, 
	             success: function(response, status, xhr){
	                 //console.log('状态为:' + status + ',状态是:' + xhr.statusText);
	               // alert("进来了");
					wx.config({
						debug: false, //调试阶段建议开启,关闭就不弹提示了
						appId: response.appId,//APPID
						timestamp: response.timestamp,//上面main方法中拿到的时间戳timestamp
						nonceStr: response.nonceStr,//上面main方法中拿到的随机数nonceStr
						signature: response.signature,//上面main方法中拿到的签名signature
						//需要调用的方法接口
						jsApiList: [         
                       'updateAppMessageShareData','updateTimelineShareData']
							});
					//ready
						wx.ready(function () {   //需在用户可能点击分享按钮前就先调用
							shareData = {
									title: title,  // 分享标题
									desc: desc,            // 分享描述
									link: window.location.href, // 分享链接,该链接域名或路径必须与当前页面对应的公众号JS安全域名一致
									imgUrl: "http://api.groupusonline.com/txrtWeb/images/zfshlogo.png",  // 分享图标
									success: function() {
										//alert("设置成功分享");
									  // 设置成功
									}
								};
								// 1.4.0 新接口 (只调用这个接口在安卓下是无效的)
								wx.updateAppMessageShareData(shareData);
								wx.updateTimelineShareData(shareData);
						});
	             }
	         });
    
	</script>

注意

  1. url一定要是完整的url(当前网页的URL,不包含#及其后面部分)最好是使用window.location.href.split("#")获取得到,如果传入固定的好像会报invalid signature错误,所以为了安全起见还是直接传入当前的url
  2. 这个签名的有效时间为7200秒,也就是2个小时,因此当超过两个小时候,再访问也会报invalid signature错误。但是这个我还没有遇见,并不知道这么解决,其他说是需要缓存access_token和access_ticket
  3. 另外还有一个错误:invalid url domain
    这个跟生成签名时用的url有关系,官网的说法是:
    invalid url domain当前页面所在域名与使用的appid没有绑定,请确认正确填写绑定的域名,如果使用了端口号,则配置的绑定域名也要加上端口号(一个appid可以绑定三个有效域名)
    这个url必须是:“公众号设置---功能设置----JS接口安全域名”中绑定的三个域名之一
  4. 如果以上配置都是正确,而且debug也设置为true了,在微信中访问连接会出现config:ok的界面,就说明配置成功了
  5. 有时也可以把ajax请求放在setTimeout中进行请求。

验证工具:
微信公众平台接口调试工具
微信 JS 接口签名校验工具

参考:
解决微信JS-SDK扫一扫功能接入以及出现签名无效 invalid signature
微信JS-SDK获取signature签名以及config配置

相关代码文件下载:https://download.csdn.net/download/qq_37698433/11253616

 


求打赏

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章