描述

在使用CloudEC解决方案下的各类业务之前，需要向服务器完成登录；在不再使用业务时注销，确保业务接口使用的安全性。

说明： 

登录成功后，SDK自动按保活周期定时刷新鉴权凭证信息。

已完成初始化。

业务流程

用户登录

图1 登录处理流程 

1. UI调用tsdk_login()进行登录，参数包括用户ID、鉴权类型、用户帐户和密码(或Tiket)以及服务器信息。
   说明： 

   1. 用户ID，由应用程序生成的标识，用于关联用户帐户；
   2. 如果用户选择使用“密码鉴权”登录，则鉴权类型取值为TSDK_E_AUTH_TYPE，帐户的用户名和密码必需填写；如果用户选择使用第三方认证登录，则鉴权类型取值为TSDK_E_AUTH_TICKET，帐户的ticket值必须填写，取值为第三方提供的token值3rd_Token。
   3. 服务器类型取值TSDK_E_SERVER_TYPE，暂仅支持TSDK_E_SERVER_TYPE_PORTAL。
   代码示例：

   //c code int ret; TSDK_S_LOGIN_PARAM login_param; memset(&login_param, 0, sizeof(login_param)); login_param.user_id = 1; login_param.auth_type = TSDK_E_AUTH_NORMAL; strcpy_s(login_param.user_name, TSDK_D_MAX_ACCOUNT_LEN+1, userAccount); strcpy_s(login_param.password, TSDK_D_MAX_PASSWORD_LENGTH + 1, userPassword); login_param.server_type = TSDK_E_SERVER_TYPE_PORTAL; strcpy_s(login_param.server_addr, TSDK_D_MAX_URL_LENGTH + 1, serverAddress); login_param.server_port = serverPort; ret = tsdk_login(&login_param); return ret;

2. SDK收到服务器的鉴权登录响应后，向UI上报鉴权成功事件TSDK_E_LOGIN_EVT_AUTH_SUCCESS。
   说明： 

   1. 如果鉴权失败，将不能进行下一步操作，也不会有业务帐号和配置信息上报。
   代码示例：

   //c code case TSDK_E_LOGIN_EVT_AUTH_SUCCESS: { LOG_D_AUTH_LOGIN_INFO("login auth success !"); break; }

3. SDK收到服务器的鉴权登录响应后，向UI上报VOIP帐号信息事件TSDK_E_LOGIN_EVT_VOIP_ACCOUNT_STATUS。
   说明： 

   1. 如果登录成功，会上报帐号短号号码，UI应保存此号码，以方便后续操作。
4. 登录成功之后，SDK向UI上报登录成功事件TSDK_E_LOGIN_EVT_LOGIN_SUCCESS，UI做相应的界面处理。

用户主动注销

图2 注销处理流程 

1. UI调用tsdk_logout()发起注销。
   代码示例：

   //c code int ret = tsdk_logout(); return ret;

2. 登出成功之后，向UI上报登出成功事件TSDK_E_LOGIN_EVT_LOGOUT_SUCCESS
   代码示例：

   //c code case TSDK_E_LOGIN_EVT_LOGOUT_SUCCESS: { LOG_D_CALL_INFO("logout success"); break; }

服务器强制注销

图3 服务器强制注销处理流程 

说明： 

用户帐号在其他位置登录时，服务器会通知应用程序注销本地帐号。

1. SDK收到服务器的强制登出通知消息后，向UI上报强制登出事件TSDK_E_LOGIN_EVT_FORCE_LOGOUT。
2. UI调用tsdk_logout()完成登出过程。

注意事项

无。