微信公眾平台開發：個人化選單介面說明

前不久微信上線了個人化選單接口，Senparc.Weixin SDK也已經同步更新。

本次更新升級Senparc.Weixin.MP版本到v13.5.2，依賴Senparc.Weixin版本4.5.4。 .NET4.5(master) / .NET4.0兩個分支都已同步更新。

由於個人化選單變化比較大，所以對整個選單介面進行了目前為止最大面積的重構（可以向下相容）。

比較先前的自訂選單，目前整個選單相關功能針對檔案結構進行了全面的整理，：

 

#介面

　　選單介面已經全部歸入CommonAPIs/Menu目錄下，CommonApi部分類別下面再分出3個類別檔案：

#檔名	說明
CommonApi.Menu.Common.cs	選單公共方法

# #CommonApi.Menu.Conditional.cs

個人化選單

#CommonApi.Menu.Custom.cs

普通自訂選單

選單介面檔案

　　其中自訂選單介面已經確保向下相容，以前如果有已經開發自訂選單功能的項目，可以放心升級。

　　個人化選單類別內容如下：

/*----------------------------------------------------------------
    Copyright (C) 2015 Senparc
    
    文件名：CommonApi.Menu.Conditional
    文件功能描述：个性化自定义菜单接口
    
    
    创建标识：Senparc - 20151222
        
    修改标识：Senparc - 20151222
    修改描述：v13.5.1 添加个性化菜单接口
----------------------------------------------------------------*/

/*
    API：http://mp.weixin.qq.com/wiki/0/c48ccd12b69ae023159b4bfaa7c39c20.html
 */

using Senparc.Weixin.Entities;
using Senparc.Weixin.Helpers;
using Senparc.Weixin.MP.Entities;
using Senparc.Weixin.MP.Entities.Menu;

namespace Senparc.Weixin.MP.CommonAPIs
{
    public partial class CommonApi
    {
        /// <summary>
        /// 创建个新华菜单
        /// </summary>
        /// <param name="accessTokenOrAppId">AccessToken或AppId。当为AppId时，如果AccessToken错误将自动获取一次。当为null时，获取当前注册的第一个AppId。</param>
        /// <param name="buttonData">菜单内容</param>
        /// <returns></returns>
        public static CreateMenuConditionalResult CreateMenuConditional(string accessTokenOrAppId, ConditionalButtonGroup buttonData, int timeOut = Config.TIME_OUT)
        {
            return ApiHandlerWapper.TryCommonApi(accessToken =>
             {
                 var urlFormat = "https://api.weixin.qq.com/cgi-bin/menu/addconditional?access_token={0}";
                 var jsonSetting = new JsonSetting(true);
                 return CommonJsonSend.Send<CreateMenuConditionalResult>(accessToken, urlFormat, buttonData, timeOut: timeOut, jsonSetting: jsonSetting);

             }, accessTokenOrAppId);
        }


        #region GetMenu

        /* 使用普通自定义菜单查询接口可以获取默认菜单和全部个性化菜单信息，请见自定义菜单查询接口的说明 */

        /// <summary>
        /// 测试个性化菜单匹配结果
        /// </summary>
        /// <param name="accessTokenOrAppId"></param>
        /// <param name="userId">可以是粉丝的OpenID，也可以是粉丝的微信号。</param>
        /// <returns></returns>
        public static MenuTryMatchResult TryMatch(string accessTokenOrAppId, string userId)
        {
            return ApiHandlerWapper.TryCommonApi(accessToken =>
            {
                var url = string.Format("https://api.weixin.qq.com/cgi-bin/menu/delconditional?access_token={0}", accessToken);

                var data = new
                {
                    user_id = userId
                };

                return CommonJsonSend.Send<MenuTryMatchResult>(accessToken, url, data, CommonJsonSendType.POST);

            }, accessTokenOrAppId);
        }

        #endregion

        /// <summary>
        /// 删除菜单
        /// </summary>
        /// <param name="accessTokenOrAppId"></param>
        /// <param name="menuId">菜单Id</param>
        /// <returns></returns>
        public static WxJsonResult DeleteMenuConditional(string accessTokenOrAppId, string menuId)
        {
            return ApiHandlerWapper.TryCommonApi(accessToken =>
            {
                var url = string.Format("https://api.weixin.qq.com/cgi-bin/menu/delconditional?access_token={0}", accessToken);

                var data = new
                {
                    menuId = menuId
                };

                return CommonJsonSend.Send(accessToken, url, data, CommonJsonSendType.POST);

            }, accessTokenOrAppId);

        }

        /* 使用普通自定义菜单删除接口可以删除所有自定义菜单（包括默认菜单和全部个性化菜单），请见自定义菜单删除接口的说明。 */
    }
}

1. 　　選單公用方法中，GetButtonGroup()方法新增了一個參數：buttonGroup，用於指定選單按鈕清單類型（屬於個人化選單還是自訂選單）。
   　　
2. 實體
   　　有關實體類別的變更都體現在Entities/Menu目錄下，新建了IButtonGroupBase介面以及ButtonGroupBase基底類別。 ButtonGroup（自訂選單）和ConditionalButtonGroup（個人化選單）按鈕都繼承自ButtonGroupBase。
3. 　　Entities/Menu/Buttons/目錄下的所有按鈕類型都是通用的。
    

回傳類型

　　重新整理的回傳類型都在Entities/JsonResult/Menu/目錄下：

# 

# 

注意點

自訂選單和個人化選單的選單新增、刪除介面是不同的，使用的時候需要呼叫各自不同的介面。

#########如果使用個人化選單，MenuMatchRule中的規則必須至少填入一個。 ############對於使用了個人化選單和不使用，取得選單時傳回的資料是不同的（前者包含後者），因此SDK針對這兩種情況只提供了同一個實體：GetMenuResult（對應的接收訊息實體為GetMenuResultFull）。有關個新華菜單的資訊（列表）可以直接從GetMenuResult.conditionalmenu讀取，如果為null或列表為空，則表示沒有個人化選單。 ############ ######測試和視覺化編輯#######　　原始程式碼中提供了一個簡易的視覺化編輯工具，同時可以檢視得到的選單JSON資料格式（顯示的是操作的實體轉換成的JSON，非原始JSON）。 ###############更多微信公眾平台開發：個人化選單介面說明相關文章請關注PHP中文網！ ############