微信公众平台应用开发实践

微信公众平台的发展

微信和短信、相机一样，已经逐渐成为手机的标配工具。微信的即时通信、语音、视频聊天、朋友圈、群聊等功能极大程度地迎合了大众的沟通交流需求；微信公众平台、微信开放平台、企业微信等功能极大程度地帮助企业以低成本直接对接大量客户，有效地积累用户；微信小程序、扫一扫功能更是促进线上与线下、虚拟与现实、数字经济和传统经济的融合。在腾讯公司披露的数据中，微信月活跃账户数达到8.89亿，公众平台汇聚超过1000万公众账号、20万第三方开发者。对于微信公众平台应用开发来说，公众号也已经成为标配。很难想象一家企业没有自己的服务号，一个媒体人没有自己的订阅号。

笔者一直关注微信公众平台的进展。在微信公众平台发布之初，笔者撰写了《微信公众平台开发基础与实践》（机械工业出版社，2014）一书，当时微信版本为5.3；之后又撰写了《微信公众平台应用开发从入门到精通》（清华大学出版社，2015）一书，当时微信版本为6.2。

时光流逝，现在距离上一本书发表已将近两年，微信版本已到6.5。对于高速发展的IT行业来说，两年时间确实能够使知识变得陈旧，技术趋于落后。在这两年时间，微信公众平台发布了微信JS-SDK来为HTML 5提供原生功能支持，增加了微信卡券、微信门店、微信小店等新功能，开放了微信连Wi-Fi、微信摇一摇周边和微信扫一扫接口。重要的是，微信团队在2017年1月9日发布了小程序，并将其与公众号打通，这给IT从业者带来了新的机遇与挑战。于是，笔者有必要将公众号的进展记录下来，给想了解公众号技术的读者提供一些帮助。

本书的更新之处除了公众号的开放能力外，还有根据读者意见的内容修订。之前的两本书出版后，笔者收到了许多读者的邮件，在疑问、建议和勘误。笔者将读者的意见进行了整理，并在新书出版之际，对书中不明、易混、错误之处加以更正。

如何阅读本书

本书在内容逻辑上分为4部分。

部分（第1章～第3章）介绍公众平台的基础知识、编辑模式的使用和开发环境的搭建。通过这部分的学习，读者可以使用编辑模式来运营公众账号，并通过简单的配置来搭建开发环境，开发个DEMO应用，为后面的学习打下基础。

第二部分（第4章～第7章）重点介绍公众平台的消息相关接口及九大高级接口，提供完整的封装类，还将介绍Weixin JS和JS SDK开发。读者在学完本部分之后，能够对公众平台提供的全部服务有所了解。本部分将提供众多的案例供读者学习。

第三部分（第8章～第12章）以大项目为例，每章实现一个公众号的功能。5个项目分别为餐厅管家、微商城、微酒店、游戏开发：谁是卧底、HTML 5小游戏开发，探讨的内容包括自定义菜单、二维码、微信支付、微信小店、位置服务等。学习完本部分，读者完全有能力开发企业级的公众号。

第四部分（第13、14章）为拓展阅读，介绍微信公众号在O2O领域的开放能力，并讲解微信重磅推出的小程序。学习完本部分，读者会了解到微信公众号和小程序能做什么、能适应什么样的场景、能有多大的前景。

读者对象

对微信公众平台开发感兴趣的人员。

微信公众账号运营人员。

移动互联网开发人员。

HTML 5开发人员。

已有微信开发基础，但对项目开发不熟悉的开发人员。

有编程经验，希望转型做微信公众平台开发的人员。

技术交流

由于笔者水平有限，加之编写时间仓促，书中难免会出现一些错误或不准确、不全面的地方，恳请读者批评指正。为了更好地和读者交流，笔者建立了一个网站，请访问以下地址：

https://www.weixinbook.net/

同时，读者有任何问题，可以发送邮件到davidsp@foxmail.com邮箱，笔者会尽快为您解答。

代码下载

本书配套源代码的下载地址：https://www.weixinbook.net/download/。若下载有问题，请发送电子邮件至davidsp@foxmail.com，邮件标题为“求代码，微信公众号开发”。

致谢

感谢腾讯公司的微信团队，是他们创造了这款伟大的产品。

感谢清华大学出版社的王金柱编辑，感谢他在我写作过程中提供的帮助和支持。

谨以此书献给我的家人，以及微信公众平台和所有离不开微信的朋友们。

                                                                闫小坤

                                                            2017年4月于北京

第1章  微信公众平台简介 1

1.1  微信：连接一切 2

1.1.1 
物联网 2

1.1.2 
二维码革命 3

1.2  认识微信公众平台 4

1.2.1 
大事记 4

1.2.2 
分类：服务号与订阅号 5

1.2.3 
微信认证 6

1.2.4 
公众号运营 7

1.2.5 
微社区 8

1.2.6 
微信公众平台管理后台 8

1.3  本章小结 10

第2章  编辑模式和微信公众号 11

2.1  开启编辑模式 12

2.2  自动回复消息 12

2.2.1 
开启自动回复 13

2.2.2 
被添加自动回复 13

2.2.3 
消息自动回复 14

2.2.4 
关键词自动回复 15

2.2.5 
自动回复优先规则 16

2.3  自定义菜单 17

2.3.1 
设置自定义菜单 17

2.3.2 
设置动作 18

2.4  投票 19

2.5  案例分析 20

2.5.1 
利用自动回复实现我的书目功能 20

2.5.2 
自定义菜单的典型案例：小道消息 22

2.5.3 
自定义菜单增加历史消息 23

2.6  本章小结 24

第3章  搭建开发环境 25

3.1  启用公众平台开发模式 26

3.1.1 
申请网址接入 26

3.1.2 
数据交换方式 28

3.1.3 
接口列表 28

3.2  新浪云环境搭建 31

3.2.1 
应用创建 31

3.2.2 
搭建本地开发环境 35

3.2.3 
SAE常用服务 38

3.2.4 
新浪云虚拟主机 40

3.3 
BAE环境搭建 45

3.3.1 
创建工程 46

3.3.2 
BAE常用服务 47

3.4  开发个应用 48

3.4.1 
下载PHP SDK 48

3.4.2 
微信公众平台接口测试账号申请 48

3.4.3 
上传服务器 49

3.4.4 
扫描二维码 50

3.5  本章小结 51

第4章  消息接口API 52

4.1  接入开发者模式 53

4.2  基础支持 54

4.2.1 
申请测试账号 54

4.2.2 
获取access_token 55

4.3  接收消息 58

4.3.1 
文本消息 58

4.3.2 
图片消息 60

4.3.3 
语音消息 61

4.3.4 
地理位置消息 62

4.3.5 
链接消息 64

4.3.6 
公众平台消息体签名及加、解密 67

4.4  接收事件消息 67

4.4.1 
关注/取消关注事件 68

4.4.2 
扫描二维码事件 69

4.4.3 
上报地理位置事件 71

4.4.4 
自定义菜单事件 72

4.5  回复消息 74

4.5.1 
回复文本消息 74

4.5.2 
回复图片消息 75

4.5.3 
回复语音消息 76

4.5.4 
回复视频消息 78

4.5.5 
回复音乐消息 79

4.5.6 
回复图文消息 81

4.6  生成带参数的二维码 84

4.6.1 
创建二维码ticket 84

4.6.2 
通过ticket换取二维码 86

4.7  客服接口 87

4.8  语音识别 92

4.8.1 
让微信听懂你的话 92

4.8.2 
翻译助手 92

4.9  本章小结 96

第5章  高级接口 97

5.1  自定义菜单 98

5.1.1 
自定义菜单的创建 98

5.1.2 
自定义菜单的查询和删除 102

5.2  上传/下载多媒体文件 102

5.2.1 
上传多媒体文件 102

5.2.2 
下载多媒体文件 104

5.2.3 
测试案例 105

5.3  用户管理 106

5.3.1 
管理分组 106

5.3.2 
获取用户基本信息 112

5.3.3 
获取用户列表 114

5.4  获取用户地理位置 116

5.5 
OAuth 2.0网页授权 117

5.5.1 
配置授权回调域名 118

5.5.2 
OAuth 2.0授权流程 119

5.5.3 
代码实现 122

5.5.4 
案例 124

5.6  高级群发接口 126

5.6.1 
上传图文消息素材 126

5.6.2 
根据分组进行群发 128

5.6.3 
根据OpenID列表群发 134

5.6.4 
删除群发 134

5.6.5 
事件推送群发结果 135

5.7  多客服功能 136

5.8  微信小店 139

5.9  模板消息 140

5.9.1 
创建模板 140

5.9.2 
发送模板消息 141

5.10 
企业号 142

5.10.1 
申请企业号 143

5.10.2 
组织架构 144

5.10.3 
发送通知 145

5.11 
本章小结 145

第6章  微信内置浏览器Weixin
JS接口 146

6.1  微信内置浏览器 147

6.1.1 
特征 147

6.1.2 
WeixinJSBridge 148

6.2 
WeixinJSBridge使用说明 150

6.2.1 
WeixinJSBridge接口一览 150

6.2.2 
界面接口 151

6.2.3 
分享接口 153

6.2.4 
监听事件 156

6.2.5 
功能接口 158

6.2.6 
第三方App接口 159

6.3  案例 162

6.3.1 
WeixinJSBridge的加载顺序 162

6.3.2 
隐藏/显示WebView分享按钮 163

6.3.3 
隐藏/显示WebView底部的导航栏 165

6.3.4 
跳转到扫描二维码界面 167

6.3.5 
关闭WebView 168

6.3.6 
图片预览 170

6.4  微信iOS客户端内置浏览器适配
172

6.4.1 
UIWebview和WKWebview介绍 172

6.4.2 
内核切换方法 172

6.4.3 
内核识别方法 173

6.4.4 
微信内置浏览器内核判断 174

6.4.5 
适配注意事项 175

6. 5 
本章小结 175

第7章  微信JS-SDK 176

7.1  微信JS-SDK简介 177

7.2  微信Web开发者工具 178

7.3 
JS-SDK的使用 180

7.3.1 
JS接口安全域名 180

7.3.2 
微信客户端版本要求 181

7.4  在SAE上使用JS-SDK 181

7.5  微信网页开发样式库 185

7.6  本章小结 186

第8章  餐厅管家 187

8.1  功能设计 188

8.1.1 
需求分析 188

8.1.2 
功能演示 189

8.1.3 
注意事项 191

8.2  “餐厅管家”的实现一：创建自定义菜单 191

8.2.1 
自定义菜单 192

8.2.2 
数据库操作类封装 193

8.2.3 
微信消息接口 206

8.3  “餐厅管家”的实现二：预约管理 215

8.3.1 
数据表设计 215

8.3.2 
流程设计 216

8.3.3 
网页与样式 217

8.3.4 
预约页面 218

8.3.5 
我的预约页面 222

8.4  “餐厅管家”的实现三：菜单管理 223

8.4.1 
数据表设计 223

8.4.2 
菜单展示页面 224

8.4.3 
菜单管理后台 226

8.5  “餐厅管家”的实现四：优惠券二维码 226

8.5.1 
数据库设计 226

8.5.2 
生成二维码优惠券 227

8.5.3 
优惠券列表 230

8.5.4 
使用优惠券 233

8.5.5 
利用WebSocket实现信息推送 237

8.6  “餐厅管家”的实现五：路线导航 239

8.6.1 
腾讯地图API 239

8.6.2 
数据库设计 240

8.6.3 
添加饭店位置 241

8.6.4 
获取用户位置 244

8.6.5 
路径选择算法 245

8.7  本章小结 252

第9章  微商城 253

9.1  抽奖系统 254

9.1.1 
前端展示 254

9.1.2 
抽奖动画 254

9.1.3 
中奖概率 255<