微信测试号底部菜单栏的创建以及按钮链接跳转的实现

待我称王封你为后i 2021-09-16 00:40 111阅读 0赞

首先，得先申请一个测试号，我之前已经在另外一篇博客写过，这里就不累赘，不懂申请的可以点击下面博客链接，看第二部分：

[https://blog.csdn.net/weidong\_y/article/details/81141868][https_blog.csdn.net_weidong_y_article_details_81141868]

自定义菜单的按钮类型介绍：

1、click：点击推事件用户点击click类型按钮后，微信服务器会通过消息接口推送消息类型为event的结构给开发者（参考消息接口指南），并且带上按钮中开发者填写的key值，开发者可以通过自定义的key值与用户进行交互；
    2、view：跳转URL用户点击view类型按钮后，微信客户端将会打开开发者在按钮中填写的网页URL，可与网页授权获取用户基本信息接口结合，获得用户基本信息。
    3、scancode_push：扫码推事件用户点击按钮后，微信客户端将调起扫一扫工具，完成扫码操作后显示扫描结果（如果是URL，将进入URL），且会将扫码的结果传给开发者，开发者可以下发消息。
    4、scancode_waitmsg：扫码推事件且弹出“消息接收中”提示框用户点击按钮后，微信客户端将调起扫一扫工具，完成扫码操作后，将扫码的结果传给开发者，同时收起扫一扫工具，然后弹出“消息接收中”提示框，随后可能会收到开发者下发的消息。
    5、pic_sysphoto：弹出系统拍照发图用户点击按钮后，微信客户端将调起系统相机，完成拍照操作后，会将拍摄的相片发送给开发者，并推送事件给开发者，同时收起系统相机，随后可能会收到开发者下发的消息。
    6、pic_photo_or_album：弹出拍照或者相册发图用户点击按钮后，微信客户端将弹出选择器供用户选择“拍照”或者“从手机相册选择”。用户选择后即走其他两种流程。
    7、pic_weixin：弹出微信相册发图器用户点击按钮后，微信客户端将调起微信相册，完成选择操作后，将选择的相片发送给开发者的服务器，并推送事件给开发者，同时收起相册，随后可能会收到开发者下发的消息。
    8、location_select：弹出地理位置选择器用户点击按钮后，微信客户端将调起地理位置选择工具，完成选择操作后，将选择的地理位置发送给开发者的服务器，同时收起位置选择工具，随后可能会收到开发者下发的消息。
    9、media_id：下发消息（除文本消息）用户点击media_id类型按钮后，微信服务器会将开发者填写的永久素材id对应的素材下发给用户，永久素材类型可以是图片、音频、视频、图文消息。请注意：永久素材id必须是在“素材管理/新增永久素材”接口上传后获得的合法id。
    10、view_limited：跳转图文消息URL用户点击view_limited类型按钮后，微信客户端将打开开发者在按钮中填写的永久素材id对应的图文消息URL，永久素材类型只支持图文消息。请注意：永久素材id必须是在“素材管理/新增永久素材”接口上传后获得的合法id。

参数说明：

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>是否必须</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>button</td> 
   <td>是</td> 
   <td>一级菜单数组，个数应为1~3个</td> 
  </tr> 
  <tr> 
   <td>sub_button</td> 
   <td>否</td> 
   <td>二级菜单数组，个数应为1~5个</td> 
  </tr> 
  <tr> 
   <td>type</td> 
   <td>是</td> 
   <td>菜单的响应动作类型，view表示网页类型，click表示点击类型，miniprogram表示小程序类型</td> 
  </tr> 
  <tr> 
   <td>name</td> 
   <td>是</td> 
   <td>菜单标题，不超过16个字节，子菜单不超过60个字节</td> 
  </tr> 
  <tr> 
   <td>key</td> 
   <td>click等点击类型必须</td> 
   <td>菜单KEY值，用于消息接口推送，不超过128字节</td> 
  </tr> 
  <tr> 
   <td>url</td> 
   <td>view、miniprogram类型必须</td> 
   <td>网页 链接，用户点击菜单可打开链接，不超过1024字节。 type为miniprogram时，不支持小程序的老版本客户端将打开本url。</td> 
  </tr> 
  <tr> 
   <td>media_id</td> 
   <td>media_id类型和view_limited类型必须</td> 
   <td>调用新增永久素材接口返回的合法media_id</td> 
  </tr> 
  <tr> 
   <td>appid</td> 
   <td>miniprogram类型必须</td> 
   <td>小程序的appid（仅认证公众号可配置）</td> 
  </tr> 
  <tr> 
   <td>pagepath</td> 
   <td>miniprogram类型必须</td> 
   <td>小程序的页面路径</td> 
  </tr> 
 </tbody> 
</table>

1.创建菜单实体类：

由于底部菜单栏可以有多个一级按钮，因此用菜单数组来存放。

public class Menu {
    	private Button[] button;
    
    	public Button[] getButton() {
    		return button;
    	}
    
    	public void setButton(Button[] button) {
    		this.button = button;
    	}
    
    }

2.创建按钮实体公共类

不同的按钮都会有名字和类型，所以把公共的部分给抽取出来，后面的其他类，直接继承就行了。

public class Button {
    	private String name;
    	private String type;
    
    	public String getName() {
    		return name;
    	}
    
    	public void setName(String name) {
    		this.name = name;
    	}
    
    	public String getType() {
    		return type;
    	}
    
    	public void setType(String type) {
    		this.type = type;
    	}
    
    }

3.创建 View 按钮的实体类

public class ViewButton extends Button{
    	private String url;
    
    	public String getUrl() {
    		return url;
    	}
    
    	public void setUrl(String url) {
    		this.url = url;
    	}
    	
    }

4.创建一个工具类

import java.io.IOException;
    import java.nio.charset.UnsupportedCharsetException;
    
    import org.apache.http.HttpResponse;
    import org.apache.http.client.ClientProtocolException;
    import org.apache.http.client.methods.HttpPost;
    import org.apache.http.entity.StringEntity;
    import org.apache.http.impl.client.DefaultHttpClient;
    import org.apache.http.util.EntityUtils;
    
    import com.dto.Button;
    import com.dto.Menu;
    import com.dto.ViewButton;
    
    import net.sf.json.JSONObject;
    
    public class MenuUtil {
    	private static final String APPID = "替换成自己的APPID";
    	private static final String APPSECRET = "替换成自己的APPSECRET";
    	private static final String CREATE_MENU_URL = "https://api.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN";
    
    	/**
    	 * 组装菜单
    	 * 
    	 * @return
    	 */
    	public static Menu initMenu() {
    		
    		Menu menu = new Menu();
    
    		ViewButton viewbutton1 = new ViewButton();
    		viewbutton1.setName("用户系统");
    		viewbutton1.setType("view");
    		viewbutton1.setUrl("http://www.imooc.com");
    		ViewButton viewbutton2 = new ViewButton();
    		viewbutton2.setName("商家系统");
    		viewbutton2.setType("view");
    		viewbutton2.setUrl("http://www.baidu.com");
    
    		menu.setButton(new Button[] { viewbutton1, viewbutton2 });
    
    		return menu;
    	}
    
    	public static int createMenu(String token, String menu) throws ClientProtocolException, IOException {
    		int result = 0;
    		String url = CREATE_MENU_URL.replace("ACCESS_TOKEN", token);
    		JSONObject jsonObject = doPostStr(url, menu);
    		if (jsonObject != null) {
    			result = jsonObject.getInt("errcode");
    		}
    		return result;
    	}
    
    	@SuppressWarnings("deprecation")
    	private static JSONObject doPostStr(String url, String outStr) throws ClientProtocolException, IOException{
    		DefaultHttpClient httpClient = new DefaultHttpClient();
    		HttpPost httpPost = new HttpPost(url);
    		JSONObject jsonObject = null;
    		try {
    			httpPost.setEntity(new StringEntity(outStr, "UTF-8"));
    			HttpResponse response = httpClient.execute(httpPost);
    			String result = EntityUtils.toString(response.getEntity(),"UTF-8");
    			jsonObject = JSONObject.fromObject(result);
    		} catch (UnsupportedCharsetException e) {
    			e.printStackTrace();
    		}
    		return jsonObject;
    	}
    }

5.通过微信公众平台接口调试工具获取token

[微信官方测试接口][Link 1]

![70][]

![70 1][]

6.写一个main函数来实现测试号上的按钮

public static void main(String[] args) {
    	String menu = JSONObject.fromObject(MenuUtil.initMenu()).toString();
    	int result = MenuUtil.createMenu("关于token的获取", menu);
    	System.out.println(result);
    }

7.运行 main 函数

如果控制上显示了“0”，就表示菜单栏上的按钮创建成功了，可以直接到测试号查看，如果有些测试号没反应，建议先取消关注，再重新关注看下。

[https_blog.csdn.net_weidong_y_article_details_81141868]: https://blog.csdn.net/weidong_y/article/details/81141868
[Link 1]: https://mp.weixin.qq.com/debug/cgi-bin/apiinfo?t=index&type=%E8%87%AA%E5%AE%9A%E4%B9%89%E8%8F%9C%E5%8D%95&form=%E8%87%AA%E5%AE%9A%E4%B9%89%E8%8F%9C%E5%8D%95%E5%88%9B%E5%BB%BA%E6%8E%A5%E5%8F%A3%20/menu/creat
[70]: /images/20210626/d9384fab3cc746729444193666dbc1ee.png
[70 1]: /images/20210626/126fa887c77a44a7b6207a7419fab40b.png