转载

用c#开发微信(5)自定义菜单设置工具 (在线demo)

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

一、使用

1. 打开 自定义菜单设置工具

2. 输入id和密码以获取token

用c#开发微信(5)自定义菜单设置工具 (在线demo)

如果已有token,也可以直接输入token进行菜单操作,注意这个token不是在微信上设置的token,是通过id和密码获取到的:

用c#开发微信(5)自定义菜单设置工具 (在线demo)

3. 点击“获取当前菜单” 以获取菜单

如果是第一次操作,没有任何菜单

用c#开发微信(5)自定义菜单设置工具 (在线demo)

4. 设置菜单

在这里就可以很直观地编辑你的菜单了,编辑菜单时请注意下面几点:

  • 官方要求:一级菜单按钮个数为2-3个
  • 官方要求:如果设置了二级菜单,子按钮个数为2-5个
  • 官方要求:按钮描述,既按钮名字,不超过16个字节,子菜单不超过40个字节
  • 如果name不填,此按钮将被忽略
  • 如果一级菜单为空,该列所有设置的二级菜单都会被忽略
  • key仅在SingleButton(单击按钮,无下级菜单)的状态下设置,如果此按钮有下级菜单,key将被忽略
  • 所有二级菜单都为SingleButton
  • 如果要快速看到微信上的菜单最新状态,需要重新关注,否则需要静静等待N小时

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

用c#开发微信(5)自定义菜单设置工具 (在线demo)

用c#开发微信(5)自定义菜单设置工具 (在线demo)

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

二、原理

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. 获取菜单

var result = CommonApi.GetMenu(token);
if (result == null)
{
return Json(new { error = "菜单不存在或验证失败!" }, JsonRequestBehavior.AllowGet);
}
return Json(result, JsonRequestBehavior.AllowGet);

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);

4. 删除菜单

var result = CommonApi.DeleteMenu(token);
var json = new
{
Success = result.errmsg == "ok",
Message = result.errmsg
};
return Json(json, JsonRequestBehavior.AllowGet);

用c#开发微信 系列汇总

正文到此结束
Loading...