C#C#开发微信门户及使用(29)–微信个性化菜单的落到实处

有一段时间没有随着微信的宗旨继续介绍其中的作用模块了,那段时日来,微信也做了许多的变化改动,针对那一个特色我周到核对了一下相关的微信公众号和商店号的接口,对原来的微信API和系统管理做了周全的翻新,本随笔以及背后的小说就是依据那个工作上的下结论,以期把微信涉及的功用模块,都使用C#落到实处的不二法门来介绍。本小说紧要介绍微信公众号的个性化菜单的贯彻,就算眼前微信公众号和店铺号已经在职能上接近一致,可是在店铺号上还未曾个性化菜单的连带接口。

1、个性化菜单介绍

俺们先明白一下个性化菜单的牵线,按照官方的材料,如下介绍。

为了帮扶群众号已毕灵活的政工运营,微信公众平台新增了个性化菜单接口,开发者可以透过该接口,让民众号的两样用户群体看到不均等的自定义菜单。该接口开放给已证实订阅号和已证实服务号。

开发者可以因此以下原则来安装用户观望的食谱:

1、用户分组(开发者的业务需求可以借助用户分组来完成)
2、性别
3、手机操作系统
4、地区(用户在微信客户端设置的地区)
5、语言(用户在微信客户端设置的语言)

个性化菜单接口表达:

1、个性化菜单要求用户的微信客户端版本在iPhone6.2.2,Android 6.2.4以上。
2、菜单的刷新策略是,在用户进入公众号会话页或公众号profile页时,如果发现上一次拉取菜单的请求在5分钟以前,就会拉取一下菜单,如果菜单有更新,就会刷新客户端的菜单。测试时可以尝试取消关注公众账号后再次关注,则可以看到创建后的效果。
3、普通公众号的个性化菜单的新增接口每日限制次数为2000次,删除接口也是2000次,测试个性化菜单匹配结果接口为20000次
4、出于安全考虑,一个公众号的所有个性化菜单,最多只能设置为跳转到3个域名下的链接
5、创建个性化菜单之前必须先创建默认菜单(默认菜单是指使用普通自定义菜单创建接口创建的菜单)。如果删除默认菜单,个性化菜单也会全部删除

个性化菜单匹配规则表达:

当公众号创建多个个性化菜单时,将按照发布顺序,由新到旧逐一匹配,直到用户信息与matchrule相符合。如果全部个性化菜单都没有匹配成功,则返回默认菜单。
例如公众号先后发布了默认菜单,个性化菜单1,个性化菜单2,个性化菜单3。那么当用户进入公众号页面时,将从个性化菜单3开始匹配,如果个性化菜单3匹配成功,则直接返回个性化菜单3,否则继续尝试匹配个性化菜单2,直到成功匹配到一个菜单。
根据上述匹配规则,为了避免菜单生效时间的混淆,决定不予提供个性化菜单编辑API,开发者需要更新菜单时,需将完整配置重新发布一轮。

除常规的默许菜单外,个性化菜单提供了上边多少个处理操作。

1 创制个性化菜单

2 删除个性化菜单

3 测试个性化菜单匹配结果

4 查询个性化菜单

5 删除所有菜单

个性化自定义菜单作用,是指公司可以根据粉丝的分组、性别、手机操作系统,甚至地区,来分别彰显公众号的食谱。

譬如,一家健身会所的公众号,将自定义菜单根据粉丝性别进行了分离设置。男性粉丝进入公众号会显示男生们相比较感兴趣菜单内容,跆拳道、搏击等;即使女性粉丝,则会突显瑜伽、舞蹈、防身术等女性粉丝感兴趣的菜单课程等。

C# 1

 

2、个性化菜单的C#统筹处理

微信的菜系是微信处理中很要紧的一环,因为它是微信给用户输入体验主要的一环,也是很直观的界面突显之一,菜单的来得就是内需我们苦思苦想来精简的界面元素了,由于菜单的最首要以及功用的丰盛性,我在前头好几篇小说专门介绍了菜单的种种处理。

在《C#支出微信门户及应用(6)–微信门户菜单的管理操作》、《C#支付微信门户及选择(9)-微信门户菜单管理及提交到微信服务器》、《C#开发微信门户及利用(11)–微信菜单的有余表现方法介绍》、《C#付出微信门户及使用(20)-微信公司号的菜系管理》分别对有关的菜谱有过介绍,有需求可以参照精晓一下。

菜单模块,在微信公众号和公司号,它们都得以共用一个模型,因此大家把这个情节都坐落微信共用模块里面,包涵它的实体类音信(如菜单模块),纵然有些地点,部分字段内容并未,不过大家可以通过实体类的JSON标识来举办处理,从而达成比较弹性化的实体类消息承载。

如下标识代码所示。

    /// <summary>
    /// 菜单基本信息(公众号、企业号公用,其他部分一样)
    /// </summary>
    public class MenuJson : BaseJsonResult
    {
        /// <summary>
        /// 按钮描述,既按钮名字,不超过16个字节,子菜单不超过40个字节
        /// </summary>
        public string name { get; set; }

        /// <summary>
        /// 按钮类型(click或view)
        /// </summary>
        [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
        public string type { get; set; }

        /// <summary>
        /// 按钮KEY值,用于消息接口(event类型)推送,不超过128字节
        /// </summary>
        [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
        public string key { get; set; }

        /// <summary>
        /// 网页链接,用户点击按钮可打开链接,不超过256字节
        /// </summary>
        [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
        public string url { get; set; }

        /// <summary>
        /// media_id类型和view_limited类型必须,调用新增永久素材接口返回的合法media_id
        /// </summary>
        [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
        public string media_id { get; set; }

        /// <summary>
        /// 子按钮数组,按钮个数应为2~5个
        /// </summary>
        [JsonProperty(NullValueHandling = NullValueHandling.Ignore)]
        public List<MenuJson> sub_button { get; set; }

地方这些实体类是菜单音信的功底新闻,咱们要求从这几个基础上扩展出来多少个实体类,方便在营造,获取菜单音讯的时候进行新闻转换,如下多少个类图的安排所示。

C# 2

通过那多少个类的关联,大家就足以适应所有的默许菜单和个性化菜单,以及店堂号的菜系新闻转换处理了,通过JSON转换为相应的实体类,已毕新闻的强类型处理。

里面大家菜单处理的API落成类代码如下所示。

    /// <summary>
    /// 菜单的相关操作
    /// </summary>
    public class MenuApi : IMenuApi

诸如此类大家在IMenuApi的基础上平添多少个个性化的接口。

        /// <summary>
        /// 创建个性化菜单
        /// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="menuJson">菜单对象</param>
        /// <returns></returns>
        string CreateConditionalMenu(string accessToken, MenuListJson menuJson);

        /// <summary>
        /// 根据菜单ID删除个性化菜单
        /// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="menuid">菜单ID</param>
        /// <returns></returns>
        CommonResult DeleteConditionalMenu(string accessToken, string menuid);

        /// <summary>
        /// 测试个性化菜单匹配结果
        /// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <returns></returns>
        MenuListJson TryMatchConditionalMenu(string accessToken, string user_id);

接下来在MenuApi兑现类里面落成相关的逻辑处理即可。

上面是开创个性化菜单的接口说明。

开创个性化菜单

http请求格局:POST(请使用https协议)

https://api.weixin.qq.com/cgi-bin/menu/addconditional?access_token=ACCESS_TOKEN

呼吁示例

{
    "button":[
    {   
        "type":"click",
        "name":"今日歌曲",
        "key":"V1001_TODAY_MUSIC" 
    },
    { 
        "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"
        }]
 }],
"matchrule":{
  "group_id":"2",
  "sex":"1",
  "country":"中国",
  "province":"广东",
  "city":"广州",
  "client_platform_type":"2"
  "language":"zh_CN"
  }
}

其中地点的音信,转换为我们的实体类对象音讯就是之类所示。

MenuListJson menuJson

它API重返结果如下所示。

{
    "menuid":"208379533"
}

为了承载这几个音讯,大家须要定义一个实体类来承载那几个音信。

    /// <summary>
    /// 返回MenuId的结果
    /// </summary>
    public class MenuIdResult
    {       
        /// <summary>
        /// 菜单的ID
        /// </summary>
        public string menuid { get; set; }
    }

最终大家的API接口只须求得到里面的菜系ID值,字符串类型的就足以了,API具体完结代码如下所示。

        /// <summary>
        /// 创建个性化菜单
        /// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="menuJson">菜单对象</param>
        /// <returns></returns>
        public string CreateConditionalMenu(string accessToken, MenuListJson menuJson)
        {
            string result = "";
            var url = string.Format("https://api.weixin.qq.com/cgi-bin/menu/addconditional?access_token={0}", accessToken);
            //matchrule不能为空
            ArgumentValidation.CheckForNullReference(menuJson.matchrule, "matchrule");

            string postData = menuJson.ToJson();
            MenuIdResult list = JsonHelper<MenuIdResult>.ConvertJson(url, postData);
            if (list != null)
            {
                result = list.menuid;
            }
            return result;
        }

而删除个性化菜单的接口也是相近的拍卖,如下所示。

        /// <summary>
        /// 根据菜单ID删除个性化菜单
        /// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="menuid">菜单ID</param>
        /// <returns></returns>
        public CommonResult DeleteConditionalMenu(string accessToken, string menuid)
        {
            var url = string.Format("https://api.weixin.qq.com/cgi-bin/menu/delconditional?access_token={0}", accessToken);
            var data = new
            {
                menuid = menuid
            };

            string postData = data.ToJson();
            return Helper.GetExecuteResult(url, postData);
        }

除此以外,对于个性化菜单来说,查询、删除所有的菜谱操作接口和日常默许菜单是如出一辙的,因而得以选用那八个接口,不过由于大家增加了查询重回的信息类,所以假诺是个性化菜单,那么它回到的JSON字符串里面,蕴涵了conditionalmenu的性质,那么些是一个集合
,也就是说个性化菜单是八个规则的个性化菜单的联谊。

C# 3

菜单的JSON数据结构如下所示。

C# 4

 

3、个性化菜单封装接口的运用

有了上面接口的包装,咱们得以在开创个性化菜单的时候很便利了,构建个性化菜单的时候,大家须求把全体急需出现的食谱都必要放在一个conditionalmenu的单元里面,纵然如此的单元在联谊里面出现四个。

如上边是创设一个个性化的菜单系列,和平时的默许菜单不一样,它必要指定一个matchrule的对象,如下代码所示。

            MenuJson conditional = new MenuJson("相关链接", new MenuJson[] { 
                new MenuJson("个性化菜单", ButtonType.click, "event_company")
            });
            MatchRule rule = new MatchRule()
            {
                sex = "1"
            };

            MenuListJson menuJson = new MenuListJson();
            menuJson.button.AddRange(new MenuJson[] { conditional });
            menuJson.matchrule = rule;

经过地方的代码了解,大家若是须要充实三个个性化菜单,那么就是因此这几个主意,每一遍成立一个个性化菜单的办法举办打造,当然如若大家采纳查询个性化菜单的结果可以看出,假设创造四个,那么conditionalmenu集合里面是两个对象的。

调用代码每一趟添加一个个性化菜单的操作如下所示。

                string menuid = menuBLL.CreateConditionalMenu(token, menuJson);
                Console.WriteLine("创建菜单:" + (!string.IsNullOrEmpty(menuid) ? "成功:" + menuid : "失败"));

俺们创制多少个规则后,可以因此TryMatch的办法来检查匹配的结果,也就是对应差距用户(openid)会油然则生分化的个性化菜单列表了。

                    var myResult = menuBLL.TryMatchConditionalMenu(token, openId);
                    if (myResult != null)
                    {
                        Console.WriteLine(myResult.ToJson());
                    }

                    var userid_female = "oSiLnt2J4mYkhVG3aLTdMIF1hv-s";//女性的ID
                    myResult = menuBLL.TryMatchConditionalMenu(token, userid_female);
                    if (myResult != null)
                    {
                        Console.WriteLine(myResult.ToJson());
                    }

 

如若对那几个《C#付出微信门户及运用》连串感兴趣,可以关怀我的其它文章,连串小说如下所示:

C#付出微信门户及运用(28)–微信“摇一摇·周边”功效的采纳和接口的完结

C#付出微信门户及应用(27)-公众号模板音讯管理 

C#支出微信门户及拔取(26)-公众号微信资料管理

C#支付微信门户及利用(25)-微信公司号的客户端管住成效

C#开发微信门户及使用(24)-微信小店货架新闻保管

C#付出微信门户及运用(23)-微信小店商品管理接口的卷入和测试

C#支出微信门户及利用(22)-微信小店的付出和动用

C#支付微信门户及选择(21)-微信集团号的新闻和事件的收各处理及解密 

C#开发微信门户及运用(20)-微信公司号的食谱管理

C#开发微信门户及应用(19)-微信公司号的音信发送(文本、图片、文件、语音、摄像、图文新闻等)

C#开发微信门户及使用(18)-微信集团号的通信录管理支付之成员管理

C#开发微信门户及选择(17)-微信集团号的通讯录管理支付之部门管理

C#付出微信门户及利用(16)-微信集团号的布署和采取

C#支出微信门户及应用(15)-微信菜单增添扫一扫、发图片、发地理地点成效

 C#支出微信门户及选择(14)-在微信菜单中利用重定向获取用户数量

C#支付微信门户及利用(13)-使用地理地方伸张相关应用

C#开发微信门户及应用(12)-使用语音处理

C#付出微信门户及拔取(11)–微信菜单的多样展现方法介绍

C#支出微信门户及利用(10)–在管制种类中一起微信用户分组音信

C#支出微信门户及使用(9)-微信门户菜单管理及提交到微信服务器

C#支付微信门户及运用(8)-微信门户应用管理连串机能介绍

C#开发微信门户及应用(7)-微信多客服成效及支付集成

C#付出微信门户及采纳(6)–微信门户菜单的田间管理操作

C#支出微信门户及利用(5)–用户分组消息保管

C#支付微信门户及使用(4)–关切用户列表及详细新闻管理

C#开发微信门户及运用(3)–文本音讯和图文音讯的答复

C#付出微信门户及应用(2)–微信音讯的处理和答复

C#支出微信门户及采用(1)–初叶运用微信接口

相关文章