文档首页> 设备管理 IoTDM（联通用户专用）> API参考> Agent Lite API参考(C)> 接口列表> 设备命令接收
更新时间：2022-02-24 GMT+08:00
查看PDF

设备命令接收

接口功能

注册设备命令接收广播来接收处理平台下发的控制命令。

接口描述

1
 
IOTA_TOPIC_SERVICE_COMMAND_RECEIVE/{deviceId};

参数说明

请参考EN_IOTA_DATATRANS_IE_TYPE消息信元枚举说明

返回结果

无

示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
 
// 开发者注册该函数进行命令接收的处理 
HW_iNT Switch_CommandRecvtHandler(HW_UiNT uiCookie, HW_MSG pstMsg) 
{
    HW_cHAR *pcMethod, *pcServiceId, *pcCmdContent, *pcDeviceId;
    pcDeviceId = HW_MsgGetStr(pstMsg, EN_IOTA_DATATRANS_IE_DEVICEID);
    pcServiceId = HW_MsgGetStr(pstMsg, EN_IOTA_DATATRANS_IE_SERVICEID);
    pcMethod = HW_MsgGetStr(pstMsg, EN_IOTA_DATATRANS_IE_METHOD);
    pcCmdContent = HW_MsgGetStr(pstMsg, EN_IOTA_DATATRANS_IE_CMDCONTENT);
    if (strcmp(pcServiceId, “switch”)) 
    {
        //根据Proflie定义的命令参数，使用Json组件解析pcCmdContent 
        //Send command to Switch
    }
    return 0;
}
//在设备添加成功后立即注册设备命令接收广播 
HW_BroadCastReg(“IOTA_TOPIC_SERVICE_CMD_RECEIVE/XXXX_XXXX_XXXX_XXXX”, 
Device_AddResultHandler);

开发者需要在设备添加成功后注册该设备的命令接收广播，广播主题为 “IOTA_TOPIC_SERVICE_CMD_RECEIVE/设备ID”，Agent Lite收到平台发往给设备的命令后会直接广播给该设备注册的广播处理函数。如果开发者不需要按设备进行分发，直接使用主题名即可，即“ IOTA_TOPIC_SERVICE_CMD_RECEIVE”。

父主题： 接口列表