微信公众平台开发(104) 自定义菜单扫一扫、发图片、发地理位置

关键字：微信公众平台 自定义菜单 扫一扫 发图片 发地理位置
作者：方倍工作室
原文：http://www.cnblogs.com/txw1958/p/weixin-menu-new-type.html

自定义菜单能够帮助公众号丰富界面，让用户更好更快地理解公众号的重要功能。微信增加了点击菜单后调起扫一扫（支持二维码/一维码）、发图片、发地理位置的能力，需开发实现。原有自定义菜单开发权限的公众号，均可获得以上能力。

在这篇微信公众平台开发教程中，我们将介绍如何在自定义菜单上开发扫一扫、发图片、发地理位置等功能。原有点击和跳转事件的开发，请参考微信公众平台开发（58）自定义菜单。

本文分为以下二个部分：

  1. 扫一扫、发图片、发地理位置介绍
  2. 生成扫一扫、发图片、发地理位置功能菜单
  3. 开发扫一扫、发图片、发地理位置响应程序
  4. 使用场景

一、菜单介绍

1. 扫码推送事件 scancode_push
用户点击按钮后，微信客户端将调起扫一扫工具，完成扫码操作后显示扫描结果（如果是URL，将进入URL），且会将扫码的结果传给开发者，开发者可以下发消息。

2. 扫码推送事件，且弹出“消息接收中”提示框 scancode_waitmsg
用户点击按钮后，微信客户端将调起扫一扫工具，完成扫码操作后，将扫码的结果传给开发者，同时收起扫一扫工具，然后弹出“消息接收中”提示框，随后可能会收到开发者下发的消息。

3. 弹出系统拍照发图 pic_sysphoto
用户点击按钮后，微信客户端将调起系统相机，完成拍照操作后，将拍摄的相片发送给开发者，并推送事件给开发者，同时收起系统相机，随后可能会收到开发者下发的消息。

4. 弹出拍照或者相册发图 pic_photo_or_album
用户点击按钮后，微信客户端将弹出选择器供用户选择“拍照”或者“从手机相册选择”。用户选择后即走其他两种流程。

5. 弹出微信相册发图器 pic_weixin
用户点击按钮后，微信客户端将调起微信相册，完成选择操作后，将选择的相片发送给开发者的服务器，并推送事件给开发者，同时收起相册，随后可能会收到开发者下发的消息。

6. 弹出地理位置选择器 location_select
用户点击按钮后，微信客户端将调起地理位置选择工具，完成选择操作后，将选择的地理位置发送给开发者的服务器，同时收起位置选择工具，随后可能会收到开发者下发的消息。

以上新增能力，均仅支持微信iPhone5.4.1以上版本，和Android5.4以上版本的微信用户，旧版本微信用户点击后将没有回应，开发者也不能正常接收到事件推送。

接口调用请求说明

http请求方式：POST（请使用https协议）

https://api.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN

 按钮请求示例如下

{
    "button": [
        {
            "name": "扫码",
            "sub_button": [
                {
                    "type": "scancode_waitmsg",
                    "name": "扫码带提示",
                    "key": "rselfmenu_0_0",
                    "sub_button": [ ]
                },
                {
                    "type": "scancode_push",
                    "name": "扫码推事件",
                    "key": "rselfmenu_0_1",
                    "sub_button": [ ]
                }
            ]
        },
        {
            "name": "发图",
            "sub_button": [
                {
                    "type": "pic_sysphoto",
                    "name": "系统拍照发图",
                    "key": "rselfmenu_1_0",
                   "sub_button": [ ]
                 },
                {
                    "type": "pic_photo_or_album",
                    "name": "拍照或者相册发图",
                    "key": "rselfmenu_1_1",
                    "sub_button": [ ]
                },
                {
                    "type": "pic_weixin",
                    "name": "微信相册发图",
                    "key": "rselfmenu_1_2",
                    "sub_button": [ ]
                }
            ]
        },
        {
            "name": "发送位置",
            "type": "location_select",
            "key": "rselfmenu_2_0"
        }
    ]
}

参数说明

参数 是否必须 说明
button 是 一级菜单数组，个数应为1~3个
sub_button 否 二级菜单数组，个数应为1~5个
type 是 菜单的响应动作类型
name 是 菜单标题，不超过16个字节，子菜单不超过40个字节
key click等点击类型必须 菜单KEY值，用于消息接口推送，不超过128字节
url view类型必须 网页链接，用户点击菜单可打开链接，不超过256字节

二、生成菜单

菜单具体的生成方法，与之前是一样的，先生成access token，再将菜单post内容提交给微信服务器，具体代码及方法可以参考 微信公众平台开发（58）自定义菜单。

生成后的效果如下如示：

 

三、响应菜单点击

响应菜单点击，则需要在接口文件中添加新的EventKey事件的响应，并回复相应的内容。

相关代码如下

 1     //接收事件消息
 2     private function receiveEvent($object)
 3     {
 4         $content = "";
 5         switch ($object->Event)
 6         {
 7             case "subscribe":
 8                 $content = "欢迎关注方倍工作室 ";
 9                 $content .= (!empty($object->EventKey))?("\n来自二维码场景 ".str_replace("qrscene_","",$object->EventKey)):"";
10                 break;
11             case "unsubscribe":
12                 $content = "取消关注";
13                 break;
14             case "CLICK":
15                 switch ($object->EventKey)
16                 {
17                     case "COMPANY":
18                         $content = array();
19                         $content[] = array("Title"=>"方倍工作室", "Description"=>"", "PicUrl"=>"http://discuz.comli.com/weixin/weather/icon/cartoon.jpg", "Url" =>"http://m.cnblogs.com/?u=txw1958");
20                         break;
21                     default:
22                         $content = "点击菜单：".$object->EventKey;
23                         break;
24                 }
25                 break;
26             case "VIEW":
27                 $content = "跳转链接 ".$object->EventKey;
28                 break;
29             case "SCAN":
30                 $content = "扫描场景 ".$object->EventKey;
31                 break;
32             case "LOCATION":
33                 $content = "上传位置：纬度 ".$object->Latitude.";经度 ".$object->Longitude;
34                 break;
35             case "scancode_waitmsg":
36                 $content = "扫码带提示：类型 ".$object->ScanCodeInfo->ScanType." 结果：".$object->ScanCodeInfo->ScanResult;
37                 break;
38             case "scancode_push":
39                 $content = "扫码推事件";
40                 break;
41             case "pic_sysphoto":
42                 $content = "系统拍照";
43                 break;
44             case "pic_weixin":
45                 $content = "相册发图：数量 ".$object->SendPicsInfo->Count;
46                 break;
47             case "pic_photo_or_album":
48                 $content = "拍照或者相册：数量 ".$object->SendPicsInfo->Count;
49                 break;
50             case "location_select":
51                 $content = "发送位置：标签 ".$object->SendLocationInfo->Label;
52                 break;
53             default:
54                 $content = "receive a new event: ".$object->Event." \n技术支持 方倍工作室";
55                 break;
56         }
57
58         if(is_array($content)){
59             if (isset($content[0][‘PicUrl‘])){
60                 $result = $this->transmitNews($object, $content);
61             }else if (isset($content[‘MusicUrl‘])){
62                 $result = $this->transmitMusic($object, $content);
63             }
64         }else{
65             $result = $this->transmitText($object, $content);
66         }
67         return $result;
68     }

各项类型推送给后台的xml详解如下

scancode_waitmsg，回应该事件给用户，用户可收到消息

<xml>
    <ToUserName><![CDATA[gh_82479813ed64]]></ToUserName>
    <FromUserName><![CDATA[ojpX_jig-gyi3_Q9fHXQ4rdHniQs]]></FromUserName>
    <CreateTime>1412075435</CreateTime>
    <MsgType><![CDATA[event]]></MsgType>
    <Event><![CDATA[scancode_waitmsg]]></Event>
    <EventKey><![CDATA[rselfmenu_0_0]]></EventKey>
    <ScanCodeInfo>
        <ScanType><![CDATA[qrcode]]></ScanType>
        <ScanResult><![CDATA[http://weixin.qq.com/r/pUNnf4HEX9wgrcUc9xa3]]></ScanResult>
        <EventKey><![CDATA[rselfmenu_0_0]]></EventKey>
    </ScanCodeInfo>
</xml>

scancode_push，回应该事件给用户，用户不能收到消息

<xml>
    <ToUserName><![CDATA[gh_82479813ed64]]></ToUserName>
    <FromUserName><![CDATA[ojpX_jig-gyi3_Q9fHXQ4rdHniQs]]></FromUserName>
    <CreateTime>1412075451</CreateTime>
    <MsgType><![CDATA[event]]></MsgType>
    <Event><![CDATA[scancode_push]]></Event>
    <EventKey><![CDATA[rselfmenu_0_1]]></EventKey>
    <ScanCodeInfo>
        <ScanType><![CDATA[qrcode]]></ScanType>
        <ScanResult><![CDATA[http://weixin.qq.com/r/pUNnf4HEX9wgrcUc9xa3]]></ScanResult>
        <EventKey><![CDATA[rselfmenu_0_1]]></EventKey>
    </ScanCodeInfo>
</xml>

pic_weixin ,下面是一次推送3张相片时的数据

<xml>
    <ToUserName><![CDATA[gh_82479813ed64]]></ToUserName>
    <FromUserName><![CDATA[ojpX_jig-gyi3_Q9fHXQ4rdHniQs]]></FromUserName>
    <CreateTime>1412075552</CreateTime>
    <MsgType><![CDATA[event]]></MsgType>
    <Event><![CDATA[pic_weixin]]></Event>
    <EventKey><![CDATA[rselfmenu_1_2]]></EventKey>
    <SendPicsInfo>
        <Count>3</Count>
        <PicList>
            <item>
                <PicMd5Sum><![CDATA[a6ab74b73a298f49f6fc66f41f88d3c7]]></PicMd5Sum>
            </item>
            <item>
                <PicMd5Sum><![CDATA[5b9aea2b3683c5c21aaf3629739cafd9]]></PicMd5Sum>
            </item>
            <item>
                <PicMd5Sum><![CDATA[2325ff3f39705ac987d3e0660906791d]]></PicMd5Sum>
            </item>
        </PicList>
        <EventKey><![CDATA[rselfmenu_1_2]]></EventKey>
    </SendPicsInfo>
</xml>

回应上述消息，用户收不到，但微信会继续推送3个图片消息给接口

<xml>
    <ToUserName><![CDATA[gh_82479813ed64]]></ToUserName>
    <FromUserName><![CDATA[ojpX_jig-gyi3_Q9fHXQ4rdHniQs]]></FromUserName>
    <CreateTime>1412075562</CreateTime>
    <MsgType><![CDATA[image]]></MsgType>
    <PicUrl><![CDATA[http://mmbiz.qpic.cn/mmbiz/qOTIrRtMKFxZQo3cQ6vYxmfteo0fw2Y00MuuFS6OjlNvTkx0nBQJibjjafQMf4dCtJwyMeP5e3SQCuJpcoJdb8Q/0]]></PicUrl>
    <MsgId>6064818358471506877</MsgId>
    <MediaId><![CDATA[AM8Gbiu7S2vTIMS2l9zNCWiMCpeM8wccmKdFxmstHiuAybCbB-08dTQJN40cCIBD]]></MediaId>
</xml>
<xml>
    <ToUserName><![CDATA[gh_82479813ed64]]></ToUserName>
    <FromUserName><![CDATA[ojpX_jig-gyi3_Q9fHXQ4rdHniQs]]></FromUserName>
    <CreateTime>1412075564</CreateTime>
    <MsgType><![CDATA[image]]></MsgType>
    <PicUrl><![CDATA[http://mmbiz.qpic.cn/mmbiz/qOTIrRtMKFxZQo3cQ6vYxmfteo0fw2Y0ellMniarWto4zL0pWKhr6a0FSARDeXprSgd0JmgU0YQo2iagGsYc1iaLA/0]]></PicUrl>
    <MsgId>6064818367061441471</MsgId>
    <MediaId><![CDATA[2CJKZ2mft-5hWEkVcVmnKwyvp3y59Uzv7YdpBsnGIyTlkMNb0ytU4oimTgimBGyP]]></MediaId>
</xml>
<xml>
    <ToUserName><![CDATA[gh_82479813ed64]]></ToUserName>
    <FromUserName><![CDATA[ojpX_jig-gyi3_Q9fHXQ4rdHniQs]]></FromUserName>
    <CreateTime>1412075567</CreateTime>
    <MsgType><![CDATA[image]]></MsgType>
    <PicUrl><![CDATA[http://mmbiz.qpic.cn/mmbiz/qOTIrRtMKFxZQo3cQ6vYxmfteo0fw2Y0mwQoENttnmYAz0VTicY3xkO0lhn9mE5r3FB4cF04kia50riajcjY1qvzA/0]]></PicUrl>
    <MsgId>6064818379946343361</MsgId>
    <MediaId><![CDATA[VICm1-y8w_MmdpcLYWP0u12HVXrWdhm3c3tdq1PTsbiFFgH6YOcmmIEbZ27z-Qcl]]></MediaId>
</xml>

上述多个图片消息，后台收到都能进行单独回应，用户可以收到响应消息。

pic_photo_or_album，方式和pic_weixin 一样，先推送菜单事件，再推送图片消息

<xml>
    <ToUserName><![CDATA[gh_82479813ed64]]></ToUserName>
    <FromUserName><![CDATA[ojpX_jig-gyi3_Q9fHXQ4rdHniQs]]></FromUserName>
    <CreateTime>1412075614</CreateTime>
    <MsgType><![CDATA[event]]></MsgType>
    <Event><![CDATA[pic_photo_or_album]]></Event>
    <EventKey><![CDATA[rselfmenu_1_1]]></EventKey>
    <SendPicsInfo>
        <Count>1</Count>
        <PicList>
            <item>
                <PicMd5Sum><![CDATA[58f4989164b2a432889e64fa81632152]]></PicMd5Sum>
            </item>
        </PicList>
        <EventKey><![CDATA[rselfmenu_1_1]]></EventKey>
    </SendPicsInfo>
</xml>
<xml>
    <ToUserName><![CDATA[gh_82479813ed64]]></ToUserName>
    <FromUserName><![CDATA[ojpX_jig-gyi3_Q9fHXQ4rdHniQs]]></FromUserName>
    <CreateTime>1412075618</CreateTime>
    <MsgType><![CDATA[image]]></MsgType>
    <PicUrl><![CDATA[http://mmbiz.qpic.cn/mmbiz/qOTIrRtMKFxZQo3cQ6vYxmfteo0fw2Y0fwSdF54rribCj9zqDG0wVDsiasKuUC8gskbuZmX43a1hs9esySIvmrqA/0]]></PicUrl>
    <MsgId>6064818598989675467</MsgId>
    <MediaId><![CDATA[Jh7Bsjaodmz-Dc_Hdz_wRzY3RiFxNvA4JHpUWRNRCIgps19ANsDFIOYOUV1dIVYV]]></MediaId>
</xml>

pic_sysphoto 这个后台其实收不到该菜单的消息，点击它后，调用的是手机里面的照相机功能，而照相以后再发过来时，就收到的是一个图片消息了

<xml>
    <ToUserName><![CDATA[gh_82479813ed64]]></ToUserName>
    <FromUserName><![CDATA[ojpX_jig-gyi3_Q9fHXQ4rdHniQs]]></FromUserName>
    <CreateTime>1412135923</CreateTime>
    <MsgType><![CDATA[image]]></MsgType>
    <PicUrl><![CDATA[http://mmbiz.qpic.cn/mmbiz/qOTIrRtMKFxGzYCchrNiczZ9aCd1fgCEWbicHGvmaz1d7VZOSMqoLB4RL69rK2Fos6fSM4FJRkLtiajpe32ibkicw1A/0]]></PicUrl>
    <MsgId>6065077606992462276</MsgId>
    <MediaId><![CDATA[PqRRUPLhMc27EG5F4cCtTozBsin7SY8kPRRuAF-CwPl5MzR5ewE5oji0FhGTDl6_]]></MediaId>
</xml>

location_select 将会调起发送位置功能，菜单的响应用户收不到，在用户发送位置之后，会再推送一个地理位置消息功能给用户

<xml>
    <ToUserName><![CDATA[gh_82479813ed64]]></ToUserName>
    <FromUserName><![CDATA[ojpX_jig-gyi3_Q9fHXQ4rdHniQs]]></FromUserName>
    <CreateTime>1412075681</CreateTime>
    <MsgType><![CDATA[event]]></MsgType>
    <Event><![CDATA[location_select]]></Event>
    <EventKey><![CDATA[rselfmenu_2_0]]></EventKey>
    <SendLocationInfo>
        <Location_X><![CDATA[22.538145]]></Location_X>
        <Location_Y><![CDATA[113.952298]]></Location_Y>
        <Scale><![CDATA[13]]></Scale>
        <Label><![CDATA[深圳市南山区高新南一道9号]]></Label>
        <Poiname><![CDATA[]]></Poiname>
        <EventKey><![CDATA[rselfmenu_2_0]]></EventKey>
    </SendLocationInfo>
</xml>
<xml>
    <ToUserName><![CDATA[gh_82479813ed64]]></ToUserName>
    <FromUserName><![CDATA[ojpX_jig-gyi3_Q9fHXQ4rdHniQs]]></FromUserName>
    <CreateTime>1412075681</CreateTime>
    <MsgType><![CDATA[location]]></MsgType>
    <Location_X>22.538145</Location_X>
    <Location_Y>113.952298</Location_Y>
    <Scale>13</Scale>
    <Label><![CDATA[深圳市南山区高新南一道9号飞亚达科技大厦方倍工作室]]></Label>
    <MsgId>6064818869572615123</MsgId>
</xml>

四、使用场景

4.1 产品二维码检测真伪

使用scancode_waitmsg事件，可以获得扫描结果，再与现有结果进行比对，从而可以达到检测二维码真实性的功能。

一个检测代码如下所示：

1 case "scancode_waitmsg":
2     if ($object->ScanCodeInfo->ScanResult == "http://mm.wanggou.com/item/jd2.shtml?sku=11447844"){
3         $content = array();
4         $content[] = array("Title"=>"该产品检测结果为正品", "Description"=>"书名：微信公众平台开发最佳实践\n定价：￥69.00\n作者：方倍工作室\n\n点击“查看全文”，使用微信支付在线购买", "PicUrl"=>"http://images.cnitblog.com/i/340216/201404/301756448922305.jpg", "Url" =>"http://mm.wanggou.com/item/jd2.shtml?sku=11447844");
5     }else{
6         $content = "扫码带提示：类型 ".$object->ScanCodeInfo->ScanType." 结果：".$object->ScanCodeInfo->ScanResult;
7     }
8     break;

当用户使用scancode_waitmsg菜单扫描以下二维码时，将出现检测结果，结果为真时，还可以再进一步，让用户进入购买

4.2 快递进度查询

基于上面同样的原理，可以实现扫描快递条形码，就查询快递进度的功能。

一个快递的单号如下

扫描以后，返回结果为

扫码带提示：类型 qrcode/CODE_39 结果：762480955342

正确识别了其中的快递单号

4.3 导航/附近/地图

location_select事件比之前的直接发送地理位置消息更少了一步，比如下面的

时间： 2024-10-18 18:04:01

微信公众平台开发(104) 自定义菜单扫一扫、发图片、发地理位置的相关文章

微信公众平台开发(99) 自定义菜单获取OpenID

关键字 微信公众平台 自定义菜单 OpenID作者:方倍工作室原文:http://www.cnblogs.com/txw1958/p/weixin-menu-get-openid.html 在这篇微信公众平台开发教程中,我们将介绍如何在自定义菜单中获得用户的OpenID. 本篇开发教程的实质是微信自定义菜单及OAuth2.0授权的灵活运用. 本文分为以下四个部分: 拥有高级接口权限时的获取(基于view事件) 没有高级接口权限时的获取(基于click事件) 一.拥有高级接口权限 拥有高级接口权限

微信公众平台开发教程---自定义菜单

转载自:http://www.cnblogs.com/yank/p/3418194.html 一.概述: 如果只有输入框,可能太简单,感觉像命令行.自定义菜单,给我们提供了很大的灵活性,更符合用户的操作习惯.在一个小小的微信对话页面,可以实现更多的功能.菜单直观明了,不仅能提供事件响应,还支持URL跳转,如果需要的功能比较复杂,我们大可以使用URL跳转,跳转至我们的网页即可. 注意:自定义菜单,只有服务号才有此功能 如何注册,见第一章:微信公众账号开发教程(一) 基本原理及微信公众账号注册 效果

微信公众平台开发之自定义菜单的创建和删除

写在前: 在做这一块时,先看一下 公众平台开发文档(点击进入): 在创建菜单时,都是基于JSON传输数据,所以要用到JSON,下载相关包 点击下载: 公众平台开发文档上有说明: 请注意: 1.自定义菜单最多包括3个一级菜单,每个一级菜单最多包含5个二级菜单.2.一级菜单最多4个汉字,二级菜单最多7个汉字,多出来的部分将会以"..."代替.3.创建自定义菜单后,由于微信客户端缓存,需要24小时微信客户端才会展现出来.测试时可以尝试取消关注公众账号后再次关注,则可以看到创建后的效果. 自定

微信公众平台开发模式 自定义菜单 指南与菜单新建错误代码分析

简介 开发者获取使用凭证(如何获取凭证)后,可以使用该凭证对公众账号的自定义菜单进行创建.查询和删除等操作. 自定义菜单接口可实现以下类型按钮: click(点击事件): 用户点击click类型按钮后,微信服务器会通过消息接口(event类型)推送点击事件给开发者,并且带上按钮中开发者填写的key值,开发者可以通过自定义的key值进行消息回复. 创建自定义菜单后,由于微信客户端缓存,需要24小时微信客户端才会展现出来.建议测试时可以尝试取消关注公众账号后,再次关注,则可以看到创建后的效果. 菜单

Java微信公众平台开发模式+自定义按钮源码

首先,想用开放模式需要先成为开发者.成为开发者有两种写法. 一是:通过jsp页面,用out.print("echostr")//SHA1加密的字符串: 二是:通过Servlet.doGet返回exhostr,给微信平台. 这里我只写第二种方式的请求(这里的请求是以get方式请求),代码如下: import java.io.IOException; import java.io.InputStream; import java.io.PrintWriter; import java.ut

微信公众平台开发(109) 个性化菜单

关键字:微信公众平台 个性化菜单 conditionalmenu 作者:方倍工作室 原文:http://www.cnblogs.com/txw1958/p/weixin-menu-conditional.html 为了帮助公众号实现灵活的业务运营,微信公众平台新增了个性化菜单接口,开发者可以通过该接口,让公众号的不同用户群体看到不一样的自定义菜单.该接口开放给已认证订阅号和已认证服务号. 在这篇微信公众平台开发教程中,我们将介绍如何开发个性化菜单的功能. 一.个性化菜单接口 开发者可以通过以下条

微信公众平台如何创建自定义菜单?

微信现在的功能越来越强大了,申请认证后的开发者能自定义菜单,用户直接点击微信界面下方的菜单,就能直接去到指定的页面,下面小编用[微信公众平台测试号]为大家演示一下怎么创建自定义菜单. 工具/原料 认证后的微信公众平台 微信公众平台切换开发者模式 方法/步骤 登录[微信公众平台],选择[功能]菜单下面的[高级功能],进入[开发模式]. 由于小编的微信公众平台还没通过认证,下面用[申请测试账户]为大家演示. 微信公众平台接口测试帐号申请,无需公众帐号.快速申请接口测试号,直接体验和测试公众平台所有高

微信公众平台开发之个性菜单创建

1.先创建一个properties文件保存appid和appsecret import java.io.IOException; import java.util.Properties; //根据我创建的weixin.properties文件获取appid和appsecret public class WxConfig { private static Properties p = null; public static String getWxProperty(String key) { if

微信公众号开发——创建自定义菜单（PHP版）

<?php include "TokenUtil.php"; //TokenUtil::build_access_token(); $access_token = TokenUtil::read_token(); getSucaiList($access_token); function getSucaiList($token){ $url = 'https://api.weixin.qq.com/cgi-bin/menu/create?access_token='.$token