.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/

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

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

全文结束