C#微信公衆號開發 -- （五）自定義菜單建立

時間  2019-12-14
標籤 c# 微信 公衆號 開發 自定義 菜單 建立 欄目 C# 简体版
原文   原文鏈接

公衆號中，底部都是有本身定義的功能按鈕，經過點擊某個按鈕來實現指定的業務邏輯操做。html

下面就來講說這些按鈕是怎樣放到微信公衆平臺的，仍是先來看看微信的官方解釋： api

請注意： 服務器

一、自定義菜單最多包括3個一級菜單，每一個一級菜單最多包含5個二級菜單。 微信

二、一級菜單最多4個漢字，二級菜單最多7個漢字，多出來的部分將會以「...」代替。 cookie

三、建立自定義菜單後，菜單的刷新策略是，在用戶進入公衆號會話頁或公衆號profile頁時，若是發現上一次拉取菜單的請求在5分鐘之前，就會拉取一下菜單， app

若是菜單有更新，就會刷新客戶端的菜單。測試時能夠嘗試取消關注公衆帳號後再次關注，則能夠看到建立後的效果。 微信公衆平臺

自定義菜單接口可實現多種類型按鈕，以下：（因爲click和view是最多見的事件，因此先講這兩個） post

一、click：點擊推事件 用戶點擊click類型按鈕後，微信服務器會經過消息接口推送消息類型爲event的結構給開發者（參考消息接口指南），測試

而且帶上按鈕中開發者填寫的key值， 開發者能夠經過自定義的key值與用戶進行交互；url

二、view：跳轉URL 用戶點擊view類型按鈕後，微信客戶端將會打開開發者在按鈕中填寫的網頁URL，可與網頁受權獲取用戶基本信息接口結合，得到用戶基本信息。

建立自定義菜單其實也是經過http請求方式，實現自定義菜單的寫入，請求地址： https://api.weixin.qq.com/cgi-bin/menu/create?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"
            }]
       }]
 }
觀察上面的實例能夠看出，其實就是一串JSON數據，你能夠選擇用字符串拼接的形式將其存儲，也能夠選擇文件存儲。
這裏我使用的文件儲存，將上面的實例存儲到一個叫menu.txt文件中（這裏創建的好處是能夠把自定義菜單與微信公衆號開發的程序文件分開，避免每次改自定義菜單也都要發佈程序，除非有業務邏輯的更改）。創建一個專門建立自定義菜單的頁面wxMenuManage.aspx，其實自定義菜單經過本地執行頁面就能夠將自定義菜單同步到微信服務器上面，具體請看下面的代碼：
public partial class wxMenuManage : System.Web.UI.Page
    {
        protected void Page_Load(object sender, EventArgs e)
        {
        }

        /// <summary>
        /// 讀取並建立自定義菜單
        /// </summary>
        private void CreateMenu()
        {
            FileStream fs = new FileStream(HttpContext.Current.Server.MapPath(".") + "\\menu.txt", FileMode.Open);
            StreamReader sr = new StreamReader(fs, Encoding.GetEncoding("GBK"));
            string menu = sr.ReadToEnd();
            sr.Close();
            fs.Close();
            sr.Dispose();
            fs.Dispose();

            string access_token =wxAccess_token.IsExistAccess_Token(); //獲取access_token
            string i = GetPage("https://api.weixin.qq.com/cgi-bin/menu/create?access_token=" + access_token, menu);
            Response.Write("建立菜單結果：" + i);
            Response.End();
        }

        /// <summary>
        /// 刪除菜單
        /// </summary>
        private void DeleteMenu()
        {
            string access_token =wxAccess_token.IsExistAccess_Token(); //獲取access_token
            string i = GetPage("https://api.weixin.qq.com/cgi-bin/menu/delete?access_token=" + access_token, "");
            Response.Write("刪除菜單結果：" + i);
            Response.End();
        }


        /// <summary>
        /// 獲取自定義菜單
        /// </summary>
        /// <param name="posturl">自定義菜單請求的地址</param>
        /// <param name="postData">自定義菜單內容</param>
        /// <returns></returns>
        private string GetPage(string posturl, string postData)
        {
            Stream outstream = null;
            Stream instream = null;
            StreamReader sr = null;
            HttpWebResponse response = null;
            HttpWebRequest request = null;
            Encoding encoding = Encoding.UTF8;
            byte[] data = null;
            if (postData.Length > 0) //有值表明建立菜單
            {
                data = encoding.GetBytes(postData);
            }
            
            // 準備請求...
            try
            {
                // 設置參數
                request = WebRequest.Create(posturl) as HttpWebRequest;
                CookieContainer cookieContainer = new CookieContainer();
                request.CookieContainer = cookieContainer;
                request.AllowAutoRedirect = true;
                if (postData.Length > 0)
                {
                    request.Method = "POST"; //建立菜單
                }
                else
                {
                    request.Method = "GET"; //刪除菜單
                }
                
                request.ContentType = "application/x-www-form-urlencoded";

                if (postData.Length > 0) //有值表明建立菜單
                {
                    request.ContentLength = data.Length;
                    outstream = request.GetRequestStream();
                    outstream.Write(data, 0, data.Length);
                    outstream.Close();
                }
               
                //發送請求並獲取相應迴應數據
                response = request.GetResponse() as HttpWebResponse;
                //直到request.GetResponse()程序纔開始向目標網頁發送Post請求
                instream = response.GetResponseStream();
                sr = new StreamReader(instream, encoding);
                //返回結果網頁（html）代碼
                string content = sr.ReadToEnd();
                string err = string.Empty;
                return content;
            }
            catch (Exception ex)
            {
                string err = ex.Message;
                Response.Write(err);
                Response.End();
                return string.Empty;
            }
        }

        /// <summary>
        /// 建立菜單
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        protected void btnCreate_Click(object sender, EventArgs e)
        {
            CreateMenu();
        }

        /// <summary>
        /// 刪除菜單
        /// </summary>
        /// <param name="sender"></param>
        /// <param name="e"></param>
        protected void btnDelete_Click(object sender, EventArgs e)
        {
            DeleteMenu();
        }
    }

再來看一下個人前臺頁面：

  <form id="form1" runat="server">
    <div>
      <table style="width: 100%;text-align: center;margin-top: 30px;">
          <tr>
              <td style="text-align: right;margin-right: 10px;">
                  <asp:Button runat="server" ID="btnCreate" Text="建立菜單" OnClick="btnCreate_Click"/>
              </td>
              <td style="text-align: left;margin-left: 10px;">
                  <asp:Button runat="server" ID="btnDelete" Text="刪除菜單" OnClick="btnDelete_Click"/>
              </td>
          </tr>
          <tr>
              <td colspan="2">
                  <h3 style="color: red;">*注：建立以前請先刪除菜單<br/>（建立完成以後新菜單將在五分鐘以內生效）</h3>
              </td>
          </tr>
      </table>
    </div>
    </form>

這裏須要注意的幾點：

一、頁面中我我用到了一個「建立菜單」的按鈕和一個「刪除菜單」的按鈕，由於在建立菜單以前必需要刪除以前的菜單，不然建立可能會失敗（第一次的時候能夠直接建立）

二、「wxAccess_token.IsExistAccess_Token(); //獲取access_token」方法是我將前文提到的IsExistAccess_Token()方法和GetAccess_token()都封裝到了一個wxAccess_token類中

三、建立菜單的時候請求的是https://api.weixin.qq.com/cgi-bin/menu/create?access_token=" + access_token使用POST請求，刪除菜單的時候請求的是https://api.weixin.qq.com/cgi-bin/menu/delete?access_token=" + access_token使用GET請求

四、這裏我是將menu.txt和wxMenuManage.aspx放到了同一目錄下，你在使用的時候注意他們的路徑

這些工做完成以後，就能夠在本地運行wxMenuManage.aspx頁面了，

點擊刪除菜單按鈕若是頁面輸出的結果是，「刪除菜單結果：{"errcode":0,"errmsg":"ok"}」，說明刪除成功

點擊建立菜單按鈕若是頁面輸出的結果是，「建立菜單結果：{"errcode":0,"errmsg":"ok"}"，說明建立成功

而後把你的微信公衆號取消關注，再關注就能夠看到你本身的菜單了

相關文章
相關標籤/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公眾號
   歡迎關注本站公眾號,獲取更多信息
聯繫我們 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程