[c#]asp.net开发微信公众平台(8)微信9大高级接口，自定义菜单
前7篇把最基础的消息接收和回复全做完了， 也把高级接口的入口和分拆处理写好了空方法， 此篇接着介绍微信的9大高级接口， 并着重讲解其中的自定义菜单。
微信9大接口为：
1.语音识别接口
2.客服接口
3.OAuth2.0 网页授权接口
4.生成带参数的二维码接口
5.获取用户地理位置接口
6.获取用户基本信息接口
7.获取关注者列表接口
8.用户分组接口
9.上传下载多媒体文件接口
具体介绍：
1. 语音识别
功能描述：通过语音识别接口，用户发送的语音，将同时给出语音识别出的文本内容。
实用意义：第三方可以调用微信自主研发的语音识别技术。意味着微信向第三方开放语音识别技术，直接调用语音识别接口，对语音识别结果进行互动或根据识别的内容进行自动答复。
2. 客服接口
功能描述：通过客服接口，公众号可以在用户发送过消息的 12 小时内，向用户回复消息。
实用意义：以前公众帐号跟订户只能被动响应，比如用户触发了需求，如发送关键字给公众帐号，后者才可以与用户对话。如今，如果订户跟公众帐号对话过一次，公众帐号就可以在 12 个小时内持续给用户下发消息。这提高了公众帐号发送消息的能力。
3. OAuth 2.0 网页授权
功能描述：通过网页授权接口，公众号可以请求用户授权。
实用意义：这就像微博、QQ的帐号授权功能。这意味着微信帐号正式成为一个帐号系统。
4. 生成带参数二维码
功能描述：通过该接口，公众号可以获得一系列携带不同参数的二维码，在用户扫描关注公众号后，公众号可以根据参数分析各二维码的效果。
实用意义：举例来说，以前放一个二维码在网站或者线下的广告牌，效果都是一样的：获得关注用户。现在可以分析订户来自哪里。开发者可以在链接里设置特殊信息，做更多的数据分析。这一功能也可以用来做帐号绑定，
5. 获取用户地理位置
功能描述：通过该接口，公众号能够获得用户进入公众号会话时的地理位置。
实用意义：两种情况可以获得用户地理位置：一是与公众帐号“会话时”，二是在会话界面“每隔 5 秒”。在用户同意下，这就可以做微信导航或地理围栏方面的服务。
6. 获取用户基本信息
功能描述：通过该接口，公众号可以根据加密后的用户 OpenID，获取用户基础信息，包括头像、名称、性别、地区。
实用意义：以前这是一个非常高的权限。获得用户基本信息后，可以做 CRM 管理后台，方便商家管理用户。
7. 获取关注者列表
功能描述：通过该接口，用户可以获取所有关注者的 OpenID
实用意义：以前不能知道有多少人关注你，是谁在关注你。如今你可以知道谁在关注你。
8. 用户分组接口
功能描述：通过分组接口，公众号可以在后台为用户移动分组，或创建、修改分组。
实用意义：可以对用户进行分组，比如乐思享组织一场“听众交流会”，现场来了 1000 人，可以把它归为一组，后续的活动花絮照片只发给这 1000 人。这对于商家来说，就是一个 VIP 会员管理，是 CRM 管理平台。
9. 上传下载多媒体文件
功能描述：通过该接口公众号可以在需要时在微信服务器上传下载多媒体文件。
实用意义：可以下发图片、视频。比如搞笑视频，上传到微信公众账号后台，可以向听众推送出来，相当于视频网站的一个业务。
以上就是微信9大高级接口的介绍， 其实现在应该是10个了，还有1个支付功能。
下面着重写自定义菜单。
自定义菜单只需要创建一次，之后都会存在，每次更改需要等待几分钟才可看到，创建：
创建好之后：
我这里是全部添加好之后，点击创建到微信，代码：
1 public void SetMenu() 2 { 3 4 dbHome=Factory.FContext.WeiXinDbContext(); 5 var listP = DAL.ListWhere<tb_PersonalMenu, int>(dbHome, a => a.ParentId == 0&& a.State==1, a => a.ID, 3); 6 List<Dictionary<string, object>> list = new List<Dictionary<string, object>>(); 7 foreach (var row in listP) 8 { 9 var listC = DAL.ListWhere<tb_PersonalMenu, int>(dbHome, a => a.ParentId == row.ID && a.State==1, a => a.ID, 5); 10 List<Dictionary<string, object>> list2 = new List<Dictionary<string, object>>(); 11 Dictionary<string, object> dic2m = new Dictionary<string, object>(); 12 Dictionary<string, object> dic1 = new Dictionary<string, object>(); 13 14 if (listC.Count > 0) 15 { 16 foreach(var row2 in listC) 17 { 18 //2级菜单内容 19 Dictionary<string, object> dic2c = new Dictionary<string, object>(); 20 21 dic2c.Add("type", row2.Type.ToString().Replace("1", "click").Replace("2","view")); 22 dic2c.Add("name", row2.Name); 23 if(row2.Type==1) 24 dic2c.Add("key", row2.ID); 25 if (row2.Type ==2) 26 dic2c.Add("url", row2.LinkUrl); 27 28 list2.Add(dic2c); 29 } 30 //-- 31 //2级菜单组装 32 dic2m.Add("name", row.Name); 33 dic2m.Add("sub_button", JsonHelper.ListDicToJsonVals(list2)); 34 //------ 35 list.Add(dic2m); 36 } 37 else 38 { 39 //1级菜单 40 dic1.Add("type", row.Type.ToString().Replace("1", "click").Replace("2", "view")); 41 dic1.Add("name", row.Name); 42 if (row.Type == 1) 43 dic1.Add("key", row.ID); 44 if (row.Type == 2) 45 dic1.Add("url", row.LinkUrl); 46 47 48 //---------- 49 list.Add(dic1); 50 } 51 //1级和2级装成list 52 53 54 //----------- 55 56 } 57 58 59 60 61 62 63 64 65 66 string m=JsonHelper.ListDicToJsonVals(list);//将list转成json的值 下面赋值给button 67 68 //赋值给button 69 Dictionary<string, object> dicAll = new Dictionary<string, object>(); 70 dicAll.Add("button", m); 71 //--------- 72 73 74 string jsonResult = JsonHelper.GetJsonStr(dicAll);//将dic转成json 75 //转换出来的 [{},{}]也会被“”包围，要去掉“” 76 77 jsonResult = jsonResult.Replace("\"[", "[").Replace("]\"", "]"); 78 string html = HttpHelper.HttpPost("https"+"://api.weixin.qq.com/cgi-bin/menu/create?access_token="+Common.Config.SystemConfig.access_token+"", jsonResult, Encoding.UTF8); 79 80 81 dbHome.Dispose(); 82 Response.Write(JsonHelper.JsonToVal(html, "errmsg")); 83 Response.End(); 84 85 }
最终是如下格式的json数据post到微信：
{
"button":[
{
"type":"click",
"name":"今日歌曲",
"key":"V1001_TODAY_MUSIC"
},
{
"type":"click",
"name":"歌手简介",
"key":"V1001_TODAY_SINGER"
},
{
"name":"菜单",
"sub_button":[
{
"type":"view",
"name":"搜索",
"url":"http://www.soso.com/"
},
{
"type":"view",
"name":"视频",
"url":"http://v.qq.com/"
},
{
"type":"click",
"name":"赞一下我们",
"key":"V1001_GOOD"
}]
}]
}
这样就可以在微信中看到结果：
以上是属于后台管理中的创建菜单， 创建之后我们公号服务入口处对应的方法也完善下， 之前已经写好了一个空方法
public void DoMenuClick(DbContext dbHome, RMenuClick mMenuClk)
{
}
现在完善下：
1 //自定义菜单点击 2 public void DoMenuClick(DbContext dbHome, RMenuClick mMenuClk) 3 { 4 SText mStxtA = new SText(); 5 mStxtA.ToUserName = mMenuClk.FromUserName; 6 mStxtA.FromUserName = mMenuClk.ToUserName; 7 mStxtA.CreateTime = mMenuClk.CreateTime; 8 int id = 0; 9 mStxtA.Content = "欢迎使用，输入任意关键字开始体验"; 10 if(int.TryParse(mMenuClk.EventKey,out id)) 11 { 12 var me = DALWei.InfoEntities<tb_PersonalMenu>(dbHome, a => a.ID == id); 13 if(me!=null) 14 mStxtA.Content = "欢迎使用【"+me.Name+"】，介绍、说明、链接等等； 也可以是图文消息"; 15 } 16 17 Often.ResponseToEnd(DALWei.SendText(mStxtA)); 18 }
这个是点击类型的菜单处理， 需要说明的是，view类型的菜单点击就会直接跳转你所写的链接去， 1级菜单如果设置成view类型则不会跳转依旧执行点击事件；
效果：
我这里直接返回了一段文字， 实际应用中可以返回任何消息。