Java SDK 使用参考

最近更新时间:2023-07-12 17:44:12

我的收藏
Java SDK 面向使用 Java 语言的平台实现接入腾讯云物联网开发平台。

SDK 获取

SDK 使用 Github 托管,可访问 Github 下载最新版本设备端 explorer-device-java
如果您想通过 jar 引用方式进行项目开发,可在 module 目录下的 build.gradle 中添加依赖,如下依赖:
dependencies {
...
implementation 'com.tencent.iot.explorer:explorer-device-java:x.x.x'
}
说明:
用户可根据 版本说明 把上述 x.x.x 设置成最新版本。

软件架构

类名
功能
TXMqttConnection
连接物联网开发平台。
TXDataTemplate
实现物模型基本功能。
TXDataTemplateClient
实现直连设备根据物模型连接物联网开发平台。
TXGatewayClient
实现网关设备根据物模型连接物联网开发平台。
TXGatewaySubdev
实现网关子设备根据物模型连接物联网开发平台。
腾讯云 IoT Explorer Java SDK 架构图如下:
img



移植指引

Java SDK 移植指引,详情请参见 Java 平台接入指引

SDK API 说明

TXMqttConnection

方法名
说明
connect
MQTT 连接。
reconnect
MQTT 重连。
disConnect
断开 MQTT 连接。
publish
发布 MQTT 消息。
subscribe
订阅 MQTT 主题。
unSubscribe
取消订阅 MQTT 主题。
getConnectStatus
获取 MQTT 连接状态。
setBufferOpts
设置断连状态 buffer 缓冲区。
initOTA
初始化 OTA 功能。
reportCurrentFirmwareVersion
上报设备当前版本信息至后台服务器。
reportOTAState
上报设备升级状态到后台服务器。

TXDataTemplate

方法名
说明
subscribeTemplateTopic
订阅物模型相关主题。
unSubscribeTemplateTopic
取消订阅物模型相关主题。
propertyReport
上报属性。
propertyGetStatus
更新状态。
propertyReportInfo
上报设备信息。
propertyClearControl
清除控制信息。
eventSinglePost
上报单个事件。
eventsPost
上报多个事件。

TXDataTemplateClient

方法名
说明
isConnected
是否已经连接物联网开发平台。
subscribeTemplateTopic
订阅物模型相关主题。
unSubscribeTemplateTopic
取消订阅物模型相关主题。
propertyReport
上报属性。
propertyGetStatus
更新状态。
propertyReportInfo
上报设备信息。
propertyClearControl
清除控制信息。
eventSinglePost
上报单个事件。
eventsPost
上报多个事件。

TXGatewayClient

方法名
说明
findSubdev
查找子设备(根据产品 ID 和设备名称)。
removeSubdev
删除子设备。
addSubdev
添加子设备。
subdevOffline
上线子设备。
subdevOnline
下线子设备。

TXGatewaySubdev

方法名
说明
getSubdevStatus
获取子设备连接状态。
setSubdevStatus
设置子设备连接状态。