用c#開發微信（5）自定義菜單設置工具 （在線建立）

上次寫了《用c#開發微信 (4) 基於Senparc.Weixin框架的接收事件推送處理 （源碼下載）》，有園友問到如何建立菜單的問題，今天就介紹下如何建立自定義菜單。

 

1 使用

1.1 打開 自定義菜單設置工具

1.2 輸入id和密碼以獲取token

 

若是已有token，也能夠直接輸入token進行菜單操做，注意這個token不是在微信上設置的token，是經過id和密碼獲取到的：

 

1.3  點擊「獲取當前菜單」 以獲取菜單

若是是第一次操做，沒有任何菜單

 

 

1.4  設置菜單 

在這裏就能夠很直觀地編輯你的菜單了，編輯菜單時請注意下面幾點：

• 官方要求：一級菜單按鈕個數爲2-3個
• 官方要求：若是設置了二級菜單，子按鈕個數爲2-5個
• 官方要求：按鈕描述，既按鈕名字，不超過16個字節，子菜單不超過40個字節
• 若是name不填，此按鈕將被忽略
• 若是一級菜單爲空，該列全部設置的二級菜單都會被忽略
• key僅在SingleButton（單擊按鈕，無下級菜單）的狀態下設置，若是此按鈕有下級菜單，key將被忽略
• 全部二級菜單都爲SingleButton
• 若是要快速看到微信上的菜單最新狀態，須要從新關注，不然須要靜靜等待N小時（通常24小時內）

 

另外，結合上篇《用c#開發微信 (4) 基於Senparc.Weixin框架的接收事件推送處理 （源碼下載） 》，下面設置的Key要與CustomMessageHandler_Events裏OnEvent_ClickRequest事件的EventKey對應起來，纔會work：

 

 

  

1.5  點擊「更新到服務器」以更新菜單

 

2 原理

2.1 獲取token

if (!AccessTokenContainer.CheckRegistered(appId))

{

    AccessTokenContainer.Register(appId, appSecret);

}

var result = AccessTokenContainer.GetTokenResult(appId); //CommonAPIs.CommonApi.GetToken(appId, appSecret);

//也能夠直接一步到位：

//var result = AccessTokenContainer.TryGetToken(appId, appSecret);

 

2.2 獲取菜單

var result = CommonApi.GetMenu(token);

if (result == null)

{

    return Json(new { error = "菜單不存在或驗證失敗！" }, JsonRequestBehavior.AllowGet);

}

return Json(result, JsonRequestBehavior.AllowGet);

 

2.3 建立、更新菜單

//從新整理按鈕信息

var bg = CommonApi.GetMenuFromJsonResult(resultFull).menu;

var result = CommonApi.CreateMenu(token, bg);

var json = new

{

    Success = result.errmsg == "ok",

    Message = result.errmsg

};

return Json(json);

 

2.4 刪除菜單

var result = CommonApi.DeleteMenu(token);

var json = new

{

    Success = result.errmsg == "ok",

    Message = result.errmsg

};

return Json(json, JsonRequestBehavior.AllowGet);

 

 

3. 錯誤

3.1 40033 錯誤

不合法的請求字符，不能包含\uxxxx格式的字符

invalid charset. please check your request, if include \uxxxx will create fail!

有一次想把微信小店的加到菜單裏：http://mp.weixin.qq.com/bizmall/mallshelf?id=&t=mall/list&biz=MzAwNDUzNjkwNw==&shelf_id=1&showwxpaytitle=1#wechat_redirect

序列化時會把url裏的字符 & 變成 \\u0026 , 因此會報這個錯誤，解決方法：

JavaScriptSerializer js = new JavaScriptSerializer();

var jsonString = js.Serialize(buttonData).Replace("\\u0026","&");

 

 

用c#開發微信 系列彙總