手把手学IOT服务端API编程[16、查询设备影子][step by step ALI-IOT-SERVER-API]

上节介绍从服务端给设备发送广播消息后,实际使用过程中，往往存在网络信号不好,质量不稳定的状况,这时就需要服务端保存一份设备端最后一次状态的信息,用来做后续的相关分析,这份信息又被称为设备影子,服务端的API接口也提供了相应的功能，
这一节就来介绍一下如何使用设备影子这个功能，这个接口需要提供两个参数，一个是产品的key值，一个是设备名称;
接下来我们看一下具体实现；


1、脚本实现：
我们按照接口的要求，在框架页面上，提供产品的key值和设备名称，这两个输入参数框给用户输入，
产品KEY:        <input type="text" name="pkey16">
设备名称:        <input type="text" name="devname16">


而在实际的实现代码中，我们只需要使用get函数提取这个变量就可以了：
$pkey = $_GET["pkey16"];
$devname = $_GET["devname16"];


接着引用查询设备列表的接口：
$request = new Iot\GetDeviceShadowRequest();


通过查看GetDeviceShadowRequest文件，可以知道我们需要调用setProductKey和setDeviceName 两个函数，来从服务端传送查询设备影子的信息;这两个参数的意思分别是配置产品key,配置设备名称.


$request->setProductKey($pkey);


$request->setDeviceName($devname);


调用通用的网络查询操作后，将操作的返回结果和影子信息显示在网页上:


echo 'ShadowMessage ：'.$response->ShadowMessage.'<br>';
echo 'RequestId ：'.$response->RequestId.'<br>';
echo 'Success ：'.$response->Success.'<hr>';


2、设备端模拟：
默认设备初始状态是不存在设备影子的,由于只有设备有上线记录后,这一节也需要设备的模拟,下载开发包的命令和上节类似,这里只介绍发送设备消息例子的部分：
2.1 修改shadow-example.c文件,改为我们自己的设备名称:
vi iotkit-embedded-master/iotkit-embedded-master/sample/device-shadow/shadow-example.c
2.2 修改后,保存退出,重新编译源码；
cd iotkit-embedded-master/iotkit-embedded-master/
make clean
sudo make all
2.3 编译结束后，运行编译后的例子文件：
output/release/bin/shadow-example


        
3、实际测试：
先运行模拟设备,然后打开浏览器，转到我们框架脚本页面，这里输入我们从控制台得到的产品key值和设备名称，运行提交按钮后，可以得到要查询的设备影子信息：
具体向关截图如下：




附件：


timelapse:
http://www.xunyun17.xyz/ioto/step16-GetDeviceShadowRequest.mp4