21ic电子技术开发论坛 › 单片机与嵌入式系统 › 新唐MCU › 微信硬件平台
返回列表 发新帖我要提问

[应用方案] 微信硬件平台

[复制链接]
1690|11
 楼主| Roderman_z 发表于 2016-11-25 19:46 | 显示全部楼层 |阅读模式
硬件平台, 微信, API, pi, sd
调用openApi微信硬件平台是微信推出连接物与人，物与物的IOT解决方案。也就是说可以通过微信控制各种智能设备。比如一些蓝牙设备、空调、电视等等。

我本身不懂硬件(虽然是电子信息专业)，硬件是北航的两个研究生在弄，小团队里我负责开发H5自定义面板，刚开始看官方文档各种迷糊，对于jssdk、jsapi、Airkiss、openApi、直连SDK都不知道该用哪个做，官方论坛问问题基本上没结果，加了几个微信硬件群问问题，发现好些开发者和我一样，同一个问题，发到几个群里问，画面好心酸。给wxthings发邮件问，能回复就不错了，往往还是只言片语。吐槽了这么多，还是得去解决问题，毕竟设备能搭上微信是一大卖点，最近摸索出来一些东西，于是有了此文。
一、接入流程
也就是说，首先你得有一个公众号，然后开通设备功能、添加产品(也就是你的智能设备)。这些过程官方文档比较清楚，我就不讲了。接入方案我们选择的是微信硬件云标准接入方案。
设置面板而我要说的H5面板开发，指的就是在微信中打开的一个H5控制页面，它如何和微信硬件云通信，如何读取和设置设备的状态。在添加产品的过程中有一栏设置面板

如果选择标准面板，微信官方给出了三类标准面板：



回复

收藏 举报

相关帖子
 楼主| Roderman_z 发表于 2016-11-25 19:46 | 显示全部楼层
分别是空调、开关和灯，如果是自定义，则输入地址即可。如果是标准面板，你是不需要服务器，但如果是自定义的面板，你就需要有自己的服务器，不然你无法处理微信云发过来的消息。
启用服务器配置在设置服务器地址的时候要注意，你必须按照它要求方式处理响应了，你才能启用成功。

你点击启用的时候，微信云会发过来一个签名、一个时间戳、一个随机数和一个随机字符串，验证之后，返回那个随机字符串，微信云收到你返回的随机字符串了，就能启用成功。比如，如果你定义的地址是http://www.xxx.com/device/ReceiveWXMsg,那么先把代码上传服务器，然后再点击启用，微信云会向这个地址post数据。
View Code
直接返回就行，不要加个json什么的。这个地址是干嘛的呢，往下看。
二、通信方式
Wifi设备和蓝牙设备是不同的，蓝牙使用Airsync协议和微信通信，而wifi设备的话，我们在自己的服务器上调用微信提供的openApi获取或设置设备状态，微信服务器就会把数据以json格式post到我们上面设置的那个地址。硬件方面wifi设备可以使用微信提供的直连SDK来控制设备。

回复

收藏 举报

 楼主| Roderman_z 发表于 2016-11-25 19:47 | 显示全部楼层
添加完设备，设置好服务器，你还需要硬件的同学打开设备，帮定你的微信。从微信的设置-->设备-->选择设备-->打开面板。你就可以看到设备并进行控制了。

三、调用openApi说了这么多前提工作，终于进入调用api环节。可以先看一下openApi的官方文档：http://iot.weixin.qq.com/wiki/doc/hardwarecloud/openapi.pdf
文档里面主要讲了三个方法，一个是查询设备状态，一个是设置设备状态，一个是接受设备状态变化的消息，然后是一些错误信息等。但观察api就会发现我们还需要两个重要的参数，一个是access_token，一个是用户的openid。还说明一点，网页是Asp.net mvc。

回复

收藏 举报

 楼主| Roderman_z 发表于 2016-11-25 19:48 | 显示全部楼层
1.获取access_token官方有一个接口调试页面：http://mp.weixin.qq.com/debug/ ，获取access_token需要appid和secret。

而这两个值，是在公众号后台的基本配置中查看，secret是个很重要的参数，所以请保密好。

查看密钥还需要扫二维码得到管理员的确认...  拿到这两个参数了，我们就可以生成token了。注意返回的json是一个token字符串再加一个超时时间。定义一个TokenResult：
public class TokenResult    {        public string access_token { get; set; }        public int expires_in { get; set; }    }
要注意的一点是，token两小时后会过期。所以在我们的代码里面需要检查是否超时，然后自动重新获取。
public const string AccessTokenUrl = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid={0}&secret={1}";
getAccessToken方法定义在一个服务类中，比如WxDeviceService


using SendHelp= Senparc.Weixin.CommonAPIs.CommonJsonSend;public TokenResult GetAccessToken()        {            var url = string.Format(WxDeviceConfig.AccessTokenUrl, WxDeviceConfig.AppId, WxDeviceConfig.APPSECRET);            var res = SendHelp.Send<TokenResult>(null, url, null, CommonJsonSendType.GET);            return res;        }


使用Senparc.Weixin框架封装好的api来处理请求。

回复

收藏 举报

 楼主| Roderman_z 发表于 2016-11-25 19:49 | 显示全部楼层
2.获取openid这个参数在查询和设置设备状态的时候会用到，对应user参数名。获取openid需要三个参数，access_token已经有了，然后需要device_type和device_id
public const string GetOpenid ="https://api.weixin.qq.com/device/get_openid?access_token={0}&device_type={1}&device_id={2}";
而type和id是前端页面传过来的，当用户微信中打开控制面板的时候，微信会自动将这两个参数追加到url后面。而这个url的返回值结构是这样：
{"open_id":["oxa1otw5sk-Azgd8mx1bmBqoM2_E","oxa1ot8-j9j5bYUJJyAexe9d41_Y","oxa1ot5QTdxn0xNQ0DmYzoN0tUp1"],"resp_msg":{"ret_code":0,"error_info":"ok"}}
openid部分是一个数组，实际使用的是第三个(我目前也不知道前面两个id是干啥的)，定义一个openidResult：
复制
  1. public class OpenIdResult
    

  2.     {
    

  3.         private List<string> _openId;
    


  4. 

  5.         public List<string> open_id
    

  6.         {
    

  7.             get { return _openId??(_openId=new List<string>()); }
    

  8.             set { _openId = value; }
    

  9.         }
    


  10. 

  11.         public resp_msg resp_msg { get; set; }
    


  12. 

  13.         public string GetOpenId()
    

  14.         {
    

  15.             if (open_id!=null&&open_id.Count==3)
    

  16.             {
    

  17.                 return open_id[2];
    

  18.             }
    

  19.             return "";
    

  20.         }
    

  21.     }
service中：
复制
  1. public string GetOpenId(string accessToken,string deviceType,string deviceId)
    

  2.         {
    

  3.                 var url = string.Format(WxDeviceConfig.GetOpenid, accessToken, deviceType, deviceId);
    

  4.                 var res = SendHelp.Send<OpenIdResult>(accessToken, url, null, CommonJsonSendType.GET);
    

  5.                 return res.GetOpenId();
    

  6.         }


回复

收藏 举报

 楼主| Roderman_z 发表于 2016-11-25 19:50 | 显示全部楼层
如果你的devicetype和deviceId错误，微信会返回一个不太恰当的错误json：

对比错误代码列表，我开始以为微信服务器出错了。其实是我参数填错了。

遇到的错误，将不止官方文档公布的这几个。
3.查询设备状态查询设备和上面的这两个方法略有不同，因为流程是这的，我们的服务器先像向微信服务器请求，微信接受到请求后马上返回一个确认json，然后微信服务器会马上把数据post我们前面设置的那个地址上。
请求url：
复制
  1.   public const string GetDeviceStatusUrl="https://api.weixin.qq.com/hardware/mydevice/platform/get_device_status?access_token={0}";


回复

收藏 举报

 楼主| Roderman_z 发表于 2016-11-25 19:50 | 显示全部楼层
从官方文档可以看到，查询设备还需要另外一个重要的参数，它包含device_type和device_id,services,user,data。

需要说明一下的就是services，意思是指设备的能力项，也就是你要查询设备的哪些属性，这个在设置设备的时候一样用到。完成的产品能力定义请看：http://iot.weixin.qq.com/wiki/doc/intro/%E4%BA%A7%E5%93%81%E8%83%BD%E5%8A%9B%E5%AE%9A%E4%B9%89%E6%8C%87%E5%BC%95%20V1.2.pdf
因此定义一个RequestData对象以及设备对应的能力项
复制
  1. public class RequestData
    

  2.     {
    

  3.         public string device_type { get; set; }
    

  4.         public string device_id { get; set; }
    

  5.         public string user { get; set; }
    

  6.         public Service services { get; set; }
    

  7.         public object data { get; set; }
    

  8.     }
复制
  1.  public class Service
    

  2.     {
    

  3.         public lightbulb lightbulb { get; set; }
    


  4. 

  5.         public air_conditioner air_conditioner { get; set; }
    


  6. 

  7.         public power_switch power_switch { get; set; }
    


  8. 

  9.         public operation_status operation_status { get; set; }
    

  10.     }


回复

收藏 举报

 楼主| Roderman_z 发表于 2016-11-25 19:52 | 显示全部楼层
service包括两个部分，一个是能力部分，好比上面这个service，就包含了三种能力，灯、空调以及开关(这只是测试，不是真正产品的能力)。和一个操作状态。操作状态就是指这个设备是否开着或者关闭了。而每一个能力，又包括两部分，拿灯来说：
复制
  1. public class lightbulb
    

  2.     {
    

  3.         public int alpha { get; set; }
    

  4.         public lightbulb_value_range value_range { get; set; }
    

  5.     }
    


  6. 

  7.     public class lightbulb_value_range
    

  8.     {
    

  9.         public string alpha { get; set; }
    

  10.     }
复制
  1. 灯有一个亮度值，和一个范围属性。范围值中包含了最大和最小值以及单位值。
    

  2. <span id="Label3"><pre>"lightbulb":{"alpha":10,"value_range":{"alpha":"0|100|1"}},"</pre></span>
这表示灯的亮度是10，返回是0到100，每次可以调节1个单位。
发送查询请求后，微信返回一个json，定义对象为下：
复制
  1. public class OpenApiResult
    

  2.     {
    

  3.         public int error_code { get; set; }
    

  4.         public string error_msg { get; set; }
    


  5. 

  6.         public string msg_id { get; set; }
    

  7.     }
WxDeviceService中：
复制
  1. public OpenApiResult RequestDeviceStatus(string accessToken, RequestData data)
    

  2.         {
    

  3.             var url = string.Format(WxDeviceConfig.GetDeviceStatusUrl, accessToken);
    

  4.             return SendHelp.Send<OpenApiResult>(accessToken, url, data);
    

  5.         }


回复

收藏 举报

 楼主| Roderman_z 发表于 2016-11-25 19:53 | 显示全部楼层
4.接受消息那么问题来了，如何接受post过来的数据，以及如何存储呢。微信post的数据格式如下：

定义了一个WxResponseData对象：
View Code
msg_type代表着不同类型的消息， notify 说明是设备变更，set_resp 说明是设置设备 get_resp 说明获取设备信息。在WxDeviceService中增加GetDeviceStatus方法：
复制
  1.  public T GetWxResponse<T>(HttpRequestBase request)
    

  2.         {
    

  3.             Stream postData = request.InputStream;
    

  4.             StreamReader sRead = new StreamReader(postData);
    

  5.             string postContent = sRead.ReadToEnd();
    

  6.             if (!string.IsNullOrEmpty(postContent))
    

  7.             {
    

  8.                 Logger.Debug("收到数据:"+postContent);
    

  9.             }
    

  10.             try
    

  11.             {
    

  12.                 return JsonConvert.DeserializeObject<T>(postContent);
    

  13.             }
    

  14.             catch (Exception e)
    

  15.             {
    

  16.                 Logger.Debug(e.Message);
    

  17.                 throw;
    

  18.             }
    

  19.         }
    


  20. 

  21.         public WxResponseData GetDeviceStatus(HttpRequestBase request)
    

  22.         {
    

  23.             return GetWxResponse<WxResponseData>(request);
    

  24.         }


回复

收藏 举报

 楼主| Roderman_z 发表于 2016-11-25 19:54 | 显示全部楼层
需要先读取请求中的json字符串然后转换成C#对象。然后在最初启用的ReceiveWXMsg方法中随时准备接受消息：
复制
  1. public string ReceiveWXMsg()
    

  2.         {
    

  3.             var signature = Request.QueryString["signature"];
    

  4.             var timestamp = Request.QueryString["timestamp"];
    

  5.             var echostr = Request.QueryString["echostr"];
    

  6.             var nonce = Request.QueryString["nonce"];
    

  7.             Logger.Debug("signature:" + signature);
    

  8.             Logger.Debug("timestamp:" + timestamp);
    

  9.             Logger.Debug("nonce:" + nonce);
    

  10.             Logger.Debug("echostr:" + echostr);
    

  11.             try
    

  12.             {
    

  13.                 var userdata = getUserWxData();
    

  14.                 var data = wxDeviceService.GetDeviceStatus(Request);
    

  15.                 userdata.ResponseData = data;
    

  16.                 setUserWxData(userdata);
    

  17.             }
    

  18.             catch (Exception e)
    

  19.             {
    

  20.                 Logger.Debug(e.Message);
    

  21.             }
    

  22.             return echostr;
    

  23.         }
5.设置设备状态有了前面几步，这里也好说了。url:
复制
  1. public const string SetDeviceUrl ="https://api.weixin.qq.com/hardware/mydevice/platform/ctrl_device?access_token={0}";
复制
  1. 设置设备的参数和请求是一样的，
    

  2. 技术分享 View Code
    


  3. 

  4. 调用openApi基本上就这样了，如有不完善的地方还请指正。
    

  5. 四、常见错误
    


  6. 

  7.  技术分享
    


  8. 

  9. 如果硬件通信没有开启这个能力，去查询的会报这个错误。
    


  10. 

  11. 技术分享
    


  12. 

  13. 刚开始看到"device not login"实在没明白什么意思，文档里也没说明这个错误。设备还需要什么登录？原来是硬件同学没有连接设备... ORZ
    


  14. 

  15. 技术分享
    


  16. 

  17. 如果你的requestData结构不对，特别是附加的那个Data参数只能是字符串，不要写成空对象{}，就会出现这个错误。
    


  18. 

  19. 技术分享
    


  20. 

  21. token超时
    


  22. 

  23. 技术分享
    


  24. 

  25. 同一个设备同时被操作。
    


  26. 

  27. 小结：以上是硬件面板开发过程中遇到的种种“经验”总结。限于篇幅这一节只讲了openapi的调用。下一节将如何用seajs构建h5控制面板。敬请关注！


回复

收藏 举报

huangcunxiake 发表于 2016-11-26 23:43 | 显示全部楼层
service包括两个部分，一个是能力部分，好比上面这个service，就包含了三种能力，灯、空调以及开关(这只是测试，不是真正产品的能力)。和一个操作状态。
回复

收藏 举报

quray1985 发表于 2016-12-4 16:55 | 显示全部楼层
有没有关于如何创建H5面板的讲解啊
回复

收藏 举报

返回列表 发新帖
高级模式
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 | 注册

本版积分规则

Roderman_z

41

主题

354

帖子

2

粉丝
快速回复 在线客服 返回列表 返回顶部