微信二次开发——基础篇

这篇文章是接着上一篇微信二次开发——准备篇，在前面的代码基础上讨论下微信公众号开发能做得到的事情。这里我只会讨论其中的一部分而已，如果想要了解更详细的内容，可以查阅微信公众号开发者文档。

本文所有的微信接口调用都是基于github 上的一个微信公众平台php开发包（SDK），这样子做的目的可以是我们忽略微信公众号 API 的对接细节，更加专注于我们的业务的处理，能够高效地完成我们的项目。

在这篇文章里，我打算讲两部分的内容，一个是自定义菜单，一个是处理微信用户发送给公众号的消息（包括普通的消息和事件推送）。

自定义菜单

公众号自定义菜单的规则：

1、自定义菜单最多包括3个一级菜单，每个一级菜单最多包含5个二级菜单。
2、一级菜单最多4个汉字，二级菜单最多7个汉字，多出来的部分将会以“...”代替。
3、创建自定义菜单后，菜单的刷新策略是，在用户进入公众号会话页或公众号profile页时，如果发现上一次拉取菜单的请求在5分钟以前，就会拉取一下菜单，如果菜单有更新，就会刷新客户端的菜单。测试时可以尝试取消关注公众账号后再次关注，则可以看到创建后的效果。

自定义菜单接口可实现多种类型按钮，如下：

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。

使用 SDK 只需要以下代码即可定义公众号的菜单：

	//自定义菜单函数，根据 SDK 定义，只需要配置一个菜单数组即可
	public function create_menu(){
		$data	= array(
			'button' => array (
				0 => array (
					'name' => '扫码',
					'sub_button' => array (
						0 => array (
							'type' => 'scancode_waitmsg',
							'name' => '扫码带提示',
							'key' => 'rselfmenu_0_0',
						),
						1 => array (
							'type' => 'scancode_push',
							'name' => '扫码推事件',
							'key' => 'rselfmenu_0_1',
						),
					),
				),
				1 => array (
					'name' => '发图',
					'sub_button' => array (
						0 => array (
							'type' => 'pic_sysphoto',
							'name' => '系统拍照发图',
							'key' => 'rselfmenu_1_0',
						),
						1 => array (
							'type' => 'pic_photo_or_album',
							'name' => '拍照或者相册发图',
							'key' => 'rselfmenu_1_1',
						)
					),
				),
				2 => array (
					'type' => 'location_select',
					'name' => '发送我的位置',
					'key' => 'rselfmenu_2_0'
				),
			),
		);
		$res	= $this->weObj->createMenu($data);

		if($res){
			echo '创建菜单成功';
		}else{
			echo '创建菜单失败';
		}
	}

响应微信用户的消息

来自微信用户的消息有两种类型，一种是普通消息，是用户主动的有意识地发送给公众号的，这类的消息有：

1 文本消息
2 图片消息
3 语音消息
4 视频消息
5 小视频消息
6 地理位置消息
7 链接消息

另一种是事件推送消息，这类消息不是微信用户主动发送的，而是微信用户触发了某个特定的事件之后，由微信程序以时间推送的方式推送给开发者服务器的消息，这类消息有：

1 关注/取消关注事件
2 扫描带参数二维码事件
3 上报地理位置事件
4 自定义菜单事件
5 点击菜单拉取消息时的事件推送
6 点击菜单跳转链接时的事件推送

有了这些认识之后，我们就可以在我们的程序中对用户的这些消息对应地进行响应了。

很庆幸，SDK 已经对这些消息接收的繁琐细节作出了很好的处理，并且我们也可以使用 SDK 方便地对这些消息做出响应。在接收到微信服务器发送过来的消息时，首先根据 type 来判断是什么类型的消息，如果 type 为事件，则再判断是什么类型的事件，然后根据判断的结果来进行相应的响应处理即可。

以下是部分代码示例：

	//微信推送的消息首先会到达这个函数
	//根据消息类型调用对应的处理函数
	public function message(){
		$this->weobj->valid();
		$data	= $this->weobj->getrev()->getrevdata();

		$type	= $data['msgtype'];

		switch($type) {
		case \tpwechat::msgtype_event:
			$this->event($data);
			break;
		case \tpwechat::msgtype_text:
			//回复文本消息
			$this->text($data);
			break;
		case \tpwechat::msgtype_image:
			$this->image($data);
			break;
		default:
			$this->default_reply($data);
		}
	}

	//处理图片消息
	protected function image($data){
		$this->default_reply($data);
	}

	//处理事件消息
	protected function event($data){
		$event	= $data['event'];

		switch($event){
			// 回复关注事件
		case \tpwechat::event_subscribe:
			$this->event_subscribe($data);
			break;

		default:
			$this->default_reply($data);
		}
	}

	//处理关注事件消息
	protected function event_subscribe($data){
		$news	=  array(
			"0"=>array(
				'title'=>'成为会员通知',
				'description'=>date('m')." 月 ".date('d')." 日\n恭喜您成为我们尊贵的会员。",
				'picurl'=>'',
				'url'=>'http://'.$_server['server_name'].u('index/index'),
			),
		);

		$this->weobj->news($news)->reply();
	}

	//处理文本消息
	protected function text($data){
		$this->weobj->text("你说：".$data['content'])->reply();
	}

	//处理默认回复
	protected function default_reply($data){
		$this->weobj->text("unhandle action\n".var_export($data,true))->reply();
	}

本文要讲的就这么多了，相应的代码可以到 github 获得。更多的微信二次开发接口信息可以到微信公众平台开发者文档了解。

END