介绍
Senparc.Weixin SDK 是由盛派网络(Senparc)团队自主研发的针对微信各模块的开发套件(C# SDK),已全面支持微信公众号、小程序、微信支付、企业号、开放平台、JSSDK、摇一摇周边等模块。有一些东西都已经封住在sdk里面,不需要我们再进行那些繁琐的操作。
示例
要对接微信公众号,我们首先得有一个微信公众号(我本来是使用我自己公众号,奈何好多好玩的功能没有权限需要微信认证),我们可以通过微信申请测试号来学习使用,申请地址 该测试号可以直接体验和测试公众平台的所有高级接口。https://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login
通过测试号我可以可以得到我们想要的微信公众号参数信息
通过VS2019(好想尽快体验VS2022)新建一个.Net5 WebApi程序
安装组件
"RestSharp" Version="106.11.7" /> -
"Senparc.Weixin.MP" Version="16.12.101-preview2" /> -
"Senparc.Weixin.MP.Middleware" Version="0.3.100.1-preview2" /> -
"Swashbuckle.AspNetCore" Version="5.6.3" />
为了方便(偷懒),我直接使用了postman生成的RestSharp请求代码,因此装了该包。
添加配置
- //CO2NET
- "SenparcSetting": {
- "IsDebug": true,
- "DefaultCacheNamespace": "DefaultCache" //缓存通过前缀区分
- },
- //Senparc.Weixin SDK
- "SenparcWeixinSetting": {
- "IsDebug": true,
-
- "Token": "token",
- "EncodingAESKey": "EncodingAESKey",
- "WeixinAppId": "appid",
- "WeixinAppSecret": "secret"
- }
通过配置IsDebug可以配置是否以Debug模式运行。
关于SenparcWeixinSetting为何叫做这个名字?是因为配置中写死的
ConfigureServices中注册服务
- services.AddMemoryCache()//使用本地缓存必须添加
- .AddSenparcWeixinServices(Configuration);//Senparc.Weixin 注册(必须)
也可以采用redis等其他方法存储配置信息等
Configure中启用服务
- //注册 Senparc.Weixin 及基础库
- app.UseSenparcGlobal(env, senparcSetting.Value, _ => { }, true)
- .UseSenparcWeixin(senparcWeixinSetting.Value,
- weixinRegister => weixinRegister.RegisterMpAccount(senparcWeixinSetting.Value));
通过这些配置我们可以获取accesstoken
- var accessToken = await AccessTokenContainer.GetAccessTokenAsync(_configuration["SenparcWeixinSetting:WeixinAppId"]).ConfigureAwait(false);
自定义消息回复
要实现接受用户的消息,并且做出回应,我们需要继承MessageHandler,新建CustomerMessageHandler类,该类中实现了网上说的价值一个亿的AI核心代码,看到就是赚到。
- ///
- /// 自定义消息处理器
- ///
- public class CustomerMessageHandler : MessageHandler
- {
- public CustomerMessageHandler(Stream inputStream, PostModel postModel, int maxRecordCount = 0, IServiceProvider serviceProvider = null)
- : base(inputStream, postModel, maxRecordCount, false, null)
- {
- }
-
- ///
- /// 回复以文字形式发送的信息(可选)
- ///
- public override async Task
OnTextRequestAsync(RequestMessageText requestMessage) - {
- var responseMessage = base.CreateResponseMessage
(); - // await Senparc.Weixin.MP.AdvancedAPIs.CustomApi.SendTextAsync(Config.SenparcWeixinSetting.MpSetting.WeixinAppId, OpenId,);//注意:只有测试号或部署到正式环境的正式服务号可用此接口
- //responseMessage.Content = $"你发送了文字:{requestMessage.Content}\r\n\r\n你的OpenId:{OpenId}";//以文字类型消息回复
- responseMessage.Content = requestMessage.Content.Replace("吗", "").Replace('?', '!').Replace('?', '!');
- return responseMessage;
- }
-
- ///
- /// 默认消息
- ///
- public override IResponseMessageBase DefaultResponseMessage(IRequestMessageBase requestMessage)
- {
- var responseMessage = base.CreateResponseMessage
(); - responseMessage.Content = "欢迎来到我的公众号!";
- return responseMessage;
- }
- }
启用消息处理器
- //使用中间件注册 MessageHandler,指定 CustomMessageHandler 为自定义处理方法
- app.UseMessageHandlerForMp("/weixinmsg",
- (stream, postModel, maxRecordCount, serviceProvider) =>
- new CustomerMessageHandler(stream, postModel, maxRecordCount, serviceProvider),
- options => { options.AccountSettingFunc = context => senparcWeixinSetting.Value; });
这个时候我们已经实现了用户消息的接收和回复代码,不过还需要在微信平台进行配置(为了可以让微信发送消息到该代码,我使用了内网穿透功能供微信访问该地址)
如果你修改接口配置信息,提交成功说明微信可以调通该接口,这个时候就可以关注微信测试号,发送消息查看结果。
自定义菜单
通过编写接口来实现自定义菜单配置
- [HttpGet]
- public async Task
GetAsync() - {
- var accessToken = await AccessTokenContainer
- .GetAccessTokenAsync(_configuration["SenparcWeixinSetting:WeixinAppId"]).ConfigureAwait(false);
- var bg = new ButtonGroup();
-
- var oneSubButton = new SubButton
- {
- name = "基础知识",
- sub_button = new List
- {
- new SingleViewButton
- {
- name = "日志",
- url = "https://XXXXXX/appmsgalbum?__biz=MzU4MjU4NjgyOQ==&action=getalbum&album_id=1841538022157172741#wechat_redirect",
- }
- }
- };
- bg.button.Add(oneSubButton);
-
- bg.button.Add(new SingleViewButton
- {
- name = "文章目录",
- url = "https://www.yuque.com/docs/share/9aed821e-9115-41c7-a0cd-6b691ad7e400"
- });
-
- var result = CommonApi.CreateMenu(accessToken, bg);
-
- return "成功" + result;
- }
参考地址:
https://developers.weixin.qq.com/doc/offiaccount/Getting_Started/Overview.html
通过调用该接口实现自定义菜单配置,显示下面的菜单
参考文档
GitHub:https://github.com/JeffreySu/WeiXinMPSDK
sdk文档地址:https://www.cnblogs.com/szw/p/weixin-course-index.html