title: 实战教程
在网络飞速发展的今天,设备已经遍布各处,它们之间的通信极其重要。设备通信中最重要的是同步和更新的实时性。以物联网为例,传感器采集的数据需要实时同步到用户 APP ,以及控制中心;同时用户的操作和控制指令,也需要实时更新到设备中。
本部分展示了借助 Wilddog C/嵌入式 SDK 实现一个简单的远程加法器的示例。在示例中有两个端(或抽象成设备),即网页端和客户端。在控制台网页上输入两个值,这两个值能够被实时同步到客户端。当客户端收到这两个值后,将这两个值的和计算出来,并同步到网页端。抽象到物联网设备上,网页端可以类比成用户 APP,客户端可以类比成嵌入式设备。用户 APP 发送控制命令给嵌入式设备,设备执行操作后并将结果实时反馈回用户 APP。
示例说明
远程加法器示例的最终的效果如下:

在这种多端交互的应用,即使是在嵌入式中,借助 Wilddog C/嵌入式 SDK,只需要百余行代码即可实现,足见 Wilddog 在实时领域的简单与强大。
具体步骤
引入 Wilddog Sync C/嵌入式 SDK
从 github 中下载 Sync C/嵌入式 SDK 。
为简便起见,我们直接使用 SDK 的编译框架。以 Linux 为例,我们在 examples/linux 目录下新建一个 C 文件 remote-cal.c ,然后开始编写远程加法器示例。
建立 Wilddog Sync 引用
初始化一个 Wilddog Sync 会话,该会话连接到 DEMO_YOUR_URL 。
Wilddog_T wilddog = wilddog_initWithUrl((Wilddog_Str_T*)DEMO_YOUR_URL);
监听输入
监听加数和被加数对应的父节点,一旦加数和被加数被修改时,客户端会收到推送。 注意我们监听的是操作数的父节点,收到的推送如下 ‘“/“:{“sum”:0, “augend”:0, “addend”:0}’。
wilddog_addObserver(wilddog,WD_ET_VALUECHANGE,(onEventFunc)addObserver_callback,(void*)wilddog);
网页端的数据结构如下:

获取输入
客户端接收到的数据节点加数 append、被加数augend和结果sum位于同一层级,是通过双向链表组织起来,可以遍历这个链表获取对应的节点.
/* get node pointer according the key value */STATIC Wilddog_Node_T *node_get(Wilddog_Node_T *p_head,const char* key_name){Wilddog_Node_T *node = p_head;u8 len = 0;while(node ){if( node->p_wn_key ){/* get the short len*/len = strlen((const char*)key_name)>strlen((const char*)node->p_wn_key)\?strlen((const char*)node->p_wn_key):strlen((const char*)key_name);if( !memcmp(key_name,node->p_wn_key,len))return node;}node=node->p_wn_next;if(node == p_head)return NULL;}return NULL;}
利用wilddog_node_getValue() 方法获取它们的 value ,如下 :
Wilddog_Node_T *p_augend = node_get(p_node,"augend");Wilddog_Node_T *p_addend = node_get(p_node,"append");Wilddog_Node_T *p_sum = node_get(p_node,"sum");s32 augend = *(s32*)wilddog_node_getValue(p_augend,&len);s32 addend = *(s32*)wilddog_node_getValue(p_addend,&len);
推送计算结果到服务端
通过 wilddog_node_setValue() 方法设置sum节点对应的 value ,并调用 wilddog_setValue 把数据推送到服务端。
s32 sum = augend + addend;wilddog_node_setValue(p_sum,(u8*)&sum,sizeof(sum));wilddog_setValue(wilddog,(Wilddog_Node_T*)p_newdata,sumSet_callback,NULL);
获取示例源码
点此获取完整的示例源码。
