io.agora.iotlink.IRtmMgr接口 参考

RTM 消息管理模块。

成员函数说明

connect()

int io.agora.iotlink.IRtmMgr.connect

(

final IotDevice

iotDevice

)

连接设备。

成功连接后，SDK 会触发 onConnectDone 回调。你可以通过 RTM 控制该设备。

参数

参数名	描述
iotDevice	设备信息。详见 IotDevice。

返回值

• 0: 方法调用成功。
• <0: 方法调用失败。

disconnect()

int io.agora.iotlink.IRtmMgr.disconnect

(

)

断开设备连接。

断开连接后，你不能通过 RTM 控制该设备。

返回值

• 0: 方法调用成功。
• <0: 方法调用失败。

getStateMachine()

int io.agora.iotlink.IRtmMgr.getStateMachine

(

)

获取当前 RtmMgr 的状态。

返回值

当前 RtmMgr 的状态：

• RTMMGR_STATE_DISCONNECTED(0x0001): 与 RTM 系统未连接。
• RTMMGR_STATE_CONNECTING(0x0002): 正在连接 RTM 系统。
• RTMMGR_STATE_CONNECTED(0x0003): 已连接 RTM 系统。
• RTMMGR_STATE_RECONNECTING(0x0004): 正在重新连接 RTM 系统。可能原因是网络有问题。
• RTMMGR_STATE_ABORTED(0x0005): 一般性错误。

registerListener()

int io.agora.iotlink.IRtmMgr.registerListener

(

IRtmMgr.ICallback

callback

)

注册 IRtmMgr 回调。

参数

参数名	描述
callback	IRtmMgr 回调。详见 ICallback。

返回值

• 0: 方法调用成功。
• <0: 方法调用失败。

sendMessage()

int io.agora.iotlink.IRtmMgr.sendMessage	(	byte[]	messageData,
		final ISendCallback	sendCallback
	)

向设备发送控制消息。

发送完成后，SDK 会触发 onSendDone 回调。

参数

参数名	描述
messageData	待发送的 RTM 消息数据。声网推荐发送小于 4 KB 的数据。
sendCallback	RTM 消息发送完成回调。详见 ISendCallback。

返回值

• 0: 方法调用成功。
• <0: 方法调用失败。

unregisterListener()

int io.agora.iotlink.IRtmMgr.unregisterListener

(

IRtmMgr.ICallback

callback

)

注销 IRtmMgr 回调。

参数

参数名	描述
callback	IRtmMgr 回调。详见 ICallback。

返回值

• 0: 方法调用成功。
• <0: 方法调用失败。

类成员变量说明

static

RTMMGR_STATE_ABORTED

final int io.agora.iotlink.IRtmMgr.RTMMGR_STATE_ABORTED = 0x0005

0x0005：一般性错误。

static

RTMMGR_STATE_CONNECTED

final int io.agora.iotlink.IRtmMgr.RTMMGR_STATE_CONNECTED = 0x0003

0x0003：已连接 RTM 系统。

static

RTMMGR_STATE_CONNECTING

final int io.agora.iotlink.IRtmMgr.RTMMGR_STATE_CONNECTING = 0x0002

0x0002：正在连接 RTM 系统。

static

RTMMGR_STATE_DISCONNECTED

final int io.agora.iotlink.IRtmMgr.RTMMGR_STATE_DISCONNECTED = 0x0001

0x0001：与 RTM 系统未连接。

static

RTMMGR_STATE_RECONNECTING

final int io.agora.iotlink.IRtmMgr.RTMMGR_STATE_RECONNECTING = 0x0004

0x0004：正在重新连接 RTM 系统。可能原因是网络有问题。