上次寫了《用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","&");