[English Version]

📈 Senparc.Weixin SDK 是ぜ目前もくぜん使用しよう率りつ最高さいこう的てき微ほろ信しん .NET SDK，也是国内こくない最さい受欢迎むかえ的てき .NET 开源项目之の一いち。本ほん项目已やめ持じ续维护超过 11 年ねん，助力じょりょく大量たいりょう系けい统和应用取得しゅとく成功せいこう。我わが们将继续保持ほじ更新こうしん，并正在ざい深度しんど融合ゆうごう AI 场景应用，示しめせ例れい正ただし在ざい逐步上じょう线。欢迎加入かにゅう我わが们的社しゃ区く 👐

使用しよう Senparc.Weixin，您可以方便びん快速かいそく地ち开发微ほろ信しんじ全ぜん平台ひらだい的てき应用（包括ほうかつ微ほろ信しん公こう众号、小しょう程ほど序じょ、小しょう游ゆう戏、企くわだて业号、开放平台ひらだい、微ほろ信しん支ささえ付づけ、JS-SDK、微ほろ信しん硬かた件けん/蓝牙，等とう等とう）。本ほん项目的もくてき Demo 同どう样适合あい初学しょがく者しゃ进行 .NET 编程学がく习。

目前もくぜん Senparc.Weixin 已やめ经支持しじ几乎所有しょゆう微ほろ信しん平台ひらだい模も块和接せっ口こう，并同时支持しじ .NET 3.5 / 4.0 / 4.5 / .NET Standard 2.x / .NET Core 2.x / .NET Core 3.x / .NET 6.0 / .NET 7.0 / .NET 8.0 等ひとし多た种框架か，同どう时兼容よう所有しょゆう MVC、Razor、WebApi、Console（命令めいれい行ぎょう）、桌面应用（.exe）、Blazor、MAUI、后きさき台だい服ふく务等环境，和かず外部がいぶ框かまち架か完全かんぜん解かい耦。

自じ 2013 年ねん起立きりつ项 10 年ねん多た来らい，我わが们一直保持着项目的持续更新，并将完かん整せい的てき源みなもと代だい码以及设计思想しそう毫无保留ほりゅう地ち分ぶん享とおる给大家か，希望きぼう有ゆう更さら多た的てき人じん可か以从中ちゅう受益じゅえき，理解りかい并传播开源げん的てき精神せいしん，一同助力中国开源事业！感恩かんおん一路上给我们提供帮助的朋友们！

如果你喜欢并希望きぼう我わが们继续优化か这个项目，请给我わが们一个 ★Star ：)

1、 在ざい Program.cs 的てき builder.Build() 上方かみがた添加てんか配置はいち：

builder.Services.AddSenparcWeixinServices(builder.Configuration);

如果您使用しよう的てき是ぜ旧きゅう格式かくしき的てき Startup.cs 文ぶん件けん，上述じょうじゅつ代だい码对应于 Startup.cs 的てき ConfigureServices() 方法ほうほう内ない。

2、 在ざい Program.cs 的てき builder.Build() 下方かほう启用配置はいち：

var registerService = app.UseSenparcWeixin(app.Environment, null, null, register => { },
    (register, weixinSetting) =>
{
    //注ちゅう册さつ公こう众号信しん息いき（可か以执行ぎょう多た次じ，注ちゅう册さつ多た个公众号）
    register.RegisterMpAccount(weixinSetting, "【盛もり派は网络小しょう助手じょしゅ】公おおやけ众号");
});

• 如果您使用しよう的てき是ぜ旧きゅう格式かくしき的てき Startup.cs 文ぶん件けん，上述じょうじゅつ代だい码对应于 Startup.cs 的てき Configure() 方法ほうほう内ない。
• 如果您希望きぼう系けい统自动注册さつ所有しょゆう配置はいち好このみ的てき账号，只ただ需上述じょうじゅつ方法ほうほう最さい后きさき追加ついか一いち个 autoRegisterAllPlatforms: true 的てき设置即そく可か（需要じゅよう引用いんよう Senparc.Weixin.All 包つつみ）：

var registerService = app.UseSenparcWeixin(app.Environment, null, null, register => { },
    (register, weixinSetting) => { /* 无需手しゅ动注册さつ */ },
    autoRegisterAllPlatforms: true /* 自じ动注册さつ所有しょゆう平台ひらだい */
);

可か在ざい程ほど序じょ任意にんい位置いち调用接せっ口こう（以客服ふく接せっ口こう为例）：

await CustomApi.SendTextAsync("AppId", "OpenId", "Hello World!");

公おおやけ众号默だま认提供ていきょう了りょう对话窗まど口こう，可か以发送文字もじ、图片、语音等とう不同ふどう类型的てき信しん息いき和わ程ほど序じょ互动。

以下いか示しめせ例れい同どう样适用よう于企业微信和しんわ小しょう程ほど序じょ客きゃく服ふく消息しょうそく的てき对话，只ただ需两步ふ！

using Senparc.NeuChar.Entities;
using Senparc.Weixin.MP.Entities;
using Senparc.Weixin.MP.Entities.Request;
using Senparc.Weixin.MP.MessageContexts;
using Senparc.Weixin.MP.MessageHandlers;

namespace Senparc.Weixin.Sample.MP
{
    /// <summary>
    /// 自じ定てい义MessageHandler
    /// 把わMessageHandler作さく为基类，重じゅう写うつし对应请求的てき处理方法ほうほう
    /// </summary>
    public partial class CustomMessageHandler : MessageHandler<DefaultMpMessageContext>
    {
        public CustomMessageHandler(Stream inputStream, PostModel postModel, int maxRecordCount = 0,
            bool onlyAllowEncryptMessage = false, IServiceProvider serviceProvider = null)
            : base(inputStream, postModel, maxRecordCount, onlyAllowEncryptMessage, null, serviceProvider)
        {
        }

        /// <summary>
        /// 所有しょゆう未み处理类型的てき默だま认消息いき
        /// </summary>
        /// <returns></returns>
        public override IResponseMessageBase DefaultResponseMessage(IRequestMessageBase requestMessage)
        {
            //ResponseMessageText也可以是News等とう其他类型
            var responseMessage = this.CreateResponseMessage<ResponseMessageText>();
            responseMessage.Content = $"你发送了りょう一いち条じょう消息しょうそく，但ただし程ほど序じょ没ぼつ有ゆう指定してい处理过程";
            return responseMessage;
        }

        public override Task<IResponseMessageBase> OnImageRequestAsync(RequestMessageImage requestMessage)
        {
            //处理图片请求...
        }

        public override Task<IResponseMessageBase> OnLocationRequestAsync(RequestMessageLocation requestMessage)
        {
            //处理地理ちり位置いち请求...
        }
    }
}

我わが们提供ていきょう了りょう 中ちゅう间件（推荐）和わ Controller（或あるWebApi） 两种方式ほうしき请求 CustomMessageHandler，您可以任选其一いち。以中间件为例，在ざい Program.cs 中ちゅう启用配置はいち后きさき添加てんか代だい码，注ちゅう册さつ MessageHandler：

app.UseMessageHandlerForMp("/WeixinAsync",
    (stream, postModel, maxRecordCount, serviceProvider)
        => new CustomMessageHandler(stream, postModel, maxRecordCount, false, serviceProvider),
    options 
        =>
    {
        options.AccountSettingFunc = context => Senparc.Weixin.Config.SenparcWeixinSetting;
    });

此时，您已经可以使用しよう https://YourDomain/WeixinAsync 在ざい微ほろ信しん公こう众号后きさき台だい【设置与あずか开发】>【基本きほん配置はいち】> 服ふく务器地ち址し(URL) 中ちゅう进行配置はいち，对应 Token 在ざい appsettings.json 中ちゅう设置（同どう样适用よう于企业微信和しんわ小しょう程ほど序じょ，请参考さんこう对应 Sample）。

此外，您还可か以使用しよう Controller（或ある WebApi） 方式ほうしき可か以对整せい个消息いき处理步ふ骤进行ぎょう更さら加か细致的てき控ひかえ制せい（或ある在ざい .NET Framework 中ちゅう使用しよう），点てん击这里さと查看。

至いたり此，您已经掌握しょうあく了りょう开发微ほろ信しんじ各かく平台ひらだい所しょ需要じゅよう的てき基本きほん技能ぎのう，更さら多た资源请继续往下か看み：

• 🏹 各かく模も块类库
• 💾 源みなもと码项目め文ぶん件けん夹说明あきら（src文ぶん件けん夹下）
• 🖥️ Samples 文ぶん件けん夹说明あきら（Samples文ぶん件けん夹下）
• 🎨 资源
• 📖 Senparc 官かん方かた图书教程きょうてい
• 🖥️ Senparc 官かん方かた视频教程きょうてい
• 🧪 关注测试账号（SenparcRobot）
• ✋ 贡献代だい码
• 👩‍🏫 如何いか使用しよう .NET Core 开发
• ↕️ 使用しよう Nuget 安あん装そう到いた项目中ちゅう
• 🏬 如何いか部署ぶしょ
• 🍴 各かく重要じゅうよう分ぶん支ささえ说明
• 🍟 感かん谢贡献けんじ者しゃ
• 💰 捐助
• ⭐ Star 数量すうりょう统计
• 📎 License

本ほん库包含ほうがん了りょう .NET Framework/.NET Standard 2.0+/.NET Core 3.1/.NET 6/.NET 7/.NET 8 等とう多た个版本はんぽん的てき源みなもと代だい码（核心かくしん逻辑完全かんぜん一致いっち）：

• 使用しよう Visual Studio 2022 打だ开 Demo（支持しじ所有しょゆう版本はんぽん）：.NET 8.0 - Senparc.Weixin.Sample.Net8.sln（包含ほうがん源げん码引用いんよう推荐）
• 使用しよう Visual Studio 2019 或ある更さら高だか版本はんぽん打だ开 .NET Framework Demo：Senparc.Weixin.MP.Sample.Net45.sln（不ふ包含ほうがん源げん码，仅引用いんよう类库）
• 使用しよう Visual Studio 2019 或ある更さら高だか版本はんぽん打だ开命令れい行ぎょう Console Demo（.NET Core）：Senparc.Weixin.MP.Sample.Consoles.vs2019.sln

#	模かたぎ块功能のう	DLL	Nuget	支持しじ .NET 版本はんぽん
1	基もと础库	Senparc.Weixin.dll
2	微ほろ信しん公こう众号 / JSSDK / 摇周边 等ひとし等ひとし	Senparc.Weixin.MP.dll
3	微ほろ信しん小しょう程ほど序じょ （支持しじ小しょう游ゆう戏） （独立どくりつ项目）	Senparc.Weixin.WxOpen.dll
4	微ほろ信しん支ささえ付づけ	Senparc.Weixin.TenPay.dll
5	微ほろ信しん支ささえ付づけ V3	Senparc.Weixin.TenPayV3.dll
6	ASP.NET MVC 扩展	Senparc.Weixin.MP.MVC.dll
7	微ほろ信しん企くわだて业号	Senparc.Weixin.QY.dll
9	企くわだて业微信しん	Senparc.Weixin.Work.dll
9	微ほろ信しん开放平台ひらだい	Senparc.Weixin.Open.dll
10	Redis 分布ぶんぷ式しき缓存	Senparc.Weixin.Cache. Redis.dll
11	Memcached 分布ぶんぷ式しき缓存	Senparc.Weixin.Cache. Memcached.dll
12	WebSocket （独立どくりつ项目）	Senparc.WebSocket.dll
13	All In One 集成しゅうせい库	Senparc.Weixin.All.dll

.NET Framework 4.6.2+	.NET Standard 2.0 / 2.1	.NET 8.0，向こう下した兼けん容よう .NET 5.0-7.0

• 已やめ经支持しじ大だい部分ぶぶん微ほろ信しん 8.x API，包括ほうかつ微ほろ信しん支ささえ付づけ、自じ定てい义菜单/个性化か菜さい单、模も板ばん信しん息いき接せっ口こう、素材そざい上じょう传接口こう、群ぐん发接口こう、多客たきゃく服ふく接せっ口こう、支ささえ付づけ接せっ口こう、微小びしょう店てん接せっ口こう、卡券接せっ口こう、发票接せっ口こう等とう等とう。
• 已やめ支持しじ微ほろ信しん公こう众号、小しょう程ほど序じょ、企くわだて业号、开放平台ひらだい、微ほろ信しん支ささえ付づけ等とう各かく个模块。
• 已やめ经支持しじ用よう户会话上下じょうげ文ぶん（解かい决服务器无法使用しよう Session 处理用よう户信息いき的てき问题）。
• 已やめ经全面めん支持しじ微ほろ信しん公こう众号、小しょう程ほど序じょ、企くわだて业号（企くわだて业微信しん）、微ほろ信しん支ささえ付づけV2/V3、开放平台ひらだい的てき最新さいしん API。
• 已やめ经支持しじ分布ぶんぷ式しき缓存及缓存そん策略さくりゃく扩展（默だま认支持しじ：本地ほんじ缓存、Redis、Memcached，可か自由じゆう扩展），开发过程无需关心所しょ使用しよう缓存的てき类型，可か在ざい配置はいち文ぶん件けん或ある运行过程中ちゅう自由じゆう切きり换。

1.目前もくぜん官かん方かた的てき API 都と已やめ完かん美び集成しゅうせい，除じょ非ひ有ゆう特殊とくしゅ说明，所有しょゆう升ます级都会かい尽つき量りょう确保向こう下した兼けん容よう，所以ゆえん已やめ经发布ぬの的てき版本はんぽん请放心ほうしん使用しよう或ある直接ちょくせつ升ます级（覆くつがえ盖）最新さいしん的てき dll，建けん议使用しよう Nuget 进行更新こうしん。
2. 您也可か以自行ぎょう修おさむ改あらため并编译代码，打だ开 Senparc.Weixin.Sample.Net8.sln 解かい决方案あん即そく可か看み到いた所有しょゆう源げん码。当とう编译模も式しき为 Release 时，将はた自じ动生成本なりもと地ち Nuget 包つつみ（默だま认生成せいせい到いた /src/BuildOutPut/ 文ぶん件けん夹下）。

进入文ぶん件けん夹

Senparc.Weixin SDK 所有しょゆう的てき模も块的用法ようほう都と保持ほじ了りょう高度こうど的てき一致いっち，包括ほうかつ配置はいち过程、AccessToken 管理かんり、消息しょうそく处理、服ふく务消息いき、接せっ口こう调用，等とう等とう。您只需参考さんこう任意にんい一个模块的用法（推荐从公おおやけ众号或ある小しょう程ほど序じょ开始），就可以举一反三使用其他模块。

从以下か Sample 中ちゅう您可以了解りょうかい到いた每まい个独立どくりつ模も块的配置はいち和わ使用しよう方式ほうしき，直接ちょくせつ打だ开对应文件けん夹下的てき .sln 解かい决方案あん即そく可か查看对应源げん码，运行即そく可か看み到いた说明文ぶん档。其中 All 文ぶん件けん夹中包含ほうがん了りょう更さら多た综合和わ进阶功こう能のう的てき演えんじ示しめせ。

进入 Samples 文ぶん件けん夹

1. 官かん网地址し：https://weixin.senparc.com/
2. 在ざい线 Demo 地ち址し（.NET 8.0，向こう下した兼けん容よう .NET 6.0、7.0 和わ .NET Core）：https://sdk.weixin.senparc.com/
3. 微ほろ信しん开发系列けいれつ教程きょうてい：https://www.cnblogs.com/szw/p/weixin-course-index.html
4. 微ほろ信しん技わざ术交流こうりゅう社しゃ区く：https://weixin.senparc.com/QA
5. 自じ定てい义菜单在线编辑工具ぐ：https://sdk.weixin.senparc.com/Menu
6. 在ざい线消息いき测试工具こうぐ：https://sdk.weixin.senparc.com/SimulateTool
7. 缓存测试工具こうぐ：https://sdk.weixin.senparc.com/Cache/Test
8. chm帮助文ぶん档下载：https://sdk.weixin.senparc.com/Document
9. 源みなもと代だい码及最新さいしん更新こうしん：https://github.com/JeffreySu/WeiXinMPSDK
10. 微ほろ信しん开发资源集合しゅうごう：https://github.com/JeffreySu/WeixinResource
11. 《微ほろ信しん开发深度しんど解析かいせき》阅读辅助系けい统：https://book.weixin.senparc.com
12. 购买《微ほろ信しん开发深度しんど解析かいせき》：https://item.jd.com/12220004.html
13. 《微ほろ信しん公こう众号 + 小しょう程ほど序じょ快速かいそく开发》视频教程きょうてい：https://github.com/JeffreySu/WechatVideoCourse

• 技わざ术交流こうりゅうQQ群ぐん：

1群ぐん（公おおやけ众号）：300313885
14群ぐん（视频课程学がく员群）：588231256
10群ぐん（分布ぶんぷ式しき缓存群ぐん）：246860933
12群ぐん（微ほろ信しん小しょう程ほど序じょ）：108830388
16群ぐん（开放平台ひらだい）：860626938
以下いか群ぐん已やめ满：
2群ぐん：293958349（已やめ满），3群ぐん：342319110（已やめ满）
4群ぐん：372212092（已やめ满）， 5群ぐん：377815480（已やめ满），6群ぐん：425898825（已やめ满）
7群ぐん：482942254（已やめ满），8群ぐん：106230270（已やめ满），9群ぐん：539061281（已やめ满）
11群ぐん：553198593（已やめ满），13群ぐん：183424136（开放平台ひらだい，已やめ满），15群ぐん：289181996（已やめ满）

• 业务联系QQ：498977166

如果这个项目对您有用ゆうよう，我わが们欢迎むかえ各かく方ほう任つとむ何なに形式けいしき的てき捐助，也包括ほうかつ参与さんよ到いた项目代だい码更新こうしん或ある意い见反馈中来らい。谢谢！

资金捐助：进入

由ゆかり Jeffrey Su 和わ盛もり派は团队耗时 2 年ねん完成かんせい的てき微ほろ信しん开发图书已やめ经出版しゅっぱん，书名：《微ほろ信しん开发深度しんど解析かいせき：公おおやけ众号、小しょう程ほど序じょ高だか效こう开发秘ひ籍せき》，全ぜん书配套辅助じょ阅读系けい统已经上线： BookHelper。
欢迎购买正せい版ばん图书：【购买正せい版ばん】
图书出版しゅっぱん时的代だい码版本ほん快かい照あきら见分支ささえ BookVersion1。

为了帮助大家たいか更さら直ちょく观地了解りょうかい微ほろ信しん开发细节，同どう时结合あい《微ほろ信しん开发深度しんど解析かいせき》图书进行学がく习，我わが们成立せいりつ“盛もり派は课堂”小しょう组，开设了りょう微ほろ信しん开发视频课程，帮助大家たいか从多个维度ど学がく习微信しん开发以及 .NET 开发过程中ちゅう的てき诸多技巧ぎこう。
视频包含ほうがん两大部分ぶぶん：

1. 微ほろ信しん开发基もと础技能ぎのう
   
2. 公おおやけ众号及小程ほど序じょ案あん例れい实战
   

共きょう计 60 课时，配はい有ゆう番ばん外篇がいへん。
目前もくぜん视频已やめ经在网易云うん课堂上じょう线，课程制作せいさく精良せいりょう、内容ないよう充たかし实，被ひ选为“A”级课程ほど，【观看视频】，【查看课程代だい码及课件】。

盛もり派は网络小しょう助手じょしゅ公こう众号	盛もり派は网络小しょう助手じょしゅ小しょう程ほど序じょ	BookHelper

如果需要じゅよう使用しよう或ある修おさむ改あらため此项目的もくてき源げん代だい码，建けん议先Fork。也欢迎むかい将すすむ您修改あらため的てき通用つうよう版本はんぽんPull Request过来。

1. Fork
2. 创建您的特性とくせい分ぶん支ささえ (git checkout -b my-new-feature)
3. 提ひさげ交您的てき改あらため动 (git commit -am 'Added some feature')
4. 将はた您的修おさむ改あらため记录提ひさげ交到远程 git 仓库 (git push origin my-new-feature)
5. 然しか后きさき到いた github 网站的てき该 git 远程仓库的てき my-new-feature 分ぶん支ささえ下か发起 Pull Request （请提交到 Developer 分ぶん支ささえ，不要ふよう直接ちょくせつ提ひさげ交到 master 分ぶん支ささえ）

当とう前まえ分ぶん支ささえ包含ほうがん了りょう .NET Framework 4.6.2+ 及 .NET 6.0/7.0/8.0 的てき全ぜん版本はんぽん代だい码（已やめ经不更新こうしん的てき版本はんぽん请查看み release 快かい照あきら）。
其中 .NET Framework 的てき Demo 位い于 /src/Samples/All/net45-mvc 目め录下，
【推荐】.NET 8.0（向こう下した兼けん容よう .NET 5.0、6.0、7.0 及 .NET Core 3.1 等とう更さら低てい版本はんぽん） 的てき Demo 位い于 /Samples/All/net8-mvc 目め录下。

注意ちゅうい：以上いじょう Sample 中ちゅう，net8-mvc 中なか的てき Sample 直接ちょくせつ引用いんよう了りょう每まい个模块的源げん码，使用しよう Release 编译后きさき可か生成せいせい兼けん容よう不同ふどう版本はんぽん的てき Senaprc.Weixin SDK 库。

各かく个模块的 Nuget 安あん装そう方式ほうしき：《使用しよう Nuget 将はた SDK 安あん装そう到いた项目中ちゅう》

App Service 是ぜ Microsoft Azure 推出的てき Web 服ふく务，对 .NET 有ゆう很好的てき支持しじ。部署ぶしょ步ふ骤详见：《将はた微ほろ信しん站点部署ぶしょ到いた Azure 中ちゅう》。

在ざい Web 服ふく务器上安かみやす装そう FTP 服ふく务（推荐 FileZilla Server），直接ちょくせつ使用しよう FTP 直接ちょくせつ上じょう传本地ち已やめ经编译好的てき代だい码（本ほん项项目め Samples 中ちゅう对应的てき是ぜ Senparc.Weixin.Sample.Net8，编译后きさき即そく可か直接ちょくせつ使用しよう，无需修おさむ改代かいたい码）。如果使用しよう Azure App Service 或ある其他云うん服ふく务，通常つうじょう FTP 也都是ぜ开通的てき。

感かん谢为此项目め做出贡献的てき开发者しゃ，你们不ふ光ひかり完かん善ぜん了りょう这个项目，也为中国ちゅうごく开源事ごと业出了りょう一いち份力，感かん谢你们！名めい单点てん击这里さと查看。

如果这个项目对您有用ゆうよう，我わが们欢迎むかえ各かく方ほう任つとむ何なに形式けいしき的てき捐助，也包括ほうかつ参与さんよ到いた项目代だい码更新こうしん或ある意い见反馈中来らい。谢谢！

资金捐助：

Apache License Version 2.0

Copyright 2024 Jeffrey Su & Suzhou Senparc Network Technology Co.,Ltd.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file 
except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the 
License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, 
either express or implied. See the License for the specific language governing permissions 
and limitations under the License.

Detail: https://github.com/JeffreySu/WeiXinMPSDK/blob/master/license.md