用c#开发微信（5）自定义菜单设置工具 （在线建立）

上次写了《用c#开发微信 (4) 基于Senparc.Weixin框架的接收事件推送处理 （源码下载）》，有园友问到如何建立菜单的问题，今天就介绍下如何建立自定义菜单。

 

1 使用

1.1 打开 自定义菜单设置工具

1.2 输入id和密码以获取token

 

若是已有token，也能够直接输入token进行菜单操做，注意这个token不是在微信上设置的token，是经过id和密码获取到的：

 

1.3  点击“获取当前菜单” 以获取菜单

若是是第一次操做，没有任何菜单

 

 

1.4  设置菜单 

在这里就能够很直观地编辑你的菜单了，编辑菜单时请注意下面几点：

• 官方要求：一级菜单按钮个数为2-3个
• 官方要求：若是设置了二级菜单，子按钮个数为2-5个
• 官方要求：按钮描述，既按钮名字，不超过16个字节，子菜单不超过40个字节
• 若是name不填，此按钮将被忽略
• 若是一级菜单为空，该列全部设置的二级菜单都会被忽略
• key仅在SingleButton（单击按钮，无下级菜单）的状态下设置，若是此按钮有下级菜单，key将被忽略
• 全部二级菜单都为SingleButton
• 若是要快速看到微信上的菜单最新状态，须要从新关注，不然须要静静等待N小时（通常24小时内）

 

另外，结合上篇《用c#开发微信 (4) 基于Senparc.Weixin框架的接收事件推送处理 （源码下载） 》，下面设置的Key要与CustomMessageHandler_Events里OnEvent_ClickRequest事件的EventKey对应起来，才会work：

 

 

  

1.5  点击“更新到服务器”以更新菜单

 

2 原理

2.1 获取token

if (!AccessTokenContainer.CheckRegistered(appId))

{

    AccessTokenContainer.Register(appId, appSecret);

}

var result = AccessTokenContainer.GetTokenResult(appId); //CommonAPIs.CommonApi.GetToken(appId, appSecret);

//也能够直接一步到位：

//var result = AccessTokenContainer.TryGetToken(appId, appSecret);

 

2.2 获取菜单

var result = CommonApi.GetMenu(token);

if (result == null)

{

    return Json(new { error = "菜单不存在或验证失败！" }, JsonRequestBehavior.AllowGet);

}

return Json(result, JsonRequestBehavior.AllowGet);

 

2.3 建立、更新菜单

//从新整理按钮信息

var bg = CommonApi.GetMenuFromJsonResult(resultFull).menu;

var result = CommonApi.CreateMenu(token, bg);

var json = new

{

    Success = result.errmsg == "ok",

    Message = result.errmsg

};

return Json(json);

 

2.4 删除菜单

var result = CommonApi.DeleteMenu(token);

var json = new

{

    Success = result.errmsg == "ok",

    Message = result.errmsg

};

return Json(json, JsonRequestBehavior.AllowGet);

 

 

3. 错误

3.1 40033 错误

不合法的请求字符，不能包含\uxxxx格式的字符

invalid charset. please check your request, if include \uxxxx will create fail!

有一次想把微信小店的加到菜单里：http://mp.weixin.qq.com/bizmall/mallshelf?id=&t=mall/list&biz=MzAwNDUzNjkwNw==&shelf_id=1&showwxpaytitle=1#wechat_redirect

序列化时会把url里的字符 & 变成 \\u0026 , 因此会报这个错误，解决方法：

JavaScriptSerializer js = new JavaScriptSerializer();

var jsonString = js.Serialize(buttonData).Replace("\\u0026","&");

 

 

用c#开发微信 系列汇总