.NET Core 小程序开发零基础系列（1）——开发者启用并牵手成功
- 2019 年 10 月 3 日
- 筆記
最近几个月本人与团队一直与小程序打交道，对小程序的实战开发算比较熟悉，也因一些朋友经常问我各种小程序问题，无不能一一回答，想了很久，决定还是空余时间来写写文章吧，偶尔发现一个人安静的时候写文章特爽，不信大伙可以试试哦^_^
一般项目开发已快速为主，这时想到了一个小程序开源框架，盛派Senparc，这个项目使用过程中确实很爽，开发速度贼快，想了解底层原理的同学可以下载盛派Senparc开源项目，开原址址附文章底部。
小程序开发系统文章就此诞生了，后面文章会覆盖小程序的所有功能，希望对刚步入小程序开的同学有所帮助。
目录
一、微信公众平台开发者设置
二、新建.netcore 项目与微信服务器牵手
三、开发者服务器自动回复
四、各种消息类型处理
五、总结
微信公众平台开发者设置
登录微信公众平台小程序后台，开发设置-消息推送，启用开发者，填写相关信息，如下图
配置好后，点击提交，会校验与服务器牵手动作，此时要保证服务地址能正常访问。
如不清楚的，请看下一步操作。
新建.netcore 项目与微信服务器牵手
新建.netcore api项目，项目结构如下图：
引用盛派Senparc组件：
Senparc.Weixin.MP.MVC Senparc.Weixin.WxOpen
使用盛派Senparc组件配置文件如下：
"SenparcWeixinSetting": { //微信全局 "IsDebug": true, //公众号 "Token": "#Token#", "EncodingAESKey": "#EncodingAESKey#", "WeixinAppId": "#WeixinAppId#", "WeixinAppSecret": "#WeixinAppSecret#", "Items": { "小程序1": { "WxOpenAppId": "#WxOpenAppId#", "WxOpenAppSecret": "#WxOpenAppSecret#", "WxOpenToken": "#WxOpenToken#", "WxOpenEncodingAESKey": "#WxOpenEncodingAESKey#" }, "小程B": { "WxOpenAppId": "#WxOpenAppId#", "WxOpenAppSecret": "#WxOpenAppSecret#", "WxOpenToken": "#WxOpenToken#", "WxOpenEncodingAESKey": "#WxOpenEncodingAESKey#" } } }
使用盛派Senparc组件必须先进行注册，在Startup类中ConfigureServices方法进行注册
services.AddSenparcGlobalServices(Configuration) .AddSenparcWeixinServices(Configuration);
在Startup类中Configure方法进行使用
public void Configure(IApplicationBuilder app, IHostingEnvironment env, IOptions<SenparcSetting> senparcSetting, IOptions<SenparcWeixinSetting> senparcWeixinSetting) { if (env.IsDevelopment()) { app.UseDeveloperExceptionPage(); app.UseSwaggerUIV2(); } app.UseStaticHttpContext(); app.UseStaticFiles(); app.UseMvc(routes => { routes.MapRoute( name: "default", template: "{controller=Home}/{action=Index}/{id?}"); }); #region 公众号，小程序 IRegisterService register = RegisterService.Start(env, senparcSetting.Value).UseSenparcGlobal(false, null); register.UseSenparcWeixin(senparcWeixinSetting.Value, senparcSetting.Value); //配置 var bInfo = senparcWeixinSetting.Value.Items["appid"]; AccessTokenContainer.RegisterAsync(bInfo.WxOpenAppId, bInfo.WxOpenAppSecret, bInfo.WxOpenAppId); //公众号 AccessTokenContainer.RegisterAsync(senparcWeixinSetting.Value.WeixinAppId, senparcWeixinSetting.Value.WeixinAppSecret, senparcWeixinSetting.Value.WeixinAppId); #endregion }
以上盛派Senparc组件的全局配置基本完成，可以开始写验证服务器的接口啦。
新建HomeController类
静态变量定义如下：
#region static /// <summary> /// 当前小程序的AppId /// </summary> public static readonly string AppId = Senparc.Weixin.Config.SenparcWeixinSetting.Items["appid"].WxOpenAppId; /// <summary> /// /// </summary> public static readonly string Token = Senparc.Weixin.Config.SenparcWeixinSetting.Items[AppId].WxOpenToken; /// <summary> /// /// </summary> public static readonly string EncodingAESKey = Senparc.Weixin.Config.SenparcWeixinSetting.Items[AppId].WxOpenEncodingAESKey; #endregion
验证接口代码如下：
[HttpGet] [ActionName("Index")] public ActionResult Get(PostModel postModel, string echostr) { if (CheckSignature.Check(postModel.Signature, postModel.Timestamp, postModel.Nonce, Token)) { return Content(echostr); //返回随机字符串则表示验证通过 } else { return Content("failed:" + postModel.Signature + "," + Senparc.Weixin.MP.CheckSignature.GetSignature(postModel.Timestamp, postModel.Nonce, Token) + "。" + "如果你在浏览器中看到这句话，说明此地址可以被作为微信小程序后台的Url，请注意保持Token一致。1"); } }
发布项目到生产环境，在次点击微信小程序后台开发者配置，点击提交，验证成功说明已经与服务器牵手成功。
开发者服务器自动回复
建立与开发者服务器成功后，在公众号，小程序客服等功能发送的消息都会先经过微信服务器，微信服务器将已POST的请求方式中转给我们配置的URL地址，收到指令后，我们开发者根据收到的类型消息进行处理。
统一处理消息的入口，代码如下：
[HttpPost] [ActionName("Index")] public ActionResult Post(PostModel postModel) { if (!CheckSignature.Check(postModel.Signature, postModel.Timestamp, postModel.Nonce, Token)) { return Content("参数错误！"); } try { postModel.Token = Token;//根据自己后台的设置保持一致 postModel.EncodingAESKey = EncodingAESKey;//根据自己后台的设置保持一致 postModel.AppId = AppId;//根据自己后台的设置保持一致（必须提供） var maxRecordCount = 10; var messageHandler = new CustomWxOpenMessageHandler(Request.GetRequestMemoryStream(), postModel, maxRecordCount); messageHandler.Execute();//执行微信处理过程（关键） var result = new FixWeixinBugWeixinResult(messageHandler); return result; } catch (Exception ex) { Logger.Info("异常消息：" + ex.Message); return Content(""); } }
所有消息都会经过管道处理即CustomWxOpenMessageHandler方法，CustomWxOpenMessageHandler主要代码如下（遇到问题请与我联系）：
public CustomWxOpenMessageHandler(Stream inputStream, PostModel postModel, int maxRecordCount = 0) : base(inputStream, postModel, maxRecordCount) { //这里设置仅用于测试，实际开发可以在外部更全局的地方设置， //比如MessageHandler<MessageContext>.GlobalGlobalMessageContext.ExpireMinutes = 3。 GlobalMessageContext.ExpireMinutes = 3; if (!string.IsNullOrEmpty(postModel.AppId)) { appId = postModel.AppId;//通过第三方开放平台发送过来的请求 } //在指定条件下，不使用消息去重 base.OmitRepeatedMessageFunc = requestMessage => { var textRequestMessage = requestMessage as RequestMessageText; if (textRequestMessage != null && textRequestMessage.Content == "容错") { return false; } return true; }; }
自动回复处理方法，代码如下：
public override IResponseMessageBase OnEvent_UserEnterTempSessionRequest(RequestMessageEvent_UserEnterTempSession requestMessage) { //进入客服 var msg = @"欢迎您！这条消息来自服务器"; Senparc.Weixin.WxOpen.AdvancedAPIs.CustomApi.SendText(appId, OpenId, msg); return DefaultResponseMessage(requestMessage); }
效果图如下：
各种消息类型处理
图片消息处理代码如下：
public override IResponseMessageBase OnImageRequest(RequestMessageImage requestMessage) { //发来图片，进行处理 Task.Factory.StartNew(async () => { await Senparc.Weixin.WxOpen.AdvancedAPIs.CustomApi.SendTextAsync(appId, OpenId, "刚才您发送了这张图片："); await Senparc.Weixin.WxOpen.AdvancedAPIs.CustomApi.SendImageAsync(appId, OpenId, requestMessage.MediaId); }); return DefaultResponseMessage(requestMessage); }
文字消息处理代码如下：
public override IResponseMessageBase OnTextRequest(RequestMessageText requestMessage) { if (contentUpper == "1") { var uploadResult = Senparc.Weixin.MP.AdvancedAPIs.MediaApi.UploadTemporaryMedia(appId, UploadMediaFileType.image, ServerUtility.ContentRootMapPath("~/wwwroot/imgs/fwh.jpg")); Senparc.Weixin.WxOpen.AdvancedAPIs.CustomApi.SendImage(appId, OpenId, uploadResult.media_id); } else { var msg = "亲，回复“1”，关注服务号。"; Senparc.Weixin.WxOpen.AdvancedAPIs.CustomApi.SendText(appId, OpenId, msg); } return new SuccessResponseMessage(); }
统一默认处理，代码如下：
public override IResponseMessageBase DefaultResponseMessage(IRequestMessageBase requestMessage) { return new SuccessResponseMessage(); }
总结
盛派Senparc组件适用于快速开发项目，个人觉得还是很方便的，如果想进一步了解底层，可以看底层接口，其实就是请求的微信的相关接口，处理返回的结果进行了封装，如有在小程序开发过程中遇到任何问题可与我联系
盛派Senparc开源项目：https://github.com/JeffreySu/WeiXinMPSDK/
作者：Dylan
公众号：dotNET名人堂（sharecore）
微信：tangguo_9669
QQ：.NET Core 技术交流（18362376）
出处：https://www.cnblogs.com/hailang8/
本文文章版权归作者和博客园共有，未经作者同意不得随意转载，且在文章页面明显位置给出原文连接，否则保留追究法律责任的权利。如有问题或建议，请与我联系。
