微信開發(fā)交流群:148540125
系列文章參考地址 極速開發(fā)微信公眾號
歡迎留言靶瘸、轉(zhuǎn)發(fā)寝优、打賞
項目源碼參考地址 點我點我--歡迎Start
前幾篇文章已講完如何導(dǎo)入項目条舔,如何啟動配置項目,如何成為開發(fā)者乏矾,重源碼分析消息是如何交互(如果前四項不是很清楚可以看這里 極速開發(fā)微信公眾號孟抗。這篇文章就來講講如果實現(xiàn)自定義菜單
實現(xiàn)自定義菜單有兩種方式
1、編輯模式
2钻心、開發(fā)模式
編輯模式就很簡單了就不贅述了......
開發(fā)模式實現(xiàn)自定義菜單
1凄硼、使用微信公眾平臺接口調(diào)試工具實現(xiàn)
2、使用官方提供的接口實現(xiàn)
前期準(zhǔn)備
注意:
1捷沸、目前訂閱號
只能使用編輯模式而且不能添加超鏈接摊沉,微信認(rèn)證之后才可以使用開發(fā)模式。
2痒给、編輯模式與開發(fā)模式不能同時開啟
3说墨、生成的菜單不會立即顯示(隔天)骏全,如果想立即看到效果可以取消關(guān)注再關(guān)注
添加插件
使用微信公眾平臺接口調(diào)試工具實現(xiàn)
可以看到需要兩個參數(shù)而且都是必填 access_token
body
有人要問,這兩個參數(shù)如何獲取呢婉刀?
body
其實就是要生成菜單的JSON對象
官方有提供一個栗子可以參考吟温。
{
"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"
}]
}]
}
access_token
的獲取如下圖
使用官方提供的接口實現(xiàn)
初次了解微信自定義菜單的同學(xué)建議先看看官方的文檔3遍
在Jfinal-weixin
中有封裝菜單的創(chuàng)建、查詢突颊、刪除鲁豪、以及個性化菜單的創(chuàng)建、查詢律秃、刪除爬橡、測試個性化菜單匹配結(jié)果
那么問題來了,封裝好了如何使用呢棒动?
以下是提供封裝的接口
//查詢自定義菜單
public static ApiResult getMenu() {
String jsonResult = HttpUtils.get(getMenu + AccessTokenApi.getAccessTokenStr());
return new ApiResult(jsonResult);
}
//創(chuàng)建自定義菜單
public static ApiResult createMenu(String jsonStr) {
String jsonResult = HttpUtils.post(createMenu + AccessTokenApi.getAccessTokenStr(), jsonStr);
return new ApiResult(jsonResult);
}
//刪除自定義菜單
public static ApiResult deleteMenu() {
String jsonResult = HttpUtils.get(deleteMenuUrl + AccessTokenApi.getAccessTokenStr());
return new ApiResult(jsonResult);
}
//創(chuàng)建個性化自定義菜單
public static ApiResult addConditional(String jsonStr) {
String jsonResult = HttpUtils.post(addConditionalUrl + AccessTokenApi.getAccessTokenStr(), jsonStr);
return new ApiResult(jsonResult);
}
//刪除個性化自定義菜單
public static ApiResult delConditional(String menuid) {
HashMap params = new HashMap();
params.put("menuid", menuid);
String url = delConditionalUrl + AccessTokenApi.getAccessTokenStr();
String jsonResult = HttpUtils.post(url, JsonUtils.toJson(params));
return new ApiResult(jsonResult);
}
//測試個性化菜單匹配結(jié)果
public static ApiResult tryMatch(String userId) {
HashMap params = new HashMap();
params.put("user_id", userId);
String url = tryMatchUrl + AccessTokenApi.getAccessTokenStr();
String jsonResult = HttpUtils.post(url, JsonUtils.toJson(params));
return new ApiResult(jsonResult);
}
public static ApiResult getCurrentSelfMenuInfo() {
String jsonResult = HttpUtils.get(getCurrentSelfMenuInfoUrl + AccessTokenApi.getAccessTokenStr());
return new ApiResult(jsonResult);
}
在開源項目weixin_guide中com.javen.weixin.menu.MenuManager
類中提供了詳細(xì)使用的Demo
public static void main(String[] args) {
// 將菜單對象轉(zhuǎn)換成json字符串
String jsonMenu = JsonKit.toJson(getTestMenu()).toString();
System.out.println(jsonMenu);
ApiConfig ac = new ApiConfig();
// 配置微信 API 相關(guān)常量 請使用你自己公眾號的
ac.setAppId("wx614c453e0d1dcd12");
ac.setAppSecret("19a02e4927d346484fc70327970457f9");
// ac.setAppId(PropKit.get("appId"));
// ac.setAppSecret(PropKit.get("appSecret"));
ApiConfigKit.setThreadLocalApiConfig(ac);
//創(chuàng)建菜單
ApiResult apiResult=MenuApi.createMenu(jsonMenu);
System.out.println(apiResult.getJson());
}
可以看到main方法中調(diào)用了MenuApi.createMenu(jsonMenu)
那jsonMenu
從何而來呢糙申?
其實這里是將自定義菜單的實體對象轉(zhuǎn)化為了JSON
String jsonMenu = JsonKit.toJson(getTestMenu()).toString();
菜單的封裝
/**
* 組裝菜單數(shù)據(jù)
*
* @return
*/
private static Menu getTestMenu() {
ClickButton btn11 = new ClickButton();
btn11.setName("微信相冊發(fā)圖");
btn11.setType("pic_weixin");
btn11.setKey("rselfmenu_1_1");
ClickButton btn12 = new ClickButton();
btn12.setName("拍照或者相冊發(fā)圖");
btn12.setType("pic_photo_or_album");
btn12.setKey("rselfmenu_1_2");;
ClickButton btn13 = new ClickButton();
btn13.setName("系統(tǒng)拍照發(fā)圖");
btn13.setType("pic_sysphoto");
btn13.setKey("rselfmenu_1_3");
ClickButton btn21 = new ClickButton();
btn21.setName("掃碼帶提示");
btn21.setType("scancode_waitmsg");
btn21.setKey("rselfmenu_2_1");;
ClickButton btn22 = new ClickButton();
btn22.setName("掃碼推事件");
btn22.setType("scancode_push");
btn22.setKey("rselfmenu_2_2");;
ViewButton btn23 = new ViewButton();
btn23.setName("我的設(shè)備");
btn23.setType("view");
btn23.setUrl("https://hw.weixin.qq.com/devicectrl/panel/device-list.html?appid=wx614c453e0d1dcd12");
ViewButton btn31 = new ViewButton();
btn31.setName("微社區(qū)");
btn31.setType("view");
btn31.setUrl("http://whsf.tunnel.mobi/whsf/msg/wsq");
ClickButton btn32 = new ClickButton();
btn32.setName("發(fā)送位置");
btn32.setType("location_select");
btn32.setKey("rselfmenu_3_2");
//http://tencent://message/?uin=572839485&Site=在線咨詢&Menu=yes
//http://wpa.qq.com/msgrd?v=3&uin=572839485&site=qq&menu=yes
ViewButton btn33 = new ViewButton();
btn33.setName("在線咨詢");
btn33.setType("view");
btn33.setUrl("http://wpa.qq.com/msgrd?v=3&uin=572839485&site=qq&menu=yes");
ViewButton btn34 = new ViewButton();
btn34.setName("我的博客");
btn34.setType("view");
btn34.setUrl("http://www.cnblogs.com/zyw-205520");
ClickButton btn35 = new ClickButton();
btn35.setName("點擊事件");
btn35.setType("click");
btn35.setKey("rselfmenu_3_5");
ComButton mainBtn1 = new ComButton();
mainBtn1.setName("發(fā)圖");
mainBtn1.setSub_button(new Button[] { btn11, btn12, btn13});
ComButton mainBtn2 = new ComButton();
mainBtn2.setName("掃碼");
mainBtn2.setSub_button(new Button[] { btn21, btn22 ,btn23});
ComButton mainBtn3 = new ComButton();
mainBtn3.setName("個人中心");
mainBtn3.setSub_button(new Button[] { btn31, btn32, btn33, btn34 ,btn35 });
/**
* 這是公眾號xiaoqrobot目前的菜單結(jié)構(gòu),每個一級菜單都有二級菜單項<br>
*
* 在某個一級菜單下沒有二級菜單的情況船惨,menu該如何定義呢柜裸?<br>
* 比如,第三個一級菜單項不是“更多體驗”粱锐,而直接是“幽默笑話”疙挺,那么menu應(yīng)該這樣定義:<br>
* menu.setButton(new Button[] { mainBtn1, mainBtn2, btn33 });
*/
Menu menu = new Menu();
menu.setButton(new Button[] { mainBtn1, mainBtn2, mainBtn3 });
return menu;
}
執(zhí)行main方法會輸出生成菜單的JSON以及響應(yīng)的狀態(tài)
生成菜單的JSON:{"button":[{"sub_button":[{"name":"微信相冊發(fā)圖","type":"pic_weixin","key":"rselfmenu_1_1"},{"name":"拍照或者相冊發(fā)圖","type":"pic_photo_or_album","key":"rselfmenu_1_2"},{"name":"系統(tǒng)拍照發(fā)圖","type":"pic_sysphoto","key":"rselfmenu_1_3"}],"name":"發(fā)圖","type":null},{"sub_button":[{"name":"掃碼帶提示","type":"scancode_waitmsg","key":"rselfmenu_2_1"},{"name":"掃碼推事件","type":"scancode_push","key":"rselfmenu_2_2"},{"name":"我的設(shè)備","type":"view","url":"https://hw.weixin.qq.com/devicectrl/panel/device-list.html?appid=wx614c453e0d1dcd12"}],"name":"掃碼","type":null},{"sub_button":[{"name":"微社區(qū)","type":"view","url":"http://whsf.tunnel.mobi/whsf/msg/wsq"},{"name":"發(fā)送位置","type":"location_select","key":"rselfmenu_3_2"},{"name":"在線咨詢","type":"view","url":"http://wpa.qq.com/msgrd?v=3&uin=572839485&site=qq&menu=yes"},{"name":"我的博客","type":"view","url":"http://www.cnblogs.com/zyw-205520"},{"name":"點擊事件","type":"click","key":"rselfmenu_3_5"}],"name":"個人中心","type":null}],"matchrule":null}
響應(yīng)的狀態(tài): {"errcode":0,"errmsg":"ok"}
以上是生成自定義菜單的全過程。
歡迎留言怜浅、轉(zhuǎn)發(fā)铐然、打賞
項目源碼參考地址 點我點我--歡迎Start