微信公眾號開發之自定義菜單

微信開發交流群:148540125

系列文章參考地址 極速開發微信公眾號

歡迎留言、轉發、打賞
項目源碼參考地址 點我點我--歡迎Start

前幾篇文章已講完如何導入項目,如何啟動配置項目,如何成為開發者,重源碼分析消息是如何交互(如果前四項不是很清楚可以看這里 極速開發微信公眾號。這篇文章就來講講如果實現自定義菜單

實現自定義菜單有兩種方式
1、編輯模式
2、開發模式

編輯模式就很簡單了就不贅述了......

開發模式實現自定義菜單

1、使用微信公眾平臺接口調試工具實現
2、使用官方提供的接口實現

前期準備

注意:
1、目前訂閱號 只能使用編輯模式而且不能添加超鏈接,微信認證之后才可以使用開發模式。
2、編輯模式與開發模式不能同時開啟
3、生成的菜單不會立即顯示(隔天),如果想立即看到效果可以取消關注再關注

添加插件

K8WTIEI86W9W5XERD`MRD{6.png

使用微信公眾平臺接口調試工具實現

自定義菜單-接口調試工具.png

可以看到需要兩個參數而且都是必填 access_token body

有人要問,這兩個參數如何獲取呢?

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 的獲取如下圖

自定義菜單-獲取access_token.png

使用官方提供的接口實現

初次了解微信自定義菜單的同學建議先看看官方的文檔3遍

Jfinal-weixin中有封裝菜單的創建、查詢、刪除、以及個性化菜單的創建、查詢、刪除、測試個性化菜單匹配結果

自定義菜單-菜單封裝的接口.png

那么問題來了,封裝好了如何使用呢?
以下是提供封裝的接口

    //查詢自定義菜單
    public static ApiResult getMenu() {
        String jsonResult = HttpUtils.get(getMenu + AccessTokenApi.getAccessTokenStr());
        return new ApiResult(jsonResult);
    }
    //創建自定義菜單
    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);
    }
    //創建個性化自定義菜單
    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);
    }
    //測試個性化菜單匹配結果
    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_guidecom.javen.weixin.menu.MenuManager類中提供了詳細使用的Demo

public static void main(String[] args) { 
         
           // 將菜單對象轉換成json字符串
           String jsonMenu = JsonKit.toJson(getTestMenu()).toString();
           System.out.println(jsonMenu);
           ApiConfig ac = new ApiConfig();
            
            // 配置微信 API 相關常量 請使用你自己公眾號的
            ac.setAppId("wx614c453e0d1dcd12");
            ac.setAppSecret("19a02e4927d346484fc70327970457f9");
//          ac.setAppId(PropKit.get("appId"));
//          ac.setAppSecret(PropKit.get("appSecret"));
            ApiConfigKit.setThreadLocalApiConfig(ac);
           
           //創建菜單
           ApiResult apiResult=MenuApi.createMenu(jsonMenu);
           System.out.println(apiResult.getJson());
     }  

可以看到main方法中調用了MenuApi.createMenu(jsonMenu)
jsonMenu 從何而來呢?

其實這里是將自定義菜單的實體對象轉化為了JSON

String jsonMenu = JsonKit.toJson(getTestMenu()).toString();

菜單的封裝

/** 
         * 組裝菜單數據 
         *  
         * @return 
         */  
        private static Menu getTestMenu() {  
            ClickButton btn11 = new ClickButton();  
            btn11.setName("微信相冊發圖");  
            btn11.setType("pic_weixin");  
            btn11.setKey("rselfmenu_1_1");
      
            ClickButton btn12 = new ClickButton();  
            btn12.setName("拍照或者相冊發圖");  
            btn12.setType("pic_photo_or_album");  
            btn12.setKey("rselfmenu_1_2");;  
      
            ClickButton btn13 = new ClickButton();  
            btn13.setName("系統拍照發圖");  
            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("我的設備");  
            btn23.setType("view");  
            btn23.setUrl("https://hw.weixin.qq.com/devicectrl/panel/device-list.html?appid=wx614c453e0d1dcd12"); 
            
            ViewButton btn31 = new ViewButton();  
            btn31.setName("微社區");  
            btn31.setType("view");  
            btn31.setUrl("http://whsf.tunnel.mobi/whsf/msg/wsq");  
      
            
            ClickButton btn32 = new ClickButton();  
            btn32.setName("發送位置");  
            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("發圖");  
            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目前的菜單結構,每個一級菜單都有二級菜單項<br> 
             *  
             * 在某個一級菜單下沒有二級菜單的情況,menu該如何定義呢?<br> 
             * 比如,第三個一級菜單項不是“更多體驗”,而直接是“幽默笑話”,那么menu應該這樣定義:<br> 
             * menu.setButton(new Button[] { mainBtn1, mainBtn2, btn33 }); 
             */  
            Menu menu = new Menu();  
            menu.setButton(new Button[] { mainBtn1, mainBtn2, mainBtn3 });  
            return menu;  
        }

執行main方法會輸出生成菜單的JSON以及響應的狀態

生成菜單的JSON:{"button":[{"sub_button":[{"name":"微信相冊發圖","type":"pic_weixin","key":"rselfmenu_1_1"},{"name":"拍照或者相冊發圖","type":"pic_photo_or_album","key":"rselfmenu_1_2"},{"name":"系統拍照發圖","type":"pic_sysphoto","key":"rselfmenu_1_3"}],"name":"發圖","type":null},{"sub_button":[{"name":"掃碼帶提示","type":"scancode_waitmsg","key":"rselfmenu_2_1"},{"name":"掃碼推事件","type":"scancode_push","key":"rselfmenu_2_2"},{"name":"我的設備","type":"view","url":"https://hw.weixin.qq.com/devicectrl/panel/device-list.html?appid=wx614c453e0d1dcd12"}],"name":"掃碼","type":null},{"sub_button":[{"name":"微社區","type":"view","url":"http://whsf.tunnel.mobi/whsf/msg/wsq"},{"name":"發送位置","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}

響應的狀態: {"errcode":0,"errmsg":"ok"}

以上是生成自定義菜單的全過程。

歡迎留言、轉發、打賞
項目源碼參考地址 點我點我--歡迎Start

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 227,882評論 6 531
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,208評論 3 414
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 175,746評論 0 373
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 62,666評論 1 309
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,477評論 6 407
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 54,960評論 1 321
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,047評論 3 440
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,200評論 0 288
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,726評論 1 333
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,617評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,807評論 1 369
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,327評論 5 358
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,049評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,425評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,674評論 1 281
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,432評論 3 390
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,769評論 2 372

推薦閱讀更多精彩內容