H5游戏接入微信JSSDK

目的:实现微信图文分享功能

文档:

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

一、公众号配置

微信公众号管理后台:开发 -> 基本配置

1、获取:  AppID 和 AppSecret

2、将后台申请微信token和签名的服务器的ip添加到IP白名单中。

3、公众号需要申请认证,才能获取分享的权限

4、h5发布的域名配置

将测试域名和正式域名添加到JS接口安全域名。

添加的域名根目录必须放入微信校验文件,才可以配置通过


二、H5工程中接入SDK

1、head中引入


2、判断微信环境

      var obj = {

        "isIos": false,

        "isWeChat": false,

        "audio": media

      }


      let ua = window.navigator.userAgent.toLowerCase();

      if (ua.match(/wxwork/i) == 'wxwork') {

    //企业微信

        obj.isWeChat = false;

      } else if (ua.match(/MicroMessenger/i) == 'micromessenger') {

    //微信

        obj.isWeChat = true;

      } else {

    //其他环境

        obj.isWeChat = false;

      }


     window["GAME_HTML_INFO"] = obj;



3、微信环境请求微信签名

        const DEVELOP = {

          /** 签名请求地址 */

          ip: 'https://xxxxxxxx/edu-game-math-core/core/operate/getH5Ticket',

          /** 分享图地址 */

          imgUrl: 'https://xxxxxxxx/test/games/EduGamesSlicingH5/h5/share/001.png'

        }


        const RELEASE = {

          /** 签名请求地址 */

          ip: 'https://xxxxxxx/edu-game-math-core/core/operate/getH5Ticket',

          /** 分享图地址 */

          imgUrl: 'https://xxxxxxxx/games/EduGamesSlicingH5/h5/share/001.png'

        }


        /** 当前环境 */

        const env = RELEASE;

发送get请求到我们自己的服务器,获取签名

        function GET(url, reqData, callback) {

          url += "?";

          for (var item in reqData) {

            url += item + "=" + reqData[item] + "&";

          }

          console.log(url);

          var xhr = new XMLHttpRequest();

          xhr.onreadystatechange = function () {

            if (xhr.readyState == 4) {

              if (xhr.status >= 200 && xhr.status < 400) {

                var response = xhr.responseText;

                console.log(response)

                if (response) {

                  var responseJson = JSON.parse(response);

                  callback(responseJson);

                } else {

                  console.log("返回数据不存在")

                  callback(false);

                }

              } else {

                console.log("请求失败")

                callback(false);

              }

            }

          };

          xhr.open("GET", url, true);

          xhr.send();

        }


4、设置微信分享

 GET(ip, { url: localUrl }, (ret) => {


          var APPID = 'wx1111111111111111111111111111';

          var title = '寻找对称轴';

          var desc = '5分钟玩转轴对称图形,将抽象变为形象,原来数学如此有趣~';

          var imgUrl = env.imgUrl;


          var noncestr = ret.data.nonceStr;

          var timestamp = ret.data.timestamp;

          var link = ret.data.url;

          var signature = ret.data.signature;


  wx.config({

            debug: false,

            appId: APPID,

            timestamp: timestamp,

            nonceStr: noncestr,

            signature: signature,

            jsApiList: [

              'checkJsApi',

              'updateAppMessageShareData',

              'updateTimelineShareData',

              'onMenuShareTimeline',

              'onMenuShareAppMessage',

              'onMenuShareQQ',

              'onMenuShareWeibo',

              'onMenuShareQZone'

            ]

          });



  wx.checkJsApi({

            jsApiList: [

              'checkJsApi',

              'updateAppMessageShareData',

              'updateTimelineShareData',

              'onMenuShareTimeline',

              'onMenuShareAppMessage',

              'onMenuShareQQ',

              'onMenuShareWeibo',

              'onMenuShareQZone'

            ],

            success: function (res) {

              console.log(JSON.stringify(res));

            }

          });


  wx.ready(function () {

            window["WECHAT_READY"] = true;

            if (window["GAME_READY"] === true) {

              playMusic();

            }


            wx.updateAppMessageShareData({

              title: title, // 分享标题

              desc: desc, // 分享描述

              link: link, // 分享链接,该链接域名或路径必须与当前页面对应的公众号JS安全域名一致

              imgUrl: imgUrl, // 分享图标

              success: function () {

                // 设置成功

              }

            })


            wx.updateTimelineShareData({

              title: title, // 分享标题

              link: link, // 分享链接,该链接域名或路径必须与当前页面对应的公众号JS安全域名一致

              imgUrl: imgUrl, // 分享图标

              success: function () {

                // 设置成功

              }

            })


            wx.onMenuShareTimeline({

              title: title, // 分享标题

              link: link, // 分享链接,该链接域名或路径必须与当前页面对应的公众号JS安全域名一致

              imgUrl: imgUrl, // 分享图标

              success: function () {

                // 用户点击了分享后执行的回调函数

              }

            })


            wx.onMenuShareAppMessage({

              title: title, // 分享标题

              desc: desc, // 分享描述

              link: link, // 分享链接,该链接域名或路径必须与当前页面对应的公众号JS安全域名一致

              imgUrl: imgUrl, // 分享图标

              type: '', // 分享类型,music、video或link,不填默认为link

              dataUrl: '', // 如果type是music或video,则要提供数据链接,默认为空

              success: function () {

                // 用户点击了分享后执行的回调函数

              }

            });


            wx.onMenuShareQQ({

              title: title, // 分享标题

              desc: desc, // 分享描述

              link: link, // 分享链接

              imgUrl: imgUrl, // 分享图标

              success: function () {

                // 用户确认分享后执行的回调函数

              },

              cancel: function () {

                // 用户取消分享后执行的回调函数

              }

            });


            wx.onMenuShareWeibo({

              title: title, // 分享标题

              desc: desc, // 分享描述

              link: link, // 分享链接

              imgUrl: imgUrl, // 分享图标

              success: function () {

                // 用户确认分享后执行的回调函数

              },

              cancel: function () {

                // 用户取消分享后执行的回调函数

              }

            });


            wx.onMenuShareQZone({

              title: title, // 分享标题

              desc: desc, // 分享描述

              link: link, // 分享链接

              imgUrl: imgUrl, // 分享图标

              success: function () {

                // 用户确认分享后执行的回调函数

              },

              cancel: function () {

                // 用户取消分享后执行的回调函数

              }

            });


          });


          wx.error(function (res) {

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

          });


        });


}


5、服务器需求

(1)向微信请求获取access_token(有效期7200秒)

请求地址及参数:

https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=公众号AppID &secret=公众号密钥

调试连接:

https://mp.weixin.qq.com/debug/cgi-bin/apiinfo?t=index&type=%E5%9F%BA%E7%A1%80%E6%94%AF%E6%8C%81&form=%E8%8E%B7%E5%8F%96access_token%E6%8E%A5%E5%8F%A3%20/token

注意事项:必须将请求的服务器ip添加到公众号后台管理的白名单才能请求成功。

(2)向微信请求获取jsapi_ticket(有效期7200秒)

请求地址及参数:

https://api.weixin.qq.com/cgi-bin/ticket/getticket?access_token=ACCESS_TOKEN&type=jsapi


(3)签名

签名校验工具:

https://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=jsapisign

签名算法:

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

(4)请求参数及返回值:

Req: {

url: location.href.split('#')[0]

}

Ret:{

data:{

nonceStr:string,

tmestamp:string,

url:string,

signature: string

}

}


6、注意事项:

(1)、服务器IP必须加入白名单

(2)、请求签名的地址必须和当前访问网页的地址完全一致

(3)、游戏地址的域名必须配置再js安全域名中

(4)、分享图的地址,域名必须配置再js安全域名中

(5)、appid前后端必须一致,AppSecret不允许放到前端代码中


7、电脑调试方法

(1)、安装微信开发者工具

(2)、打开公众号网页

(3)、输入需调试的地址即可


8、微信分享图配置

在web-mobile目录中添加share文件夹,将分享图放入其中,每次发布版本,分享图会上传到服务器中项目目录下。并在代码中配置分享地址。

测试地址:

imgUrl: 'https://xxxxxxxxxxx/test/games/EduGamesSlicingH5/h5/share/001.png'

正式地址:imgUrl: 'xxxxxxxxxxx/games/EduGamesSlicingH5/h5/share/001.png'

你可能感兴趣的:(H5游戏接入微信JSSDK)