微信公众平台开发概述

时间 2019-11-11

标签微信公众平台开发概述繁體版

原文原文链接

本文大概介绍了使用asp.net mvc+entity framework 开发微信平台公众号（订阅号、服务号）的大概流程。javascript

1、微信公众平台基本知识介绍

1.1请求流程

微信公众平台是基于HTTP请求和响应html

1.2 通信格式

1.2.1消息 XML

 
       < 
       xml 
       > 
      
 
            
       < 
       ToUserName 
       ><![CDATA[gh_a96a4a619366]]></ 
       ToUserName 
       > 
      
 
            
       < 
       FromUserName 
       ><![CDATA[olPjZjsXuQPJoV0HlruZkNzKc91E]]></ 
       FromUserName 
       > 
      
 
            
       < 
       CreateTime 
       >1357986928</ 
       CreateTime 
       > 
      
 
            
       < 
       MsgType 
       ><![CDATA[text]]></ 
       MsgType 
       > 
      
 
            
       < 
       Content 
       ><![CDATA[TNT2]]></ 
       Content 
       > 
      
 
            
       < 
       MsgId 
       >5832509444155992350</ 
       MsgId 
       > 
      
 
       </ 
       xml 
       > 
      

1.2.2其余接口 JSON

{ "subscribe": 1, "openid": "o6_bmjrPTlm6_2sgVt7hMZOPfL2M", "nickname": "Band", "sex": 1, "language": "zh_CN", "city": "广州", "province": "广东", "country": "中国", "headimgurl": "http://wx.qlogo.cn/mmopen/g3MonUZtNHkdmzicIlibx6iaFqAc56vxLSUfpb6n5WKSYVY0ChQKkiaJSgQ1dZuTOgvLLrhJbERQQ4eMsv84eavHiaiceqxibJxCfHe/0", "subscribe_time": 1382694957 }

1.3 可能会踩到的一些坑

每条XML信息都有大小限制，如文本信息，建议Content内容不要超过600字。
上图中，步骤2开始以后，微信服务器有一个等待时间：5秒，若是在这个时间内没有进行到步骤4，那么这个请求将会被关闭（包括数据传输的时间）。也就是说若是超过期间，即便网站服务器返回了数据，客户端也没法收到回复。
在文本消息中，是容许添加<a>标签来放置链接的，可是有许多朋友测试以后发现iOS没问题，Android上连接没法点击，其实缘由是（至少目前为止）：Android的微信客户端对<a>标签格式的断定比较严格，请严格按照这个格式书写：<a href="http://xxxx">内容</a>，href后不要使用单引号，也不要添加其余属性。
上面XML节点中的FromUserName即微信用户的OpenId，对于同一个公众帐号，这个OpenId的前6位是一致的，而且在整个公众平台的记录中也是惟一的。也就是说同一个用户关注了两个不一样的公众帐号，他会有两个不一样的OpenId。
CreateTime使用的是Unix时间，所以若是使用C#的话，须要作一个转换。
尽可能保持官方API中XML节点的顺序，之前微信服务器是使用节点位置的方式读取信息的（node[0]），而非节点名称，如今这个问题彷佛有好转，不过仍是要当心（￥…………&%&……）。
因为这种特殊的通信方式，（至少目前为止）全部请求必须从客户端先发起，不要期望光使用API或SDK能够实现由网站服务器主动推送消息到客户端（固然其余办法仍是有的，好比模拟登录）。
微信的网页中的Cookie是比较特殊的，仅会短暂的存在，貌似是不能设置它在很长的时间内不过时的，因此，慎用！

1.4 微信公众平台分类

1.4.1 服务号

一个月能够推送4条消息
拥有一些高级接口（Oauth、微信支付等）
推送的消息如好友消息同样单独展现

1.4.2 订阅号

天天能够推送1条消息
只拥有一些基本的权限
推送的消息在订阅号“文件夹”中展现

1.4.3 企业号

　没有研究过

1.4.4 开发者测试号

几乎拥有全部权限，无支付权限，不能推送消息

1.5微信开发概况

目前市场上常见的对微信所作的开发主要分为两部分：java

1.5.1微网站

其实就是一个手机网站，只是不少时候须要调用微信的Oauth受权接口替代传统的用户登陆和注册
能够调用微信JS SDK的相关功能
能够嵌入微信支付功能

1.5.2自动回复消息

用户主动向微信公众平台发送内容时，平台自动响应
获取用户的地理位置信息，作一些响应
用户点击菜单时的响应
多客服系统

二、开发步骤

•定义好处理微信请求的URL

•微信后台启用开发者模式，填写相关URL

•查看微信相关文档，进行开发

•开发完成，部署到外网服务器中测试

3、Senparc.Weixin.MP SDK

3.1简介

XX公司把微信官方提供的全部API都进行了封装并开源，使开发人员能够面向对象进行微信开发，避免了请求和调试微信的接口，从而节约大量时间node

官网地址：http://weixin.senparc.com /算法

Nuget地址：https://www.nuget.org/packages/Senparc.Weixin.MP浏览器

舒适提醒：虽然SDK封装好了不少的东西，但微信开发最终仍是以微信的官方文档为准，在须要时多看看微信文档安全

3.2 使用SDK

新建ASP.NET MVC 解决方案
引用SDK(Nuget/项目/dll方式都可)
新建一个WeixinController来接收来自微信服务器的请求，新建Index Action，提供GET/POST两种请求方式，以GET方式请求时，调用SDK的CheckSignature.Check方法，返回随机字符串（合法性验证），在后台配置URL时，会须要这个GET，以POST方式请求时，先调用CheckSignature.Check方法，而后定义一个MessageHandler对接收到的消息使用处理，最后返回一个MessageHandler。

public class WeiXinController : Controller
    {
        public static readonly string Token = WeixinInfo.Token;//与微信公众帐号后台的Token设置保持一致，区分大小写。
        /// <summary>
        /// 微信后台验证地址（使用Get），微信后台的“接口配置信息”的Url填写如：http://weixin.senparc.com/weixin
        /// </summary>
        [HttpGet]
        [ActionName("Index")]
        public ActionResult Get(string signature, string timestamp, string nonce, string echostr)
        {
            if (CheckSignature.Check(signature, timestamp, nonce, Token))
            {
                return Content(echostr); //返回随机字符串则表示验证经过
            }
            else
            {
                return Content("failed:" + signature + "," + Senparc.Weixin.MP.CheckSignature.GetSignature(timestamp, nonce, Token) + "。" +
                    "若是你在浏览器中看到这句话，说明此地址能够被做为微信公众帐号后台的Url，请注意保持Token一致。");
            }
        }

        /// <summary>
        /// 用户发送消息后，微信平台自动Post一个请求到这里，并等待响应XML。
        /// PS：此方法为简化方法，效果与OldPost一致。
        /// v0.8以后的版本能够结合Senparc.Weixin.MP.MvcExtension扩展包，使用WeixinResult，见MiniPost方法。
        /// </summary>
        [HttpPost]
        [ActionName("Index")]
        public ActionResult Post(PostModel postModel)
        {
            if (!CheckSignature.Check(postModel.Signature, postModel.Timestamp, postModel.Nonce, Token))
            {
                return Content("参数错误！");
            }
            postModel.Token = Token;
            postModel.EncodingAESKey = WeixinInfo.EncodingAESKey;//根据本身后台的设置保持一致
            postModel.AppId = WeixinInfo.AppId;//根据本身后台的设置保持一致

            //v4.2.2以后的版本，能够设置每一个人上下文消息储存的最大数量，防止内存占用过多，若是该参数小于等于0，则不限制
            var maxRecordCount = 10;

            //自定义MessageHandler，对微信请求的详细判断操做都在这里面。
            var messageHandler = new CustomMessageHandler(Request.InputStream, postModel, maxRecordCount);
             var logger = EngineContext.Current.Resolve<DefaultLogger>();
            try
            {

                /* 若是须要添加消息去重功能，只需打开OmitRepeatedMessage功能，SDK会自动处理。
                 * 收到重复消息一般是由于微信服务器没有及时收到响应，会持续发送2-5条不等的相同内容的RequestMessage*/
                messageHandler.OmitRepeatedMessage = false;
                //执行微信处理过程
                messageHandler.Execute();              
                return new WeixinResult(messageHandler);//v0.8+
            }
            catch (Exception ex)
            {
                logger.Error("微信请求错误：" + DateTime.Now.Ticks, ex);
                return Content(""); 
            }
        }
    }

3.3 处理用户发来的消息

•基本思路

重写MessageHandler中的相应方法服务器

public partial class CustomMessageHandler : MessageHandler<CustomMessageContext>
    {
    //some Code
    }

•上下文

因为是微信服务器直接发送请求到开发者服务器，故Session、Cookie均没法在微信公众平台开发中正常使用，SDK提供了WeixinContext用来处理上下文，能够在MessageHandle中使用。微信

public class CustomMessageContext : MessageContext<IRequestMessageBase, IResponseMessageBase>
    {
        public CustomMessageContext()
        {
            base.MessageContextRemoved += CustomMessageContext_MessageContextRemoved;
        }

        /// <summary>
        /// 当上下文过时，被移除时触发的时间
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        void CustomMessageContext_MessageContextRemoved(object sender, Senparc.Weixin.Context.WeixinContextRemovedEventArgs<IRequestMessageBase, IResponseMessageBase> e)
        {
            /* 注意，这个事件不是实时触发的（固然你也能够专门写一个线程监控）
             * 为了提升效率，根据WeixinContext中的算法，这里的过时消息会在过时后下一条请求执行以前被清除
             */

            var messageContext = e.MessageContext as CustomMessageContext;
            if (messageContext == null)
            {
                return;//若是是正常的调用，messageContext不会为null
            }
        }
    }

3.4 SDK提供的经常使用消息事件列表

OnTextRequest网络	文字消息
OnLocationRequest	位置消息
OnVoiceRequest	语音消息
OnVideoRequest	视频消息
OnImageRequest	图片消息
OnEvent_ClickRequest	点击菜单
OnEvent_SubscribeRequest	用户关注
OnEvent_UnsubscribeRequest	取消关注
OnEvent_ScanRequest	扫描二维码

4、微信菜单介绍

4.1 基本介绍

自定义菜单分为一级菜单和二级菜单
一级菜单数量为1-3个，即打开公众帐号直接能够看到排列在最下方的最多3个按钮。一级菜单的文字最多不能超过16字节（至关于8个汉字）
二级菜单从属于一级菜单，数量为1-5个。二级菜单的文字不最多不能超过40字节（至关于20个汉字）
当一个一级菜单下有二级菜单存在的时候，这个一级菜单按钮被点击不会有任何事件发生
能够根据后台设置的用户分组不一样，定制不一样的菜单（new）

4.2菜单类型

click：点击推事件
view：跳转URL
scancode_push：扫码推事
scancode_waitmsg：扫码推事件且弹出“消息接收中”提示框
pic_sysphoto：弹出系统拍照发图、pic_photo_or_album：弹出拍照或者相册发图
location_select：弹出地理位置选择器
media_id：下发消息（除文本消息）
view_limited：跳转图文消息URL

5、微信JS SDK

地址：

JS地址：http ://res.wx.qq.com/open/js/jweixin-1.0.0.js

文档地址：http://mp.weixin.qq.com/wiki/11/74ad127cc054f6b80759c40f77ec03db.html

经常使用功能：

分享接口监听
图片接口（上传、预览、拍照等）
判断网络状态
操做右上角菜单
微信支付 V2

使用步骤：

绑定域名
　先登陆微信公众平台进入“公众号设置”的“功能设置”里填写“JS接口安全域名”。
引入JS文件

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

调用接口

引用后，调用相应接口就ok了。

6、微信支付介绍

6.1 简介

微信支付分为V2 和V3 版本，V2版本嵌入在其JSSDK中，V3版本直接嵌入在微信中，无需引用任何文件。

支付方式分为JS支付和扫码支付，我只尝试过JS支付，并无尝试扫码支付，因此下面所说的都是JS支付(V3)，扫码支付听说是还简单一些。JS支付最终效果跟你用微信冲话费的流程是同样的，你能够脑海中YY一下。

测试号没有微信支付接口，这是很是恶心的地方，你想玩玩支付？那你去注册个公司吧~而后交点钱，注册个服务号，再核对公司公账，而后！@#￥#￥%此处省略一万步~

特别须要注意的是，在开发过程当中，微信的文档是仅供参考的，他们目前对文档管理的很是混乱，你根本不知道哪一个文档是给哪里用的，我也没有太好的办法，只能是多折腾吧~

6.2 准备工做

前提假设咱们已经弄到了一个有支付功能的帐号，下面的

6.2.1 配置JS接口安全域名

登录微信公众平台后台，进入公众号设置页面，找到功能设置，下面有个JS接口安全域名（貌似必定要是备案过的域名才能够）

6.2.2 配置微信支付配置项

进入左侧微信支付，找到开发配置，配置测试受权目录，并把本身的微信帐号添加到测试白名单

MVC，若是支付页面的Action是Index的话，测试受权目录配置要配置到上一级，亲测的结果是，个人支付目录是:http://xxx.com/payment/（payment是Controller，Action是index,可是url中没有体现）因此配置的时候，只须要配置到域名就能够了，可是要加上/，我这个最终配置的测试受权目录是:http://xxx.com/

6.2.3 Codding

代码要处理的流程有:

生成支付商品页面
生成appId、timeStamp、nonceStr、package、paySign等一系列的支付签名须要的东西，并提供给支付页面
JS调用微信的接口（V3）

<script language="javascript" type="text/javascript">
    // 当微信内置浏览器完成内部初始化后会触发WeixinJSBridgeReady事件。
    function jsApiCall() {
        WeixinJSBridge.invoke(
        'getBrandWCPayRequest',
         {
             "appId": "@ViewData["appId"]", //公众号名称，由商户传入
             "timeStamp": "@ViewData["timeStamp"]", //时间戳
             "nonceStr": "@ViewData["nonceStr"]", //随机串
             "package": "@Html.Raw(ViewData["package"])",//扩展包
             "signType": "MD5", //微信签名方式:MD5
             "paySign": "@ViewData["paySign"]" //微信签名
         },//josn串
         function (res) {
             if (res.err_msg === "get_brand_wcpay_request:ok") {
                window.location.href = '@Url.Action("PaySuccess", new { orderNumber = Model.OrderNum })';
             }
         }
         );
    }

    function callpay() {
        if (typeof WeixinJSBridge == "undefined") {
            if (document.addEventListener) {
                document.addEventListener('WeixinJSBridgeReady', jsApiCall, false);
            }
            else if (document.attachEvent) {
                document.attachEvent('WeixinJSBridgeReady', jsApiCall);
                document.attachEvent('onWeixinJSBridgeReady', jsApiCall);
            }
        }
        else {
            jsApiCall();
        }
    }

</script>

接受支付成功后微信发回的确认信息，同时修改订单状态

这个过程细说有点复杂，下面是微信团队提供的支付流程图: