前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >.NET Core 小程序开发零基础系列(1)——开发者启用并牵手成功

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

作者头像
hailang2zh
发布2019-08-29 17:42:23
1.4K0
发布2019-08-29 17:42:23
举报

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

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

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

本文参与 腾讯云自媒体分享计划,分享自作者个人站点/博客。
原始发表:2019-08-26 ,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体分享计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
相关产品与服务
云开发 CloudBase
云开发(Tencent CloudBase,TCB)是腾讯云提供的云原生一体化开发环境和工具平台,为200万+企业和开发者提供高可用、自动弹性扩缩的后端云服务,可用于云端一体化开发多种端应用(小程序、公众号、Web 应用等),避免了应用开发过程中繁琐的服务器搭建及运维,开发者可以专注于业务逻辑的实现,开发门槛更低,效率更高。
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档