收藏官网首页
查看: 18073|回复: 13

微信应用开发

34

主题

896

帖子

2274

积分

超级版主

Rank: 8Rank: 8

积分
2274
发表于 2016-8-8 12:05:12 | 显示全部楼层 |阅读模式
校园创客福利
一、微信应用开发流程概述
如果开发者有通过微信公众平台作为与最终消费者的交互界面的需求,您可以通过阅读本文档了解如何借助机智云以及微信公众号、微信硬件平台进行开发。由于基于微信公众号进行硬件设备的接入、控制需要与多个平台交互。所以,有必要对每个平台的作用有清晰的了解。
总体接入流程图

机智云
如图①在微信接入业务场景中,通过开发者中心(site.gizwits.com)的图形化界面定义设备功能,机智云自动生成设备MCU与通信模组之间的串口通信协议,开发者根据协议文档即可实现设备的联网能力。
如图②部分,设备接入机智云后,机智云提供了面向微信应用的API,提供传输设备数据到应用、应用向设备发起的控制信息的功能。
厂商服务器
厂商服务器是厂商为了满足自己的微信应用,独立部署的WEB系统。该系统通过机智云平台提供的API进行与设备的数据、控制的实时通讯,解决智能硬件接入的需求;通过访问微信公众号平台的API实现以微信为渠道服务厂商最终消费者的需求。
首先,开发者可以为自己的应用设计个性化的HTML交互界面与功能。(如图③④部分)

微信服务器
微信服务器主要为设备与厂商服务器之间的通信提供了一系列的接口,主要包括微信用户账号与设备的绑定/解绑定、接受/发送设备消息等,具体接口及使用方法可查看微信官方文档,微信最近推出了微信硬件平台,在做微信接入前需要仔细了解微信公众号与微信硬件平台,提供的功能要在不断完善。
微信客户端
微信客户端提供了最终与用户交互的操作界面,可以理解为就是一个运行在手机的浏览器,只不过是运行在微信公众号这套体系下。开发者可通过自己申请的公众号管理后台配置自定义的菜单


二、了解微信了解微信公众号平台
具体内容请参考微信公众平台

2

主题

16

帖子

269

积分

中级会员

Rank: 3Rank: 3

积分
269
发表于 2016-8-30 09:53:10 | 显示全部楼层
第一步,公众号原始ID写入WIFI固件非客户开发者就没法做了,接下来说的都是没用的话了。。

34

主题

896

帖子

2274

积分

超级版主

Rank: 8Rank: 8

积分
2274
 楼主| 发表于 2016-8-8 12:07:41 | 显示全部楼层
微信应用:快速开始教程
目标驱动的教程
        本教程以目标为驱动,去除多余的细节,让机智云的小伙伴们,可以快速的搞定微信接入。好啦,我们开始吧!
为什么接入微信?
  • 微信有大量的用户
  • 用户不愿意,为某个垂直领域的服务,单独装一个应用
  • 微信有全平台的版本,开发一次,相当于开发多个应用
  • 等等……

        正是这些好处,我们才会借助微信的力量。所以,我们将借助微信的两大体系:
  • 用户体系(OpenId)
  • 微信APP(AirKiss 和 内置浏览器)。

       最终,我们希望用户,能像体验微信原生功能一样,使用我们的智能设备。
你有微信公众号?
        首先,我们需要申请微信公众号。
        注意,不能申请订阅号(不支持微信认证)。我们将申请一个服务号,并且完成认证操作,然后才能开启“设备功能”模块,最后添加一个产品。
        最终,你会得到两件装备:
  • 公众号的原始ID
  • 设备的二维码

       当然,你也可以使用测试号,进行前期开发阶段的调试。
你得有台设备吧?
       微信接入前,需保证,设备能正常地与机智云进行通讯,设备的具体开发流程如下。
      
       注意,在WIFI模块中,写入AirKiss时,需要配置公众号的原始ID。也就说,除了将机智云的product_key写入MCU以外,还需要将公众号原始ID写入WIFI固件中。关于固件的烧录,厂商或者小伙伴们如有困难,可以寻求机智云 · 客服MM的帮助。
设备授权
       设备不但要在WIFI固件中写入公众号原始ID(注意,不是APPID),还要将所有设备的Mac地址,登记到微信服务器上。一开始,微信只给你100个配额,也就是说,你只能授权100个设备。
       授权的方法,就是向微信的接口,发送一次请求,具体请看微信文档-设备授权
       很多小伙伴反应,授权经常失败,我们这里给出一组基于WIFI通讯的示例,大家可以参考:
      
        注意:12位xxxxxxxxxxxx,代表设备的Mac地址,id是指设备ID,也就是机智云的did。但因为设备必须在上线后,机智云才会分配一个did,所以,我们并无法预知did是什么。通常的做法是:将id和mac,都设置为设备的Mac值。
        auth_key可以不填,设置为空字符串,但不能没有这个字段。
        op_type为0时,表示添加一台设备,后面需要跟着product_id字段(产品ID,在公众号的“设备功能”中,添加产品后,会有这个id)。op_type为1时,表示更新一台设备,此时不需要product_id字段。
        批量授权时,记得更新顶部的:device_num。
        这样,我们硬件(设备)层面的准备工作,就完成啦。
阶段性成果
       好了,到这步,你可以稍微的奖励一下自己,享受一下阶段性的成果啦!
       打开你的微信(确保是wifi链接状态),扫一扫你的产品二维码。
      
       下面有两个按钮,绿色的按钮,是启动微信的AirKiss,将WIFI的账号密码,发送给设备的WIFI模块。
       部分设备需要启动匹配模式,才能配置上网。一般先启动设备的匹配模式,再使用微信的配置功能。配置完成后,会自动跳转到设备搜索界面。
       在搜索界面,如果前面准备工作到位了,你一定能发现设备(不管是否绑定过)。点击发现的设备,然后绑定。微信会自动跳转到公众号页面。然后,你可以在微信的设置页面中,发现多了一个项目:设备。
       当然,上面的操作,只是实现绑定操作。下面的教程将介绍如何监控设备的数据点。
简化操作的SDK
       为了简化开发者的操作,我们将一些必要的API封装成了两个SDK: java-SDK 以及 js-SDK。它们分别用于后台和前端页面,各自封装了机智云的OpenAPI 以及 WebSocket。
       这两个SDK,将大大的简化了API的操作,帮我们接管了token和用户管理,我们只需要调用相关方法,即可实现设备的绑定和解绑。
        SDK,可以在本文的附件中下载。
业务服务器的搭建
       设备没问题了,我们现在需要的是,操控设备本身的功能。
       由于设备已经与机智云正常的通讯,因此,对设备的操作,其实就是如何与机智云交互。
机智云设备绑定
       现在,用户已经在微信中绑定了设备,他希望看到,设备在线状态。怎么办?
       我们使用微信的OpenId,作为唯一标识,生成匿名用户。什么时候注册匿名用户呢?微信绑定设备时候,将推送一条设备绑定事件消息到我们的业务服务器。我们在这个时候,将同时完成注册匿名用户,以及绑定用户/设备的操作。
      
       微信在绑定时,发送这么一条事件消息:
        
        我们需要的是其中的OpenID和Mac,然后我们调用机智云的Java-SDK:
  1. DeviceInfo deviceInfo = OpenApi.bindDevice(
  2.                                     wechatOpenId,
  3.                                     gizwitsAppId,
  4.                                     gizwitsProductKey,
  5.                                     gizwitsProductSecret,
  6.                                     mac,
  7.                                     deviceAlias,
  8.                                     deviceRemark)
复制代码
参数名
类型
说明
wechatOpenId
String
微信中的OpenId,也就是机智云中注册的匿名用户
gizwitsAppId
String
机智云产品所绑定的APP的id
gizwitsProductKey
String
机智云的产品key
gizwitsProductSecret
String
机智云的产品Secret
mac
String
设备的Mac地址
deviceAlias
String
设备的别名
deviceRemark
String
设备的备注

        这个方法,一次性解决了两个问题:注册匿名用户,绑定用户/设备。相对的,也要设定很多参数。所有的参数都是String类型。
        其中deviceAlias(设备别名)以及deviceRemark(设备备注)都可以填空字符串“”。gizwitsProductKey就是你在开发者中心创建的产品。
        而gizwitsProductSecret,则是该产品对应的密匙,在产品的详细信息中可以找到。

        gizwitsAppId是机智云中,APP的Id。由于一个产品,可能是多个APP操作的,比如IOS的APP,Android的APP,网站Web应用,甚至微信这样的轻应用,都算是一个APP。因此,在创建产品后,你还可以在为产品绑定一个或多个APP。这里的gizwitsAppId就是我们所绑定APP的Id了。注意,APP必须绑定在产品上,才能使用。
        当你调用该方法,就能实现注册匿名用户,已经将用户/设备绑定的操作了。是不是很方便呢?当然,为了方便起见,你还可以进一步封装这个SDK。这里就不展开了。
机智云设备解绑
解绑操作也是类似的逻辑。当微信推送一条解绑事件消息,我们就会进行解绑操作。同样调用SDK:
Boolean isSuccess = OpenApi.unbindDevice(wechatOpenId, gizwitsAppId, gizwitsDid);
参数
类型
说明
wechatOpenId
String
微信中的OpenId,也就是机智云中注册的匿名用户
gizwitsAppId
String
机智云产品所绑定的APP的id
gizwitsDid
String
机智云中的设备ID,对应Mac,设备重置时会重新注册
设备的DeviceId
        上面方法的Did从哪里来?在我们调用绑定方法的时候,会返回一个DeviceInfo,该对象中就包含着Did。每次我们绑定后,我们可以将该did,mac,openid的关系保存到数据库中。
        但请注意,这里有个小小的问题:当设备重置的,同样一个mac地址,会重新注册一个Did。如果我们有将did和mac的关系保存在数据中,那么我们需要注意更新did。
获取OpenId的绑定列表
        想知道当前用户绑定了哪些设备?一个方法搞定:
List<DeviceInfo> deviceInfo = OpenApi.getBoundDevices(wechatOpenId, gizwitsAppId);
参数名
属性
说明
WechatOpenId
String
微信中的OpenId,也就是机智云中注册的匿名用户
gizwitsAppId
String
机智云产品所绑定的APP的id
获知设备的在线状态Boolean isOnline = OpenApi.getDeviceOnlineStatus(wechatOpenId, gizwitsAppId, gizwitsDid);
参数名
类型
说明
wechatOpenId
String
微信中的OpenId,也就是机智云中注册的匿名用户
gizwitsAppId
String
机智云产品所绑定的APP的id
gizwitsDid
String
机智云中的设备ID,对应Mac,设备重置时会重新注册

代码样例

        
        请注意,在服务器部署的时候,部分开发者会发现部署失败。tomcat中的catalina日志会报错:
javax.net.ssl.SSLException:java.security.ProviderException:java.security.KeyException
        这是因为SDK中采用了Https的方式进行访问。
        解决方法是:升级服务器环境中的库:nss。
微信页面操作设备
        好了,我们现在已经绑定了设备,并且也能知道设备的在线的状态了。但是具体如何操作我们的设备?一个良好的体验,当然是具有交互页面的。
        下面我们就一步步的搭建一个交互页面,来监控我们的设备吧!
获取OpenId
        用户点击页面,我们如何知道是哪个用户呢?我们需要获取当前用户的OpenId来识别时哪个用户。如何获取呢?详细可以看微信的官方文档
        简单的来说,我们向微信的服务器发送授权请求,微信会判断我们请求的URL,是否是授权的域名,如果验证通过,就会转发到我们的URL,并且带上几个参数。
        其中最重要的参数,是code,我们通过Code可以获取OpenId。然后,我们再将OpenId返回到页面中。
        
连接机智云的WebSocket
        对于访问机智云的WebSocket,我们已经封装成了一个JS-SDK。大家只需要引入到页面即可。
初始化gizwits服务
        首先是,构建一个gizwits服务:
        
        这个gizwits服务,会负责接下来所有的操作,包括:连接设备,读取设备的数据点,操作设备等。
参数名
类型
说明
ApiHost
String
websocket的目标API域名
CommType
String
协议格式:custom(自定义协议); attrs_v4(标准数据点协议)
wechatOpenId
String
当前访问的微信用户OpenId
GizwitsAppId
String
机智云产品所绑定的APP的id
        当然,此时gizwits服务,并没有运行起来,我们还需要初始化操作。但在操作之前,我们可以选择配置一个回调函数,它会在初始化结束后,自动运行。
        
        当执行gizwits.init()的时候,就会初始化gizwits服务,并且将匿名用户OpenId绑定的所有设备,放置在回调函数的devices中。
        而我们要做的操作,都应该写在回调函数gizwits.onInit里面。
        devices列表中的每个设备,都会有六个属性,分别是product_key(产品的Key), dev_alias(设备别名),did(设备ID),mac,is_online(在线状态), remark(设备备注)。我们可以根据情况来使用。
设备列表
        
        上面的操作中,我们已经获取到了设备列表。一般来说,客户可能拥有多个设备,因此,我们在这一步,就可以罗列一个设备列表,由用户自己决定,来操作哪台设备。
连接设备
        想要操作具体哪台设备,我们就去连接哪台设备:gizwits.connect(did)。当然连接成功后,也有一个回调函数:gizwits.onConnected。此回调函数没有传入值。
        注意,连接设备之前,必须先初始化。
        初始化和连接设备,并非同步操作,因此,如果只是简单的先后执行,可能会出错。因此,建议可以将连接设备的操作,放在初始化的回调函数中,保证执行的先后关系。
        连接成功后,我们就可以收到设备上报的数据了。上报的数据通过回调函数:gizwits.onReceivedAttrs。该回调函数会有一个回调值(参数),这个回调值的格式如下:
                        
        did是设备Id,attrs里面是产品所有的数据点。
        如果一开始,gizwits初始化的commType是 custom,那么设备的上报数据,就会使用回调函数gizwits.onReceivedRaw,而不是 gizwits.onReceivedAttrs。
        
手动读取:设备数据点
        获取设备的数据点,也很简单,只需调用gizwits.read()方法,不需要任何参数。调用此方法,可以马上获取一次,同样,数据也是通过回调函数 gizwits.onReceivedAttrs,或者gizwits.onReceivedRaw来获取。
连接错误
        当websocket连接错误时,会调用gizwits.onError函数,如有需要,可以重写该函数;回调值是错误信息:
gizwits.onError = function(value){    console.log("error!!!!:::::", value.toString());}设备上下线
        当设备发生上线,或者下线的事件时,gizwits服务,会调用gizwits.onOnlineStatusChanged 回调函数.
        回调值有两个参数:did和在线状态(is_online)。
gizwits.onOnlineStatusChanged = function(value) {    alert("设备上下线通知,did=", value.did);    alert("设备上下线通知,is_online=", value.is_online);}
控制设备
        最后是,设备的远程控制。
        远程控制的调用方法,如果commType=custom,则使用gizwitsws.send(command)方法,如果commType=attrs_v4,则使用gizwitsws.write(command)方法。
        远程控制的值,如果commType=custom,请输入p0,例如[<byte>,<byte>,<byte>...];如果commType=attrs_v4,请输入datapoints,例如{"power":true}。
        下面是远程控制RBG灯的代码样例:
var command = '{"LED_R": 0, "LED_G": 0, "LED_B": 0}';gizwits.write(did, JSON.parse(command));
        当然,使用控制设备的前提是,我们已经连接上了一台设备。
结语
        至此,我们已经实现了微信接入的核心部分。在此教程中,Java-SDK与js-SDK为我们带来了很大的,我们几乎不用关心如何调用机智云的API和websocket,而是直接调用SDK的方法就可以了。
        最后,希望大家能多多反馈意见,为更加便捷的开发贡献一份力量。


附件:SDK包.zip • 389.83KB • 下载


34

主题

896

帖子

2274

积分

超级版主

Rank: 8Rank: 8

积分
2274
 楼主| 发表于 2016-8-8 12:08:56 | 显示全部楼层
FAQ
机智云Web Socket API服务是什么?
机智云Web Socket API服务是为了满足基于Html5应用如微信公众号这种应用远程控制设备,实时展现设备状态而开发的一套API接口。Web Socket API主要是为了弥补HTTP协议短连接的不足,能够实时将设备数据传输到网页并展现。
WEB socket协议与HTTP有什么区别?
HTTP协议是由客户端主动向服务端发起单向通信,是短连接。
Web Socket是长连接双向通信,服务端与客户端都可主动发送数据。
如果未成功绑定设备,是否可以调用web socket api提供的控制设备指令?
未成功绑定设备,不能成功调用控制设备的指令。
在使用设备控制api与服务端通讯,采用什么编码?
采用utf8编码。数据点中枚举值为非ASCII的字符明确需要以Unicode编码。
设备控制api协议中的参数详细描述有吗?
did:目标设备的did。attr:属性值。raw:自定义内容。
did是open api 注册设备的返回结果。
attr的值需要结合数据点的定义。
raw的值需要结合p0协议的定义。
websocket只是m2m客户端的一种存在形式。因此与open api的结合如同用户或设备与open api中定义的参数是一样的,可在Open api获取参数的详细意义。
Web socket api提供SSL的通讯支持吗?
支持。

3

主题

23

帖子

139

积分

注册会员

Rank: 2

积分
139
发表于 2016-8-22 22:07:55 | 显示全部楼层
注册成为机智云开发者,手机加虚拟设备快速开发
讲解很详细,采纳了,明天操作一下,学学

3

主题

253

帖子

432

积分

中级会员

Rank: 3Rank: 3

积分
432
发表于 2016-8-25 16:55:50 | 显示全部楼层
楼主的说明很详细,点赞

7

主题

26

帖子

222

积分

中级会员

Rank: 3Rank: 3

积分
222
发表于 2016-10-17 23:37:06 | 显示全部楼层
如果机智云接入微信硬件的话,微信用户可以绑定同一类产品下的多个设备吗?微信平台允许吗?急~

7

主题

26

帖子

222

积分

中级会员

Rank: 3Rank: 3

积分
222
发表于 2016-10-18 18:50:22 | 显示全部楼层
楼主,如果我是绑定了多个WiFi设备,有些设备在线,有些离线,公众号下面的设备状态显示是怎样的?怎么显示?

2

主题

31

帖子

246

积分

中级会员

Rank: 3Rank: 3

积分
246
QQ
发表于 2016-12-13 15:56:04 | 显示全部楼层
微信开发要学HTML5吗?

6

主题

27

帖子

234

积分

中级会员

Rank: 3Rank: 3

积分
234
发表于 2017-2-1 01:36:39 来自手机 | 显示全部楼层
教您5分钟接入机智云,实现傻瓜式开发
出套视频教程就好了

6

主题

27

帖子

234

积分

中级会员

Rank: 3Rank: 3

积分
234
发表于 2017-2-1 01:38:26 来自手机 | 显示全部楼层
机智云借力微信平台,是个战略性举措!

0

主题

5

帖子

167

积分

注册会员

Rank: 2

积分
167
发表于 2017-3-14 23:37:25 | 显示全部楼层
需要搭建自己的服务器吗?

34

主题

896

帖子

2274

积分

超级版主

Rank: 8Rank: 8

积分
2274
 楼主| 发表于 2017-3-16 10:11:56 | 显示全部楼层
niceSimon 发表于 2017-3-14 23:37
需要搭建自己的服务器吗?

是的。必须要有的

0

主题

1

帖子

5

积分

新手上路

Rank: 1

积分
5
发表于 2017-3-24 17:56:05 | 显示全部楼层
boboP 发表于 2017-3-16 10:11
是的。必须要有的

必须要有啊,貌似yeelink不用,但是体验不太好
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

加入Q群 返回顶部

版权与免责声明 © 2006-2024 Gizwits IoT Technology Co., Ltd. ( 粤ICP备11090211号 )

快速回复 返回顶部 返回列表