作者:阿里云MVP洵云
13节回顾:手把手学IOT服务端API编程[13、发布消息到Topic]
14节回顾:手把手学IOT服务端API编程[14、发消息给设备并同步返回响应]
15节回顾:手把手学IOT服务端API编程[15、发布广播消息]
16节回顾:手把手学IOT服务端API编程[16、查询设备影子]
上节介绍从服务端查询设备影子消息后,实际使用过程中,常常需要根据网络的状态情况,进行相应更新设备的影子,服务端的API接口也提供了相应的功能,
这一节就来介绍一下如何更新设备影子这个功能,这个接口需要提供两个参数,一个是产品的key值,一个是设备名称;
接下来我们看一下具体实现;
1、脚本实现:
我们按照接口的要求,在框架页面上,提供产品的key值和设备名称和需要更新的设备影子,这三个输入参数框给用户输入,
产品KEY: <input type="text" name="pkey17">
设备名称: <input type="text" name="devname17">
影子信息: <input type="text" name="shadowmsg17">
而在实际的实现代码中,我们只需要使用get函数提取这个变量就可以了:
$pkey = $_GET["pkey17"];
$devname = $_GET["devname17"];
$shadowmsg = $_GET["shadowmsg17"];;
接着引用查询设备列表的接口:
$request = new Iot\UpdateDeviceShadowRequest();
通过查看UpdateDeviceShadowRequest文件,可以知道我们需要调用setProductKey和setDeviceName 及setShadowMessage 这三个函数,来从服务端传送更新设备影子的信息;这三个参数的意思分别是配置产品key,配置设备名称,配置需要更新的设备影子信息.
其中影子信息是一个json的格式字符串,其中method的值需要为update;
$request->setProductKey($pkey);
// {"method":"update","state":{"reported":{},"desired":{"window":"open"}},"metadata":{"reported":{}},"timestamp":1511860984,"version":9}
$request->setDeviceName($devname);
$request->setShadowMessage($shadowmsg);
调用通用的网络查询操作后,将操作是否成功的返回结果显示在网页上:
echo 'RequestId :'.$response->RequestId.'<br>';
echo 'Success :'.$response->Success.'<hr>';
2、实际测试:
打开浏览器,转到我们框架脚本页面,这里输入我们从控制台得到的产品key值和设备名称以及最新的设备影子信息,运行提交按钮后,然后转到控制台页面,查看相关的影子信息,可以看到已经被更新到最新的了:
具体向关截图如下:
timelapse:
http://www.xunyun17.xyz/ioto/step17-UpdateDeviceShadowRequest.mp4