.NET Core 小程式開發零基礎系列（1）——開發者啟用並牽手成功

阿新 • • 發佈：2019-08-26

最近幾個月本人與團隊一直與小程式打交道，對小程式的實戰開發算比較熟悉，也因一些朋友經常問我各種小程式問題，無不能一一回答，想了很久，決定還是空餘時間來寫寫文章吧，偶爾發現一個人安靜的時候寫文章特爽，不信大夥可以試試哦^_^ 一般專案開發已快速為主，這時想到了一個小程式開源框架，盛派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://blog.csdn.net/hailang2ll

本文文章版權歸作者和部落格園共有，未經作者同意不得隨意轉載，且在文章頁面明顯位置給出原文連線，否則保留追究法律責任的權利。如有問題或建議，請與我聯絡。

.NET Core 小程式開發零基礎系列（1）——開發者啟用並牽手成功

.NET Core 小程式開發零基礎系列（1）——開發者啟用並牽手成功

.NET Core 小程式開發零基礎系列（2）——小程式服務通知（模板訊息）

微信小程式開發的一些知識點（1）

.Net Core 商城微服務項目系列（一）：使用IdentityServer4構建基礎登錄驗證

.Net Core 商城微服務項目系列（三）：Ocelot網關接入Grafana監控

微信小程式開發之小米商城（一）

微信小程式開發-仿今日頭條（二）

ASP.NET Core 中文文件第二章指南（1）用 Visual Studio Code 在 macOS 上建立首個 ASP.NET Core 應用程式

.Net Core 商城微服務項目系列（十）：使用SkyWalking構建調用鏈監控（2019-02-13 13:25）

小程式學習之路--UI（1）

微信小程式-自定義NavBar元件（1）

微信小程式實現動態新增標籤（1）

2018年最新微信小程序開發零基礎

微信小程式開發入門基礎教程

商業級微信小程式開發從基礎到實戰

微信小程式開發教程(基礎篇)6-logs頁面解析

微信小程式開發教程(基礎篇)3-app.js 解析

ASP.NET Core 中文文件第二章指南（8）使用 dotnet watch 開發 ASP.NET Core 應用程式

微信小程式開發教程(基礎篇)8-資料繫結下

微信小程式開發-從基礎到實戰（四）

.NET Core 小程式開發零基礎系列（1）——開發者啟用並牽手成功

相關推薦