微信公众平台开发教程（五）详解自定义菜单

微信公众号作为与用户沟通的桥梁，为我们提供了一个极佳的平台去吸引和留住用户。其中，自定义菜单的设计尤为关键，它让我们的微信对话页面更加生动，功能更加丰富多样。接下来，让我们一起深入微信公众平台开发教程中的自定义菜单部分。

一、概览

想象一下，如果我们的微信对话页面仅有简单的输入框，可能会显得过于单调和死板。自定义菜单为我们的公众号增添了无限活力，它让用户在浏览我们的公众号时，能够轻松地找到他们想要的功能。自定义菜单不仅提供了直观的操作体验，还能通过URL跳转功能，引导用户进入我们的网页以获取更多复杂的功能和服务。值得注意的是，只有服务号才能使用此功能。

二、详细步骤

1. 获取aess_token：这是公众号的全局唯一票据，是调用所有微信接口的必要前提。为了获取这个票据，我们需要使用AppID和AppSecret进行身份认证。调用接口获取aess_token时，我们需要使用https协议进行安全传输。接口调用成功后，微信会返回一个包含aess_token和expires_in的JSON数据包。如果调用失败，微信会返回错误码和其他相关信息。

2. 创建自定义菜单：自定义菜单能帮助我们丰富公众号的界面，让用户更快速理解我们的服务内容。一个优秀的自定义菜单设计，能让用户在浏览公众号时，轻松找到所需的功能。目前，自定义菜单最多可包括3个一级菜单和每个一级菜单下的5个二级菜单。在设计菜单名称时，需要注意汉字的数量限制，超出部分将会以“...”代替。完成菜单创建后，由于微信客户端的缓存机制，新菜单需要大约24小时后才能在客户端展现出来。

三、用户体验与界面展示

想象一下用户打开我们的微信公众号，首先映入眼帘的便是我们精心设计的自定义菜单。他们可以通过点击菜单轻松访问我们的各项服务。这种直观、便捷的操作体验，无疑会大大提高用户的满意度和忠诚度。自定义菜单的URL跳转功能，可以引导用户进入我们的网页，进一步了解我们的产品和服务。

自定义菜单是微信公众号开发中的重要一环。通过精心设计和优化，我们可以为用户提供更好的操作体验，吸引更多的用户关注和参与。在这个过程中，我们需要深入理解用户的需求和习惯，通过不断优化和调整，创造出真正符合用户期望的自定义菜单。微信自定义菜单接口详解

一、菜单按钮类型介绍

微信自定义菜单目前支持两种类型的按钮：click和view。

1. click类型：用户点击后，微信服务器将通过消息接口推送事件给开发者，同时携带按钮中填写的key值，开发者可根据此key值与用户进行交互。

2. view类型：用户点击后，微信客户端将打开开发者填写的url链接，实现网页的打开。建议结合网页授权获取用户基本信息接口，以获得用户的登录个人信息。

二、接口调用请求说明

1. http请求方式：POST，请使用https协议。

2. 请求示例：

```json

{

"button": [

{

"type": "click",

"name": "今日歌曲",

"key": "V1001_TODAY_MUSIC"

},

{

"type": "click",

"name": "歌手简介",

"key": "V1001_TODAY_SINGER"

},

{

"name": "菜单",

"sub_button": [

{

"type": "view",

"name": "搜索",

"url": "

},

{

"type": "view",

"name": "视频",

"url": "

},

{

"type": "click",

"name": "赞一下我们",

"key": "V1001_GOOD"

}

]

}

]

}

```

三、参数说明

1. button：一级菜单数组，个数应为1~3个。

2. sub_button：二级菜单数组，个数应为1~5个。当button中的type为click时，sub_button为可选参数。

3. type：菜单的响应动作类型，目前支持click和view两种类型。

4. name：菜单标题，有字节限制。子菜单不超过40个字节。对于一级菜单的标题而言，不超过不超过指定的字节长度。此处标题信息尽量简明扼要地展现主要功能或产品特色。为让用户体验更佳，一定要尽量保证信息的完整性哦！而对应的中文名称应与公众号的品牌定位相一致哦！使得用户体验更贴合品牌的风格定位与品牌价值观哦！小伙伴们请尽量遵守字节限制哈！因为过于冗长的标题可能导致界面显得不够整洁与美观哦！而过于简洁的标题则可能无法充分传达信息内容哦！因此小伙伴们需要根据自身的品牌特点来进行恰当的平衡处理哈！这里体现了对于用户体验细节的极度重视以及追求卓越的态度！如果这里出现错误的话，将会影响整个菜单功能的正常运作哦！因此请务必谨慎对待哈！务必确保信息的准确性哦！还要保证标题的吸引力与创意性哦！以吸引用户的注意力并激发其好奇心与兴趣哦！从而达到更好的营销效果哈！这既体现了品牌的专业水准也体现了品牌的创新精神哦！在这里我们还可以根据目标受众的特点来进行有针对性的调整与优化哈！从而进一步提升用户体验和品牌忠诚度哦！对于不同类型的按钮title需要分别突出不同的核心价值哦！以达到最佳的推广效果哦！让每一个点击都产生价值！带来无限商机哦！我们的目标就是让每一个用户都能得到最好的体验与满足哦！共同助力品牌的成长与发展哦！让我们的品牌走向更加广阔的未来吧！同时请务必确保所填写信息的真实性、合法性和准确性哦！以营造一个诚信、公正、透明的网络环境为目标而努力哦！共同维护网络秩序和社会和谐稳定哦！（字数有些冗余，但请您理解。）在此我们真诚地感谢广大用户的支持与信任并承诺不断提升服务质量与用户满意度！）对于key和url参数也有相应的字节限制和填写要求哦！请务必遵守相关规定以确保菜单功能的正常运作哈！） 否则可能导致无法成功创建菜单或出现其他异常情况哦！） 请您在填写时务必仔细核对相关信息以确保准确无误哈！）请您放心使用我们的接口服务我们会尽最大努力保障系统的稳定性和安全性哈！）同时我们也欢迎广大用户提出宝贵的意见和建议以帮助我们一起改进和优化服务体验哦！）我们会不断努力提升用户体验和服务质量以满足用户的需求和期望哦！）另外关于返回结果部分也有相应的说明供您参考了解哈！）开发者在创建自定义菜单后还可以通过接口查询菜单结构以获取的菜单配置信息哦！）从而更好地管理和优化菜单功能提升用户体验哈！）总的来说微信自定义菜单接口为开发者提供了丰富的功能和灵活的接口调用方式以帮助您实现丰富的菜单交互体验吸引更多用户使用您的公众号或服务号哈！）在使用过程中如有任何问题欢迎随时联系我们的技术支持团队我们将竭诚为您服务并解决您遇到的问题哈！）让我们共同打造一个高效便捷、用户友好的微信生态圈吧！） 。

背景概述

在微信公众号运营中，为了提供更优质的服务和体验，开发者们常常会为其增加各种功能，其中自定义菜单就是一个不可或缺的部分。它为用户提供了快速导航、获取特定信息的便捷途径。本文将详细讲解如何在微信公众号上实现自定义菜单功能。

一、准备工作

在开始之前，你需要确保已经完成了微信公众号的注册和认证，并成功获得了开发者身份。接下来，确保你拥有必要的工具和资源，如微信开发者工具、微信公众号后台等。还需要获取你的公众号的AppId和AppSecret。一旦成为开发者，这两个重要的凭证可以在开发者模式中轻松找到并进行重置。

二、获取access_token

在调用微信提供的接口之前，首先需要获取access_token。这是与微信服务器通信的凭证。你可以按照以下步骤操作：

1. 通过调用微信提供的接口获取access_token。这通常涉及到发送一个包含特定参数的HTTP请求。具体细节可以参考微信官方文档。

2. 需要注意，access_token是有有效期的，一旦过期需要重新获取。确保在调用接口之前检查其有效性。

三、创建自定义菜单

在获取了有效的access_token之后，你可以开始创建自定义菜单。具体操作如下：

1. 使用HTTP GET请求方式发送请求到微信的创建菜单接口。请求中需要包含有效的access_token和其他必要参数。具体的参数和格式可以参考微信官方文档。

2. 请求的返回结果会告诉你是否成功创建了自定义菜单。如果成功，你将得到一个包含菜单信息的JSON响应。例如，你可能会得到一个包含多个按钮的菜单结构，每个按钮都有不同的功能和子菜单。

四、自定义菜单的构成和功能

创建自定义菜单时，你可以设置不同类型的按钮，如点击按钮（click）和跳转URL按钮（view）。点击按钮在用户点击后会触发特定的事件，例如播放音乐、显示歌手简介等。跳转URL按钮则会引导用户跳转到指定的网页链接。你还可以为菜单添加子菜单，提供更丰富的功能选择。

五、事件处理

当用户点击自定义菜单的按钮时，微信会将这次点击事件推送给开发者。对于click类型的按钮点击，微信会推送一个包含事件详情的XML数据包给开发者。开发者需要这个数据包，获取事件的关键信息，如用户的OpenID、事件类型等，然后进行相应的处理逻辑。对于view类型的按钮点击（跳转到URL），则不会上报事件。

六、删除自定义菜单

如果你需要更新或修改自定义菜单，你可以使用相应的接口删除当前使用的自定义菜单。操作方式与创建菜单类似，通过发送HTTP GET请求到微信的删除菜单接口，并携带有效的access_token。删除成功后，你将收到一个确认信息。

一、获取AccessToken的时间与有效期管理

在我们的系统中，AccessToken的获取与过期管理被精心设计，以确保系统的流畅运行与用户体验。我们定义了一个私有静态变量GetAessToken_Time来记录AccessToken的获取时间。我们设定了Expires_Period为7200秒，即AccessToken的有效期。

我们的AccessToken属性AessToken，在获取时，首先会检查当前的AccessToken是否已过期或者为空。若是，则会调用GetAessToken方法来重新获取。

在GetAessToken方法中，我们通过向微信API发送请求，使用appId和appSecret来获取新的AccessToken。获取成功后，我们会更新GetAessToken_Time为当前时间，并尝试从返回的结果中获取新的有效期Expires_Period。

我们还有一个方法HasExpired来判断AccessToken是否已过期。这个方法通过比较当前时间与获取AccessToken的时间与有效期来判断是否过期，同时考虑到网络请求的时间消耗，允许有一定的误差时间。

二、个性化菜单设置

在我们的系统中，菜单的设置是完全根据用户需求来定制的。为了满足用户的各种需求，我们提供了天气查询功能。用户只需要点击菜单中的城市名称，即可快速查询该城市的天气情况。为了方便用户，我们将常用的城市列在菜单中，用户可以轻松找到并点击进行查询。

我们为您精心打造了一个富有交互性的友情链接菜单，旨在为您带来便捷、流畅的跳转体验。只需轻轻一点，即可各类精彩内容。

一、导航菜单的华丽呈现

我们为您准备了丰富的菜单选项，通过“view”类型按钮，您可以直接跳转至目标URL页面。这一设计巧妙地将现实世界的便捷性融入数字世界，让您的每一次点击都充满惊喜。

具体菜单如下：

搜索：一键跳转至百度首页（

视频：即刻进入腾讯QQ视频（

赞一下我们：点击即可表达您的喜爱与支持，让我们共同分享喜悦。

二、天气查询功能的贴心加入

我们的菜单还融入了实用的天气查询功能。无论您身处武汉、上海还是北京，只需轻点相应城市，即可获取的天气信息。这一设计让您的出行更加便捷，让天气变化不再成为困扰。

三、帮助按钮：为您提供全方位支持

我们为您设置了“帮助”按钮，如果您在使用过程中遇到任何问题，点击即可获取帮助。我们会竭诚为您解答疑问，为您提供最佳的解决方案。

四、菜单管理的创新方式

考虑到菜单的变更频率，我们采用了创新的文本文件管理方式。通过管理界面，您可以轻松实现菜单的加载、创建、查询和删除。这一设计旨在为您提供更加灵活、高效的菜单管理体验。

主要功能：

1. 从文件加载菜单，轻松整合现有菜单资源。

2. 创建菜单，实时更新至微信客户端，让您的菜单始终保持在状态。

3. 查询菜单，随时掌握系统菜单的情况。

4. 删除菜单，轻松移除不再需要的选项，也可在删除后重新创建，以满足您的个性化需求。

我们的菜单设计旨在为您带来更加便捷、高效的使用体验。无论是搜索、视频还是天气查询，只需轻点即可实现。创新的菜单管理方式，让您的操作更加灵活、高效。希望您能喜欢我们的设计，享受使用带来的便捷与乐趣。MenuManager类：菜单管理核心代码解读

在应用程序中，菜单管理是一项核心功能，对于微信平台尤为关键。以下是MenuManager类的详细解读，其中涵盖了对菜单文件的路径管理、获取、创建、删除和加载等操作。

一、菜单文件路径管理

我们为菜单文件定义了一个静态的只读字符串路径`Menu_Data_Path`，这个路径指向程序基础目录下的“Data/menu.txt”文件，这是我们的菜单数据文件。

二、获取菜单

`GetMenu`方法用于从指定的URL获取菜单数据。这里我们构造了一个指向微信API的URL，通过aess_token来访问微信的菜单接口，然后使用`HttpUtility.GetData`方法获取数据。

三、创建菜单

`CreateMenu`方法用于创建新的菜单。我们同样构造了一个指向微信API的URL，并使用了Context中的AessToken。然后将菜单数据以POST方式提交到该URL。这里使用的是`HttpUtility.SendHttpRequest`方法。

四、删除菜单

`DeleteMenu`方法用于删除现有菜单。与创建菜单类似，我们构造了一个指向微信API的删除菜单的URL，然后通过GET请求删除菜单。这里使用的是`HttpUtility.GetData`方法。

五、加载菜单

`LoadMenu`方法用于从本地文件加载菜单数据。这里我们直接从之前定义的`Menu_Data_Path`路径读取文件内容。

六、基本方法概述

上述代码实现中，涉及了公共功能的封装，如HTTP请求的发送（get、POST等）、文件的读取等。这些功能被封装在MenuManager类中，使得对菜单的管理更加便捷。我们也提供了进行get、Post提交的方法案例代码，根据实际使用情况，建议进行适当的优化。这些功能的使用需要结合具体的业务逻辑，以达到最佳的效果。在实际使用中，可能还需要考虑错误处理、日志记录等其他方面的功能。在编程的世界里，事件处理是不可或缺的一环。当我们在微信机器人中设置了菜单，随之而来的是一系列的事件处理需求。为了应对这些事件，我们需要构建强大的事件处理机制。

想象一下，你正在构建一个智能助手，用户在微信中点击了某个按钮，这个按钮背后关联的是一系列复杂的操作和处理逻辑。如何确保这些操作顺利进行？这就需要我们深入事件处理的核心内容。

一、事件捕捉与响应

当用户在微信菜单中点击某个选项时，事件被触发并发送给服务器。服务器需要迅速捕捉到这一事件，然后作出响应。这涉及到事件的捕捉机制，即如何确保事件被准确无误地捕获并传递给处理函数。在这个过程中，我们需要确保事件的传递是高效且可靠的。

二、事件处理逻辑

捕捉到事件后，接下来就是处理事件的逻辑。根据用户的行为，我们需要执行相应的操作。例如，用户点击了查询天气的事件，那么机器人需要从天气API获取数据并返回给用户。这就需要我们编写相应的处理逻辑，确保事件得到妥善处理。

三、跨平台兼容性

考虑到微信平台的多样性，我们需要确保事件处理机制具有跨平台兼容性。这意味着在不同的操作系统和环境下，事件处理都应该保持高效稳定。这需要我们在设计时考虑到各种可能的情况，确保系统的健壮性。

四、实时反馈与调整

在处理事件的过程中，我们还需要考虑实时反馈与调整。例如，当某个事件处理逻辑出现问题时，系统应该能够实时反馈错误信息并进行调整。这就需要我们在设计时考虑到系统的可维护性和可扩展性。

五、安全性与隐私保护

在处理微信机器人事件时，我们不能忽视安全性和隐私保护的问题。确保用户数据的安全性和隐私是首要任务。我们需要采取一系列措施来保护用户信息的安全，确保系统不会被恶意攻击或数据泄露。

微信机器人的事件处理：从按钮绑定到XML消息的旅程

正如我们设计ASPX或WinForm应用时需要绑定按钮事件一样，微信机器人应用也需要对按钮事件进行处理。这次的交互，是通过XML消息传递过来的请求来实现的。

在“二、设置菜单”中，我们已经明确了具体的菜单内容，从而知道需要处理哪些事件。对于按钮类型为view的，无需特别处理，系统会自动跳转至指定url。

需要处理的点击事件包括：

1. 赞一下

2. 查询某城市的天气，包括北京、上海、武汉

3. 帮助

我们将沿用上章中的事件处理器EventHandler来扩展处理这些事件。下面，让我们深入了解一下具体的实现代码。

在编码的世界里，我们首先需要定义一些基础的东西。在York.WeiXin.Robot.Handlers命名空间中，我们有一个EventHandler类，它实现了IHandler接口。这个类的主要任务是处理微信发来的XML消息。

这个类包含以下几个关键部分：

一、属性：请求的xml。这是我们从微信接收到的原始消息，包含了触发事件的所有信息。

二、构造函数：接受一个字符串参数，即请求的xml。在对象创建时，将这个字符串赋值给RequestXml属性。

三、方法：HandleRequest()。这是处理请求的主要方法。它首先通过EventMessage.LoadFromXml()方法XML消息，然后根据事件类型（订阅或点击）调用相应的事件处理器方法（SubscribeEventHandler或ClickEventHandler）。返回处理后的响应消息。

四、私有方法：SubscribeEventHandler和ClickEventHandler。这两个方法分别处理订阅和点击事件。以SubscribeEventHandler为例，当收到订阅事件时，它会回复一条欢迎消息，告诉用户他们已经成功订阅了微信机器人服务。

点击事件的处理艺术

当每一次点击跃然屏幕之上，背后都隐藏着一段精心设计的逻辑。对于每一次触碰，我们的程序都会深情地回应。当您轻轻触碰按键时，我们的代码会迅速响应，为您带来不同的体验。

在事件消息的海洋中，我们的程序在默默聆听每一个点击的声音。当您点击“赞一下”按钮时，程序会立刻感知到您的喜爱与支持，为您送上温馨的感谢。当您点击天气预报查询按钮时，程序会迅速为您检索所在城市的天气情况，为您提供出行的参考。当您点击帮助按钮时，程序会耐心解答您的疑惑，为您排忧解难。这一切都归功于我们的点击事件处理机制。

让我们看看代码背后的故事。当接收到一个事件消息时，我们的程序会首先检查消息是否有效。一旦确认消息无误，程序会根据事件键进行不同的处理。无论是点赞、查询天气还是寻求帮助，程序都会根据您的需求做出相应的响应。例如，当您点击“赞一下”按钮时，程序会回复一条感谢消息，表达对您支持的感激之情。当您点击天气预报查询按钮时，程序会根据您所在的城市为您搜索天气情况。无论是北京、上海还是武汉，只要轻轻一点，天气信息即刻呈现。当您点击帮助按钮时，程序会提供详细的帮助信息，助您轻松解决问题。

在每一次点击背后，都隐藏着程序的智慧与努力。您的每一次触碰，都是对程序的一次肯定与鼓励。未来，我们将继续优化处理机制，为您带来更加流畅、便捷的体验。让我们一起期待更多精彩的互动吧！

帮助中心

当您需要帮助时，欢迎点击那个亲切的“帮助”按钮。您的每一个需求，我们都认真对待。

当您触发`btnHelpClick`功能时，我们会回复您一条消息，指导您如何查询天气。只需输入“tq”加上您想要查询的城市名称、拼音或首字母，我们就可以为您提供所需天气信息。

天气查询

想知道未来的天气情况？只需在“查询天气”功能中输入您关心的城市名称。我们的`searchWeather`功能会迅速调用`WeatherHelper`获取天气信息，然后发送到您的设备上。整个过程，简单、快捷、高效。

效果图展示

经过一段忙碌而充实的开发周期，我们为您带来了全新的界面体验。请查看下面的效果图，感受我们的用心与努力。我们狼蚁SEO团队始终致力于为您提供更好的服务和体验，希望我们的努力能对您的学习有所帮助，也希望得到您的持续支持与鼓励。

一路走来，感谢有您。我们狼蚁SEO团队将持续创新，为您提供更加优质的服务和内容。让我们共同期待更多的美好瞬间！