Category Archives: 微信开发

微信开发

微信用户信息接口的小坑

2016 年 09 月 14 日 – 上午 6:43

基于微信的开发，用户信息是基础，甭管是关注后，还是强制授权，都需要调取“sns/userinfo”接口，提取用户消息
很多事情，我们觉得理所当然，比如，sns/userinfo返回的nickname和headimgurl，这俩不都该成对出现吗？要么都有、要么都没有
不过，事与愿违，到库里去看用户消息，还真有不少nickname、headimgurl只有一个，另一个是空的；特别是nickname，很多都是空的

发现问题，就要寻找原因、解决问题，首先看nickname
由于项目里对外部资源调用的日志记录比较齐全，通过openid，很容易就能发现，比如nickname是下面早这类值时：
存到库就是空的。。。字符集的问题
库里varchar用的是utf8，请教运维，可以不可通过修改字符集，来保存这类支付，无果。。。
无奈关键用户表就不要胡乱做测试，解决方案是加了一个字段，专门保存urlencode(nickname)，提取用户信息、需要显示昵称的时候，加个简单判断，再把urldecode显示出来

然后是headimgurl为空的情况
这个再查日志就没啥办法了：就是空的
猜测是用户本来就没上传头像，微信客户端里显示的默认头像，但默认头像既然非用户上传，就认为用户无头像，所以userinfo接口就不给喽
没限制的微信号做这类实际测试，还好headimgurl为空只是极少数

——补充。。。上面说的昵称中的表情符太毒了，wordrpess居然也没能兼容，无奈只能用图

Tags 微信开发 | Permalink | Comment (0)

通过iBeacon接入微信摇一摇

2015 年 04 月 15 日 – 上午 3:12

什么是iBeacon？维基百科的定义是这样的：

“一套iBeacon的部署由一个或多个在一定范围内发射传输他们唯一的识别码iBeacon信标设备组成。接收设备上的软件可以查找iBeacon并实现多种功能，比如通知用户，接收设备也可以通过链接iBeacons从iBeacon的通用属性配置服务来恢复价值。iBeacons不推送通知给接收设备（除了他们自己的ID），然而，手机软件可以使用从iBeacons接收到的信号来自己推送通知”

不用太关注这个定义，微信摇一摇.周边功能，虽然使用到iBeacon，但其实只用到了它的“信标”功能，具体过程是这样的：

iBeacon基站通过不断地通过蓝牙广播自己的存在（实际有间隔，100~5000+ms）
用户手机打开微信摇一摇界面时，如果此时蓝牙是打开的，摇一摇就会就会在“人、歌曲、tv”之外多出一个“周边”，并且默认是“周边”
用户这时摇手机，就会出现第一步 iBeacon基站相关的信息

那么，这个 iBeacon设备的信息如果设置哪？

首先，需要有一个开通支付功能的微信服务号
微信公号后台“新功能插件”里，选择“摇一摇周边”，申请
登录摇一摇后台（zb.weixin.qq.com），“设备管理”，新建设备，申请新设备的UUID/Major/Minor
将上述参数设置到你的iBeacon设备设备内

关于iBeacon基站，摇一摇后台就很多的推荐，另外，你也可以在淘宝购买，甚至可以自己购买蓝牙模块，通过简单配置，将其变成蓝牙基站

下面的这个链接，讲述了通过树莓派将HM-10蓝牙模块配置成iBeacon基站的方法，操作简单，亲测可用

http://www.xuebuyuan.com/2015895.html

Tags iBeacon, 微信公号 | Permalink | Comment (0)

Hello World 微信开发

玩转微信公号开发（九）——获取用户信息

2014 年 04 月 12 日 – 上午 8:31

这里的“用户信息”，指的是昵称、头像等信息，具体的：

{
    "subscribe": 1, 
    "openid": "o6_bmjrPTlm6_2sgVt7hMZOPfL2M", 
    "nickname": "Band", 
    "sex": 1, 
    "language": "zh_CN", 
    "city": "广州", 
    "province": "广东", 
    "country": "中国", 
    "headimgurl": "http://wx.qlogo.cn/mmopen/g3MonUZtNHkdmzicIlibx6iaFqAc56vxLSUfpb6n5WKSYVY0ChQKkiaJSgQ1dZuTOgvLLrhJbERQQ4eMsv84eavHiaiceqxibJxCfHe/0", 
   "subscribe_time": 1382694957
}

具体的接口是：
https://api.weixin.qq.com/cgi-bin/user/info?access_token=ACCESS_TOKEN&openid=OPENID&lang=zh_CN

这里的ACCESS_TOKEN获取方法可以参考本系列之前的文章

如果用户没关注，subscribe字段为0，没有nickname、headimgurl等字段，只有用户关注你的公众号，才能拿到上面的全部信息

你可以用这个接口取得用户基本信息，也可以那它判断当前用户是否关注你的公众号

早期的时候，微信对用户基本信息控制的比较严格，只有用户授权过才能拿到这些信息，而且，再次拿信息的话，还要重新授权

偶然才看到微信的文档有了升级，用户信息接口换成了这个新的：/user/info，免去了惹人厌的授权过程。这点小小的开放，让很多基于微信的活动方案成为可能【赞一个】

————–
转载请注明出处：http://www.jiangkl.com/2014/04/weixin_user_info

Tags 微信公号, 微信开发 | Permalink | Comment (0)

Hello World 微信开发

玩转微信公号开发（七）——账号体系与oauth登录

2014 年 02 月 16 日 – 上午 7:33

默认情况下，如之前“接收消息”里所说，一个用户和微信公号发生交互是，开发者拿到的是用户的openId，每一个用户，对应每一个公号，都有唯一的一个openId，当用户使用微信内置webview访问我们的页面是，开发者可以调用oauth2.0协议，302到自定的url，获取访问者的openId

$redirect = 'http://xxxx.xxx.com/xxx';
$url = 'http://open.weixin.qq.com/connect/oauth2/authorize?appid=your-appid&redirect_uri='
   .$redirect.'&response_type=code&scope=snsapi_base&state=ubox#wechat_redirect';
$this->redirect($url);
exit;

其中，scope=snsapi_base是要获取的权限类型，snsapi_base获取的只是openId，snsapi_userinfo可以用户获取用的较详细的昵称、头像等内容，但是是需要用户授权
上面的$redirect，就是登陆后需要跳转回来的开发者服务器的地址，这个登录操作是自动的，不需要用户做操作
跳回以后，url后附加一个code参数，通过这个code，再调微信的对应接口，即可获得openId，或者userinfo

$url = 'https://api.weixin.qq.com/sns/oauth2/access_token?appid=your-appid&secret=your-appSecret&code='.
	$_GET['code'].'&grant_type=authorization_code';
$json = Http::httpsGet($url);
$wxInfo = json_decode($json, true);
$openId = $wxInfo['openid'];
//.....你的其他操作

取得json的接口如下：

{
  "access_token":"xxxxxxxxxxxxxxxxxxxxxxxx",
  "expires_in":7200,
  "refresh_token":"xxxxxxxxxxxxxxxxxxxxxxxx",
  "openid":"ogaN_jp4sLWa4ZXGu5L39SSKcXU8",
  "scope":"snsapi_base,"
}

如你所见，openid就在里面了，进一步的，有了access_token，scope值如果是snsapi_userinfo，那么你还可以调“/sns/userinfo”接口取用户昵称等信息
expires_in是token超时时间，refresh_token可以用来刷新access_token

————
转载请注明出处： http://www.jiangkl.com/2014/02/weixin_oauth_userinfo/

Tags 微信公号 | Permalink | Comments (2)

Hello World 微信开发

玩转微信公号开发（六）——设置菜单

2014 年 01 月 30 日 – 上午 3:38

这里要讲的是，在开发模式下，如何自定义菜单

因为可能有中文乱码的问题，所以这里直接拼json串，然后调接口，post就ok了

public function weixin_custom_menu(){
	$token 		= WXUtil::getAccessToken();
	$url 			= "https://api.weixin.qq.com/cgi-bin/menu/create?access_token=".$token;
	$msg 		= '{"button":['
		//单菜单
		.'{"type":"click","name":"现在购买","key":"BTN_1"},'
		.'{"type":"click","name":"优惠活动","key":"BTN_2"},'
		.'{"name":"帮助",//多级菜单
			"sub_button":[
					{"type":"view","name":"下载","url":"http://xx.com/download.html"},
					{"type":"view","name":"使用教程","url":"http://xx.com/howbuy.html"},  
					{"type":"view","name":"关于我们","url":"http://xx.com/about.html"}
				]
			}
		]}';
	echo $msg;
	$r 		= Http::httpsPost($url, $msg);
	print_r($r);//打印结果，返回error为0的话，即为设置成功
	exit;
}

参数说明

type，按钮的类型

name，按钮的显示名称
key，事件标示，对应本系列第二篇里提到的EventKey字段
url

菜单设置后，通常需要退出公众号再进一次才能生效，如果还不行，只能取消关注、再关注一次

————
转载请注明住处：http://www.jiangkl.com/2014/01/weixin_custom_menu

Tags 微信公号 | Permalink | Comment (0)

Hello World 微信开发

玩转微信公号开发（五）——发送主动消息

2014 年 01 月 29 日 – 上午 8:07

解决了access_token的问题，让我们来看看怎么主动给用户发消息

主动消息有两类，客服消息和模板消息，微信对滥发消息很敏感，所以对这两个功能限制很多，并且，这两个功能也都术语高级接口

客服消息

顾名思义，客服消息是给客服用的，具体限制是：用户给公众号发送过消息后（发送消息、菜单点击、支付成功、用户维权、扫描带参数二维码、订阅），48小时内，开发者可以调用客服消息接口，给该用户发送消息，消息的类型可以是文本、图片、语音、视频、音乐、图文，数据的格式是json~~注意，除了前面讲到的同步回复消息疑问，以后和微信的交互的数据格式都是json

	//$data可以是字符串，也可能是数组，随具体的$type而改变
	public function sendCustom($openId, $data, $type = 'text'){
		$msg 		= array(
			'touser'		=> $openId,
		);
		switch($type){
			case 'text':
				$msg['msgtype'] = 'text';
				$msg['text'] 	= array('content' => urlencode($data));
				break;
			case 'image':
				$msg['msgtype'] = 'image';
				$msg['image'] 	= array('media_id' => $data);
				break;
			case 'voice':
				$msg['msgtype'] = 'voice';
				$msg['voice'] 	= array('media_id' => $data);
				break;
			case 'video':
				$msg['msgtype'] = 'video';
				$msg['video'] 	= $data;
				break;
			case 'music':
				$msg['msgtype'] = 'music';
				$msg['music'] 	= $data; 
				break;
			case 'news':
				$msg['msgtype'] = 'news';
				foreach($data as $k => $v){
					if(isset($v['title'])) $v['title'] = urlencode($v['title']);
					if(isset($v['description'])) $v['description'] = urlencode($v['description']);
					$data[$k] 	= $v;
				}
				$msg['news'] 	= array('articles' => $data);
				break;
		}
		$url 		= 'https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token='.self::getAccessToken();
		$postData 	= urldecode(json_encode($msg));
		$r 		= Http::httpsPost($url, $postData, true, false);
		return $r;
	}

getAccessToken，是在取access_token
httpsPost和上次说的httpsGet类似，只多了下面的两行，$input即为post的内容：

1 2	curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, $input);

模板消息

模板消息，没有上面客服消息的限制，但是必须在微信提供的模板框架内拼出消息，如果用户想使用自己的模板，需要特别申请~~基本上很难
首先，从微信公号后台挑选可用的模板，拿到templateId，然后拼装下面结构的post参数：

$postData = array(
	"touser"	=> $openId,//接受者
	"template_id"	=> $templateId,
	//data为模板内的实际内容，字段项目视具体模板而定
	"data"		=> array("NAME"=>"里斯之泪", "PRICE"=>"￥10000.00"),
	"url"		=> "http://xxxx.xxx.com/xxxx",
	"topcolor"	=> "#333",//顶栏颜色
);

然后整理数据、调用接口就ok了

1 2	$postData = json_encode($postData); $r = Http::httpsPost($url, $postData);

————
转载请注明出处： http://www.jiangkl.com/2014/01/custom-send_template/

Tags 微信公号 | Permalink | Comment (0)

Hello World 微信开发

玩转微信公号开发（四）——获取access_token与上传多媒体文件

2014 年 01 月 28 日 – 上午 7:27

access_token

access_token是开发者访问其他微信接口的凭证，一个微信公众号，在同一时刻，只能有一个access_token，有效时间两小时

具体的获取方法如下

  $url   = "https://api.weixin.qq.com/cgi-bin/token?"
      ."grant_type=client_credential&appid=".$appId."&secret=".$appSecret;
  $r     = Http::httpsGet($url);
  $r     = json_decode($r, true);
  $token = isset($r['access_token']) ? urldecode($r['access_token']) : false;

其中，httpsGet：

  function httpsGet($url){
    $ch = curl_init(); 
    $header[] = "Content-type: text/plain";
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
    $response = curl_exec($ch);
    curl_close($ch);
    $result = trim(urldecode($response));
    return $result;
  }

鉴于access_token的“广泛应用”和诸多限制，我们的做法是为它做了一个redis缓存，每小时刷新一次，所有用到access_token项目都从这个缓存里取

上传多媒体文件

~~其实，俺们的项目里，还没用到过这个功能，但既然做教程，就尽量做的完整些，下面内容只是微信官方文档的整理摘录

上传地址：http://file.api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE

type: image/voice/video/thumb(缩略图)

POST字段名：media

(看这格式，还是写个html页面比较合适)

限制:
图片（image）: 128K，支持JPG格式
语音（voice）：256K，播放长度不超过60s，支持AMR\MP3格式
视频（video）：1MB，支持MP4格式
缩略图（thumb）：64KB，支持JPG格式

下载多媒体文件

http://file.api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID

~~没啥可说的，一目了然

————
转载请注明出处：http://www.jiangkl.com/2014/01/access-token_media/

Tags 微信公号 | Permalink | Comment (0)

Hello World 微信开发

玩转微信公号开发（三）——消息的回复

2014 年 01 月 28 日 – 上午 6:58

这里说的消息回复，是指对用户发给公众号消息的同步回复，用户给公众号发了消息，开发者可以不回复，或者给该用户回复一条~~只一条

回复消息的格式如下：

  <xml>
    <ToUserName><![CDATA[orrnVjsadf-FbumIsdafZiBUFTw]]></ToUserName>
    <FromUserName><![CDATA[gh_fsadf942sdf9]]></FromUserName>
    <CreateTime>1390889296</CreateTime>
    <MsgType><![CDATA[text]]></MsgType>
    <Content><![CDATA[你好]]></Content>
  </xml>

虽然消息里第一项就是ToUserName，但是~~这里只能回复给当前发送消息的用户，写别的用户是无效的

MsgType包括下面几个类型：

text，文本
image，图片
voice，语音
video，视频
music，音乐
news，图文

文本

即开篇的那个例子，Content是文本内容~~~告诉大家一个官方文档没有的小秘密：使用a标签，可以给消息添加链接

图片

  <xml>
    <ToUserName><![CDATA[orrnVjsadf-FbumIsdafZiBUFTw]]></ToUserName>
    <FromUserName><![CDATA[gh_fsadf942sdf9]]></FromUserName>
    <CreateTime>1390889296</CreateTime>
    <MsgType><![CDATA[image]]></MsgType>
   <Image>
     <MediaId><![CDATA[media_id]]></MediaId>
   </Image>
  </xml>

图片，以及下面的视频、音频里的media_id，首先要通过微信的上传多媒体文件接口获得，详细的情况，以后会讲到

语音

  <xml>
    <ToUserName><![CDATA[orrnVjsadf-FbumIsdafZiBUFTw]]></ToUserName>
    <FromUserName><![CDATA[gh_fsadf942sdf9]]></FromUserName>
    <CreateTime>1390889296</CreateTime>
    <MsgType><![CDATA[voice]]></MsgType>
    <Voice>
      <MediaId><![CDATA[media_id]]></MediaId>
    </Voice>
  </xml>

~没啥可说的，和图片类似

视频

  <xml>
    <ToUserName><![CDATA[orrnVjsadf-FbumIsdafZiBUFTw]]></ToUserName>
    <FromUserName><![CDATA[gh_fsadf942sdf9]]></FromUserName>
    <CreateTime>1390889296</CreateTime>
    <MsgType><![CDATA[video]]></MsgType>
    <Video>
      <MediaId><![CDATA[media_id]]></MediaId>
      <Title><![CDATA[视频标题]]></Title>
      <Description><![CDATA[视频介绍]]></Description>
    </Video> 
  </xml>

音乐

  <xml>
    <ToUserName><![CDATA[orrnVjsadf-FbumIsdafZiBUFTw]]></ToUserName>
    <FromUserName><![CDATA[gh_fsadf942sdf9]]></FromUserName>
    <CreateTime>1390889296</CreateTime>
    <MsgType><![CDATA[video]]></MsgType>
    <Music>
      <Title><![CDATA[音乐标题]]></Title>
      <Description><![CDATA[音乐介绍]]></Description>
      <MusicUrl><![CDATA[音乐链接]]></MusicUrl>
      <HQMusicUrl><![CDATA[WIFI环境优先使用的高质量音乐链接]]></HQMusicUrl>
      <ThumbMediaId><![CDATA[media_id~缩略图的媒体id]]></ThumbMediaId>
    </Music> 
  </xml>

图文

<xml>
  <ToUserName><![CDATA[orrnVjsadf-FbumIsdafZiBUFTw]]></ToUserName>
  <FromUserName><![CDATA[gh_fsadf942sdf9]]></FromUserName>
  <CreateTime>1390889296</CreateTime>
  <MsgType><![CDATA[news]]></MsgType>
  <ArticleCount>5</ArticleCount>
  <Articles>
    <item>
      <Title><![CDATA[标题1]]></Title>
      <PicUrl><![CDATA[http://y1.ifengimg.com/2014/01/28/14023732.jpg]]></PicUrl>
      <Url><![CDATA[http://xxxx.xxx.com/index]]></Url>
    </item>
    <item>
      <Title><![CDATA[标题2]]></Title>
      <PicUrl><![CDATA[http://xxxx.xxx.com/xxx.png]]></PicUrl>
      <Url><![CDATA[http://xxxx.xxx.com/index]]></Url>
    </item>
    ......  
  </Articles>
</xml>

ArticleCount，是item子项的数量

图文的第一条，会以大图显示，推荐尺寸720*400，不同的尺寸在不同的手机上显示效果差别很大，可能左右也可能上下被遮住

除第一条外，其他的图文里的图，都只显示小icon，所以我们用的时候，统一用了一个向右的箭头

最后，来说一个不常用，但对于新手很重要的东西：网关的验证消息怎么回复

太简单了~~直接输出get参数里的echostr

————
转载请注明出处：http://www.jiangkl.com/2014/01/weixin_msg_2/

Tags 微信公号 | Permalink | Comment (0)

Hello World 微信开发

玩转微信公号开发（二）——消息的接受

2014 年 01 月 27 日 – 上午 8:53

当用户在公号内微信推给开发者服务器的是这样一个xml

  <xml>
    <ToUserName><![CDATA[gh_fsadfe942b39]]></ToUserName>
    <FromUserName><![CDATA[orrnsdfsdfLom-FsssD1wZiBUFTw]]></FromUserName>
    <CreateTime>1390809909</CreateTime>
    <MsgType><![CDATA[event]]></MsgType>
    <Event><![CDATA[subscribe]]></Event>
    <EventKey><![CDATA[]]></EventKey>
  </xml>

或者这样：

  <xml>
    <ToUserName><![CDATA[gh_fsadfe942b39]]></ToUserName>
    <FromUserName><![CDATA[orrnsdfsdfLom-FsssD1wZiBUFTw]]></FromUserName>
    <CreateTime>1390810725</CreateTime>
    <MsgType><![CDATA[text]]></MsgType>
    <Content><![CDATA[你好]]></Content>
    <MsgId>5973123479001063148</MsgId>
  </xml>

最基本的是如下四个字段：

ToUserName，是公号的标示
FromUserName，是用户的openId，如果要针对特定用户做什么事，这个字段会很有用
MsgType，消息类型，比如event、text、location、image等
CreateTime

除了两个UserName和MsgType，每一种MsgType，xml还会包含如下字段：

event

text

location

image

link，网页

另外还有语音、视频等类型，以后用到的时候再补充~~

常用的事件类型包括如下几个（MsgType为event时）

subscribe，新用户关注，当然，也可能是再次关注
unsubscribe，取消关注
validate_url，微信后台测试开发者网关，只在设置网管是才会有
CLICK，菜单点击

好的，今天就到这儿。。。

什么，你问怎么得到消息？

微信通过post将xml给开发者服务器，php里，通过$GLOBALS[“HTTP_RAW_POST_DATA”]接收~~~xml怎么解析？我是用的simplexml_load_string，不太好用，应该还有更好用的xml解析工具

转载请注明出处：http://www.jiangkl.com/2014/01/weixin_msg/

Tags 微信公号 | Permalink | Comment (0)

Hello World 微信开发

玩转微信公号开发（一）——使用“开发模式”

2014 年 01 月 27 日 – 上午 2:21

近半年都在做基于微信公众号的开发，节前几天工作不忙，把相关的(可以公开的)经验写到blog里给大家分享，也算自己的一个小总结

先来理清关于微信公号的几个概念：

订阅号与服务号：

订阅号是相对比较好申请，但是权限较低的公众号

服务号由订阅号升级得到，貌似现在要花钱才能升级~~

订阅号相对服务号的唯一的优势是：每天可以群发一条信息，而服务号每个月才能群发一条

服务号可以享有更多的高级接口权限，比如客服消息、定位、支付等

编辑模式与开发模式：

两种模式下，均可以在微信后台对用户做消息的回复、群发，管理粉丝群。他们的不同，主要在自动回复的能力上

编辑模式下，可以在微信后台设置各种自动回复，可以根据关键字设置回复~~但仅此而已，再复杂的回复模式(目前)就做不到了

开发模式下，可以将用户的消息转到公号后台所设置的服务器，然后有服务器根据各种消息类型和业务逻辑，以及具体的用户，来做出回复

编辑模式和开发模式，只能选一个

开发者的服务器配置：

包括一个服务器网关的url地址，和一个token

网关，即你的服务器地址，用来接受用户发给你公众号的各种消息；你要回复给用户的消息，即为这个请求的响应

token，一个用作标示的字符串，让服务器可以判断哪一个公众号的消息

转载请注明出处：http://www.jiangkl.com/2014/01/weixin_dev/

—————–over，今天先到这里，下次继续

Tags 微信公号 | Permalink | Comment (0)

2025 年 8 月
一	二	三	四	五	六	日
				1	2	3
4	5	6	7	8	9	10
11	12	13	14	15	16	17
18	19	20	21	22	23	24
25	26	27	28	29	30	31

Category Archives: 微信开发

参数说明

解决了access_token的问题，让我们来看看怎么主动给用户发消息

客服消息

模板消息

access_token

上传多媒体文件

下载多媒体文件

MsgType包括下面几个类型：

文本

图片

语音

视频

音乐

图文

最后，来说一个不常用，但对于新手很重要的东西：网关的验证消息怎么回复

最基本的是如下四个字段：

除了两个UserName和MsgType，每一种MsgType，xml还会包含如下字段：

另外还有语音、视频等类型，以后用到的时候再补充~~

常用的事件类型包括如下几个（MsgType为event时）

转载请注明出处：http://www.jiangkl.com/2014/01/weixin_msg/

订阅号与服务号：

编辑模式与开发模式：

开发者的服务器配置：

五花八门

分门别类

时间线

链接表

七嘴八舌

近期发布

发布日历