com.agora.iotsdk20.IAccountMgr接口 参考

账号管理接口。

成员函数说明

getLoggedAccount()

String com.agora.iotsdk20.IAccountMgr.getLoggedAccount

(

)

获取当前已经登录的账号。

返回值

当前已经登录的账号。如果当前账号未登录，则返回 null。

getMqttState()

int com.agora.iotsdk20.IAccountMgr.getMqttState

(

)

获取当前 MQTT 客户端状态。

成功调用该方法后，SDK 会触发 onMqttStateChanged 回调报告当前 MQTT 客户端的状态。

返回值

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

getQRCodeUserId()

String com.agora.iotsdk20.IAccountMgr.getQRCodeUserId

(

)

获取用于登录的二维码字符串。

app 需要通过获取到的字符串生成一个二维码，当用户使用摄像头扫描该二维码时，即可在新设备上登录其账号。

返回值

用于登录的二维码字符串。如果当前账号未登录，则返回一个空的字符串。

getStateMachine()

int com.agora.iotsdk20.IAccountMgr.getStateMachine

(

)

获取当前账号管理状态机。

返回值

当前账号管理状态。

login()

int com.agora.iotsdk20.IAccountMgr.login

(

final LoginParam

loginParam

)

通过第三方账号的登陆参数登陆用户账号。

该方法适用于用户已经自行实现第三方账号管理系统的情况。用户可以直接通过该方法登陆灵隼物联网平台。

参数

参数名	描述
loginParam	第三方登陆参数。详见 LoginParam。

返回值

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

logout()

int com.agora.iotsdk20.IAccountMgr.logout

(

)

登出当前账号。

成功登出账号后，SDK 会触发 onLogoutDone 回调。

返回值

错误码，详见 ErrCode。

registerListener()

int com.agora.iotsdk20.IAccountMgr.registerListener

(

IAccountMgr.ICallback

callback

)

注册回调接口。

参数

参数名	描述
callback	回调接口，详见 ICallback。

返回值

错误码，详见 ErrCode。

setPublicKey()

int com.agora.iotsdk20.IAccountMgr.setPublicKey	(	final String	lsAccessToken,
		final String	inventDeviceName,
		final String	publickKey
	)

设置云存储视频加密的公钥。

为加强云存储视频加密的安全性，你可以在应用层自行生成公钥、私钥，再通过该方法将公钥传入 SDK。例如，只有 SDK 的公钥和你 app 的私钥都正确，用户才能查看加密视频。

成功调用该方法后，SDK 会触发 onSetPublicKeyDone 回调并报告设置结果及公钥信息。

注解

• 请确保该方法中设置的 lsAccessToken 和 inventDeviceName 参数值分别与 LoginParam 中的 mLsAccessToken 和 mInventDeviceName 参数值一致。
• 声网不会保存你传入的公钥，你需要自行保存并管理。

参数

参数名	描述
lsAccessToken	灵隼平台账号的 Token。
inventDeviceName	账号的虚拟名称。
publickKey	待设置的公钥。

返回值

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

unregisterListener()

int com.agora.iotsdk20.IAccountMgr.unregisterListener

(

IAccountMgr.ICallback

callback

)

注销回调接口。

参数

参数名	描述
callback	回调接口，详见 ICallback。

返回值

错误码，详见 ErrCode。

类成员变量说明

static

ACCOUNT_STATE_IDLE

final int com.agora.iotsdk20.IAccountMgr.ACCOUNT_STATE_IDLE = 0x0000

0x0000: 账号未登录。

static

ACCOUNT_STATE_LOGINING

final int com.agora.iotsdk20.IAccountMgr.ACCOUNT_STATE_LOGINING = 0x0001

0x0003: 正在登录用户账号。

static

ACCOUNT_STATE_LOGOUTING

final int com.agora.iotsdk20.IAccountMgr.ACCOUNT_STATE_LOGOUTING = 0x0002

0x0004: 正在登出用户账号。

static

ACCOUNT_STATE_RUNNING

final int com.agora.iotsdk20.IAccountMgr.ACCOUNT_STATE_RUNNING = 0x0003

0x000B: 该账号已登录。

static

MQTT_STATE_CONNECTED

final int com.agora.iotsdk20.IAccountMgr.MQTT_STATE_CONNECTED = 0x0002

MQTT 客户端已连接。

static

MQTT_STATE_CONNECTING

final int com.agora.iotsdk20.IAccountMgr.MQTT_STATE_CONNECTING = 0x0001

MQTT 客户端正在连接中。

static

MQTT_STATE_DISCONNECTED

final int com.agora.iotsdk20.IAccountMgr.MQTT_STATE_DISCONNECTED = 0x0000

MQTT 客户端未连接。