作者:阿里云MVP洵云
10节回顾:手把手学IOT服务端API编程[10、保存设备属性]|MVP讲堂
11节回顾:手把手学IOT服务端API编程[11、查询设备属性列表]
12节回顾:手把手学IOT服务端API编程[12、删除设备属性]
13节回顾:手把手学IOT服务端API编程[13、发布消息到Topic]
14节回顾:手把手学IOT服务端API编程[14、发消息给设备并同步返回响应]
下节链接:手把手学IOT服务端API编程[16、查询设备影子]|MVP讲堂
上节介绍从服务端给设备发送RRPC消息后,实际使用过程中,如果设备众多,服务端通常希望发送一条消息通知所有的设备,而不是一个一个设备发送消息,这种消息也叫做发送广播消息,服务端的API接口也提供了相应的功能,
这一节就来介绍一下如何使用发送广播消息这个功能,这个接口同样需要提供三个参数,一个是产品的key值,一个是消息名称以及消息内容;
接下来我们看一下具体实现;
1、脚本实现:
我们按照接口的要求,在框架页面上,提供产品的key值和设备名称以及消息内容,这三个输入参数框给用户输入,
产品KEY: <input type="text" name="pkey15">
Topic名称: <input type="text" name="topicname15">
消息内容: <input type="text" name="msgcontent15">
而在实际的实现代码中,我们只需要使用get函数提取这个变量就可以了:
$pkey = $_GET["pkey15"];
$topicname = $_GET["topicname15"];
$msgcontent = $_GET["msgcontent15"];
接着引用查询设备列表的接口:
$request = new Iot\PubBroadcastRequest();
通过查看PubBroadcastRequest文件,可以知道我们需要调用setProductKey和setTopicFullName以及setMessageContent 三个函数,来从服务端传送广播信息;这三个参数的意思分别是配置产品key,配置消息名称和配置消息内容.
$request->setProductKey($pkey);
$request->setTopicFullName($topicname);
$request->setMessageContent(base64_encode($msgcontent));
调用通用的网络查询操作后,将操作的返回结果显示在网页上:
echo 'RequestId :'.$response->RequestId.'<br>';
echo 'Success :'.$response->Success.'<hr>';
2、设备端模拟:
和上一节给设备发送信息类似,这一节也需要设备的模拟,下载开发包的命令和上节类似,这里只介绍修改发送消息例子的部分:
2.1 修改mqtt_rrpc-example.c文件,改为广播类型的消息名称和消息内容:
vi iotkit-embedded-master/iotkit-embedded-master/sample/mqtt/mqtt_rrpc-example.c
2.2 修改后,保存退出,重新编译源码;
cd iotkit-embedded-master/iotkit-embedded-master/
make clean
sudo make all
2.3 编译结束后,运行编译后的例子文件:
output/release/bin/mqtt_rrpc-example
3、实际测试:
先运行模拟设备,然后打开浏览器,转到我们框架脚本页面,这里输入我们从控制台得到的产品key值和要发送的广播消息名称以及消息内容,运行提交按钮后,可以得到是否发送成功的信息,然后到设备模拟终端,查看状态,可以看到已经接受到服务端发来的广播信息:
具体向关截图如下:
timelapse:
http://www.xunyun17.xyz/ioto/step15-PubBroadcastRequest.mp4