更新时间:2024-06-14 GMT+08:00
分享

AppClient方法说明

ModuleSDK中,客户端类AppClient提供多个方法供客户开发应用时使用,使用时可参考每个函数的功能定义。

表1 AppClient方法说明

接口

说明

createFromEnv

根据环境变量创建客户端,相关配置参数从环境变量获取。

setBusMessageCallback

设置消息总线回调,用于对设备上报的数据进行处理。

sendBusMessage

向总线发送设备数据,用于将处理后的设备数据发送到总线。

callDeviceCommand

调用设备命令。

getDevicesStatus

查询设备状态。

getDevicesInfos

查询子设备列表。

getDeviceProperties

获取设备属性。

setCustomizedMessageCallback

设置自定义消息回调,用于对自定义数据进行处理。

sendCustomizedMessage

向总线发送自定义消息。

AppClient::createFromEnv

根据环境变量创建客户端,相关配置参数从环境变量获取。

函数描述

public static AppClient createFromEnv()throws GeneraException

AppClient::setBusMessageCallback

设置总线消息回调,用于对设备上报的数据进行处理。

函数描述

public void setBusMessageCallback(String inputName,BusMessageCallback callback)throws java.lang.IllegalArgumentException
表2 参数说明

参数名称

类型

参数描述

inputName

String

模块输入点

callback

BusMessageCallback

回调类实例

表3 BusMessageCallback需要实现的回调接口

回调接口

参数描述

void onMessageReceived(BusMessage busMessage)

收到来自消息总线的设备上报数据回调

AppClient::sendBusMessage

向总线发送消息,用于将处理后的设备数据发送到总线。

函数描述

public void sendBusMessage(String outputName,BusMessage message)throws java.lang.IllegalArgumentException,JsonException
表4 参数说明

参数名称

类型

参数描述

outputName

String

模块输出点

message

BusMessage

设备数据

AppClient::getDevicesStatus

查询设备状态。

函数描述

public List<DeviceStatus> getDevicesStatus(String[] deviceIds,int timeout)throws GeneraException
表5 参数说明

参数名称

类型

参数描述

deviceIds

String[]

设备ID数组

timeout

int

等待超时毫秒数

AppClient::getDevicesInfos

查询子设备列表。

函数描述

public List<EdgeDeviceInfo> getDevicesInfos()throws GeneraException
表6 参数说明

参数名称

类型

参数描述

deviceIds

String[]

设备ID数组。

timeout

int

等待超时毫秒数

AppClient::setCustomizedMessageCallback

设置自定义消息回调,用于从消息总线中接收自定义消息。

函数描述

public void setCustomizedMessageCallback(CustomizedMessageCallback callback)
表7 参数说明

参数名称

类型

参数描述

callback

CustomizedMessageCallback

回调类实例

表8 CustomizedMessageCallback需要实现的回调接口

回调接口

参数描述

void onMessageReceived(BusMessage busMessage)

收到来自消息总线的设备上报数据回调

AppClient::sendCustomizedMessage

向总线发送自定义消息

函数描述

public void sendCustomizedMessage(java.lang.String topic,String payload)
表9 参数说明

参数名称

类型

参数描述

topic

String

自定义消息的目标topic

payload

String

自定义消息

相关文档