.NET Core 小程序开发零基础系列（1）——开发者启用并牵手成功

最近几个月本人与团队一直与小程序打交道，对小程序的实战开发算比较熟悉，也因一些朋友经常问我各种小程序问题，无不能一一回答，想了很久，决定还是空余时间来写写文章吧，偶尔发现一个人安静的时候写文章特爽，不信大伙可以试试哦^_^

一般项目开发已快速为主，这时想到了一个小程序开源框架，盛派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/

本文文章版权归作者和博客园共有，未经作者同意不得随意转载，且在文章页面明显位置给出原文连接，否则保留追究法律责任的权利。如有问题或建议，请与我联系。

posted @ 2019-08-26 09:31 hailang2zh 阅读(9653) 评论(16) 编辑收藏举报

刷新页面返回顶部

hailang8

从事.net已十年了，对待一件事情就像对待一份感情一样，不能换，如果换了，说明你心变了，共勉。

.NET Core 小程序开发零基础系列（1）——开发者启用并牵手成功

公告