通过程序方式实现自定义菜单,通过http请求封装类交互微信自定义菜单接口
1、得到AccessToken
access_token是公众号的全局唯一票据,公众号调用各接口时都需使用access_token。正常情况下access_token有效期为7200秒,重复获取将导致上次获取的access_token失效。由于获取access_token的api调用次数非常有限,建议开发者全局存储与更新access_token,频繁刷新access_token会导致api调用受限,影响自身业务。
请开发者注意,由于技术升级,公众平台的开发接口的access_token长度将增长,其存储至少要保留512个字符空间。此修改将在1个月后生效,请开发者尽快修改兼容。
公众号可以使用AppID和AppSecret调用本接口来获取access_token。AppID和AppSecret可在开发模式中获得(需要已经成为开发者,且帐号没有异常状态)。注意调用所有微信接口时均需使用https协议。点击查看微信接口开发文档
这里通过SettingHelper.cs进行操作,通过该类存储access_token,避免重复获取;using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.Web; using System.Xml.Linq; public class SettingHelper { private readonly static string filePath = AppDomain.CurrentDomain.BaseDirectory + "Config.xml"; static SettingHelper() { if (!System.IO.File.Exists(filePath)) SetDefSetting(); } public static void SetDefSetting() { var doc = new XDocument(); doc.Add(new XElement("root", new XElement("accesstoken", ""), new XElement("expires_in", ""), new XElement("get_token_time", DateTime.Now.ToString()) )); doc.Save(filePath); } public static string GetSettingByAccessToken() { var doc = XDocument.Load(filePath); var token = doc.Element("root").Element("accesstoken").Value; var expires = doc.Element("root").Element("expires_in").Value; var time = Convert.ToDateTime(doc.Element("root").Element("get_token_time").Value); if (string.IsNullOrWhiteSpace(token) || string.IsNullOrWhiteSpace(expires)) return string.Empty; time = time.AddSeconds(Convert.ToInt32(expires)); if (time > DateTime.Now) return token; else return string.Empty; } public static void SaveSettingByAccessToken(string accessToken, string expiresIn) { var doc = XDocument.Load(filePath); doc.Element("root").Element("accesstoken").Value = accessToken; doc.Element("root").Element("expires_in").Value = expiresIn; doc.Element("root").Element("get_token_time").Value = DateTime.Now.ToString(); doc.Save(filePath); } /// <summary> /// 获取accesstoken /// </summary> /// <returns></returns> public static string GetAccessToken() { var pm = new Paraments(); var query = new StringBuilder(); query.Append(pm.TokenUrl); query.Append(string.Format("?{0}={1}", "grant_type", "client_credential")); query.Append(string.Format("&{0}={1}", "appid", pm.AppKey)); query.Append(string.Format("&{0}={1}", "secret", pm.AppSecret)); var json = HttpHelper.Get(query.ToString()); var result = JsonHelper.Deserialize(json); if (result.access_token == null) return string.Empty; SettingHelper.SaveSettingByAccessToken((string)result.access_token, (string)result.expires_in); return (string)result.access_token; } }
2、通过http请求封装类交互微信自定义菜单接口
点击这里查看我前面讲到的前一章:微信公众号开发系列-Http请求封装基类HttPhelper.cs下面接口请求已用到。
protected void btnCreate_Click(object sender, EventArgs e) { var accessToken = SettingHelper.GetSettingByAccessToken(); if (string.IsNullOrWhiteSpace(accessToken)) accessToken = SettingHelper.GetAccessToken(); if (string.IsNullOrWhiteSpace(accessToken)) { Response.Write(accessToken); return; } var data = "{\"button\": [{\"name\":\"公司介绍\", \"sub_button\": [{\"type\": \"click\",\"name\": \"公司简介\",\"key\": \"m_znq\"},{\"type\": \"click\",\"name\": \"关于我们\",\"key\": \"m_xpdz\"},{\"type\": \"click\",\"name\": \"交通方式\",\"key\": \"m_jmt\"}]},"; data += "{\"name\": \"解决方案\",\"sub_button\": [{\"type\": \"click\",\"name\": \"电商解决方案\",\"key\": \"电商解决方案\"},{\"type\": \"click\",\"name\": \"HR人事管理解决方案\",\"key\": \"人事管理解决方案\"},{\"type\": \"click\",\"name\": \"物业管理方案\",\"key\": \"物业管理方案\"}]},"; data += "{\"name\": \"业务领域\",\"sub_button\": [{\"type\": \"view\",\"name\": \"业务范围\",\"url\": \"http://www.haiyusoft.com\"},{\"type\": \"click\",\"name\": \"联合研发中心\",\"key\": \"m_about\"},{\"type\": \"click\",\"name\": \"我要绑定\",\"key\": \"我要绑定\"}]}]}"; var json = HttpHelper.Post("https://api.weixin.qq.com/cgi-bin/menu/create?access_token=" + accessToken, data); Response.Write(json); Response.End(); }
目前自定义菜单最多包括3个一级菜单,每个一级菜单最多包含5个二级菜单。一级菜单最多4个汉字,二级菜单最多7个汉字,多出来的部分将会以“...”代替。请注意,创建自定义菜单后,由于微信客户端缓存,需要24小时微信客户端才会展现出来。建议测试时可以尝试取消关注公众账号后再次关注,则可以看到创建后的效果。
自定义菜单接口可实现多种类型按钮,如下:点击查看微信开发文档-微信自定义菜单创建
1、click:点击推事件 用户点击click类型按钮后,微信服务器会通过消息接口推送消息类型为event 的结构给开发者(参考消息接口指南),并且带上按钮中开发者填写的key值,开发者可以通过自定义的key值与用户进行交互; 2、view:跳转URL 用户点击view类型按钮后,微信客户端将会打开开发者在按钮中填写的网页URL,可与网页授权获取用户基本信息接口结合,获得用户基本信息。 3、scancode_push:扫码推事件 用户点击按钮后,微信客户端将调起扫一扫工具,完成扫码操作后显示扫描结果(如果是URL,将进入URL),且会将扫码的结果传给开发者,开发者可以下发消息。 4、scancode_waitmsg:扫码推事件且弹出“消息接收中”提示框 用户点击按钮后,微信客户端将调起扫一扫工具,完成扫码操作后,将扫码的结果传给开发者,同时收起扫一扫工具,然后弹出“消息接收中”提示框,随后可能会收到开发者下发的消息。 5、pic_sysphoto:弹出系统拍照发图 用户点击按钮后,微信客户端将调起系统相机,完成拍照操作后,会将拍摄的相片发送给开发者,并推送事件给开发者,同时收起系统相机,随后可能会收到开发者下发的消息。 6、pic_photo_or_album:弹出拍照或者相册发图 用户点击按钮后,微信客户端将弹出选择器供用户选择“拍照”或者“从手机相册选择”。用户选择后即走其他两种流程。 7、pic_weixin:弹出微信相册发图器 用户点击按钮后,微信客户端将调起微信相册,完成选择操作后,将选择的相片发送给开发者的服务器,并推送事件给开发者,同时收起相册,随后可能会收到开发者下发的消息。 8、location_select:弹出地理位置选择器 用户点击按钮后,微信客户端将调起地理位置选择工具,完成选择操作后,将选择的地理位置发送给开发者的服务器,同时收起位置选择工具,随后可能会收到开发者下发的消息。
请注意,3到8的所有事件,仅支持微信iPhone5.4.1以上版本,和Android5.4以上版本的微信用户,旧版本微信用户点击后将没有回应,开发者也不能正常接收到事件推送。