微信公众平台开发之自定义菜单.Net代码解析

本文将详细讲解在.Net平台下，如何进行微信公众平台的自定义菜单开发，并附带两个样例说明。

前置要求

• 一台拥有.NET平台开发环境的计算机
• 已经完成微信公众号认证并获取了公众号的基本信息（如AppID、AppSecret）
• 至少掌握基本的微信公众平台接口调用方式

开发思路

1. 获取Access Token
2. 使用Access Token创建自定义菜单

获取Access Token

在进行自定义菜单开发之前，需要先获取Access Token。

public static string GetAccessToken(string appID, string appSecret)
{
    HttpClient httpClient = new HttpClient();
    string urlFormat = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid={0}&secret={1}";
    string url = string.Format(urlFormat, appID, appSecret);
    HttpResponseMessage response = httpClient.GetAsync(url).Result;

    if (response.IsSuccessStatusCode)
    {
        string resultContent = response.Content.ReadAsStringAsync().Result;
        return JsonConvert.DeserializeObject<TokenJsonResult>(resultContent).Access_token;
    }

    return null;
}

创建自定义菜单

获取到Access Token之后，就可以开始进行自定义菜单的创建了。

public static bool CreateMenu(Menu menu, string accessToken)
{
    HttpClient httpClient = new HttpClient();
    string urlFormat = "https://api.weixin.qq.com/cgi-bin/menu/create?access_token={0}";
    string url = string.Format(urlFormat, accessToken);

    StringContent content = new StringContent(JsonConvert.SerializeObject(menu), Encoding.UTF8, "application/json");

    HttpResponseMessage response = httpClient.PostAsync(url, content).Result;

    if (response.IsSuccessStatusCode)
    {
        string resultContent = response.Content.ReadAsStringAsync().Result;
        return JsonConvert.DeserializeObject<BaseJsonResult>(resultContent).errcode == ReturnCode.请求成功;
    }

    return false;
}

示例1：创建简单菜单

以下代码示例将创建一个包含两个一级菜单的简单自定义菜单。

var menu = new Menu();
var buttons = new List<Button>();
buttons.Add(new SingleButton
{
    name = "搜索",
    type = ButtonType.click,
    key = "search"
});
buttons.Add(new SingleButton
{
    name = "关于我们",
    type = ButtonType.view,
    url = "http://www.example.com"
});
menu.button = buttons;

string accessToken = GetAccessToken(appID, appSecret);
bool result = CreateMenu(menu, accessToken);

示例2：创建复杂菜单

以下代码示例将创建一个包含多个一级菜单和一个二级菜单的复杂自定义菜单。

var menu = new Menu();
var buttons = new List<Button>();
buttons.Add(new SingleButton
{
    name = "关于我们",
    sub_button = new List<SingleButton>
    {
        new SingleButton
        {
            name="公司简介",
            type=ButtonType.view,
            url="http://www.example.com/about"
        },
        new SingleButton
        {
            name="联系我们",
            type=ButtonType.click,
            key="contact"
        }
    }
});
buttons.Add(new SingleButton
{
    name = "产品介绍",
    sub_button = new List<SingleButton>
    {
        new SingleButton
        {
            name="产品1",
            type=ButtonType.view,
            url="http://www.example.com/product1"
        },
        new SingleButton
        {
            name="产品2",
            type=ButtonType.view,
            url="http://www.example.com/product2"
        },
        new SingleButton
        {
            name="产品3",
            type=ButtonType.view,
            url="http://www.example.com/product3"
        }
    }
});
buttons.Add(new SingleButton
{
    name = "搜索",
    type = ButtonType.click,
    key = "search"
});
menu.button = buttons;

string accessToken = GetAccessToken(appID, appSecret);
bool result = CreateMenu(menu, accessToken);

总结

在本文中，我们详细讲解了.Net平台下微信公众平台自定义菜单的开发过程，从获取Access Token到创建自定义菜单，同时也附带了两个示例，以帮助读者更好的理解和掌握该功能的开发方式。