账号管理
用户与账号在服务个体是相同的,但是名称上是有不同的, 比如 Alice 在移动运营商获得的业务账号是 8000,本地账号管理(如 Alice_CMCC)则是用户 Profile 的管理, 所以,在 MTC 账号管理中,账号名称只是 Profile 的名称,创建后就不能更改(除非删除)。所以在名称说法有以下约定:
- 账号名称:用户 Profile 的名称,MTC 中也是文件夹的名称,如 Alice_CMCC。
- 用户名称:服务提供商提供的业务账号,如 8000。
- 用户昵称:用户个性化的显示名称,如 Alice Huang。
账号管理只是对账号目录进行管理,当新建或选择账号时,并不意味着账号的配置参数被载入。用户必须选择正确的账号, 通过打开账号操作才能完成账号的配置参数的载入,然后才能设置各种参数。
用户接口
接口名称 | 接口描述 |
---|---|
Mtc_ProfGetUserSize | 获取所有账号数目 |
Mtc_ProfGetUser | 根据账号索引获取账号名称,索引范围从 0 开始的 |
Mtc_ProfGetCurUser | 获取当前账号 |
Mtc_ProfCreateUser | 创建账号目录 |
Mtc_ProfDeleteUser | 删除账号配置、日志文件和目录 |
Mtc_ProfExistUser | 账号名称是否有效 |
Mtc_ProfSaveProvision | 保存当前用户的配置文件 |
表 1. 用户管理接口
读取账号列表

图 1. 读取账号列表过程
1 |
使用 Mtc_ProfGetUserSize 获取账号目录中的所有账号(子目录)数目。 注意: 在读取账号列表前,需要确保客户端资源已经成功的初始化 (Mtc_CliInit)。 用户在初始化客户端时,还可以设置账号管理的目录(默认是 Profiles 目录) |
2 |
使用 Mtc_ProfGetUser 获取索引位置的账号名称。 |
表 2. 读取账号列表说明
获取当前账号

图 2. 获取当前账号过程
1 |
使用 Mtc_ProfGetCurUser 获取当前账号。如果没有创建或选择过账号,则返回空。 注意: 在获取账号前,需要确保客户端资源已经成功的初始化(Mtc_CliInit)。 |
表 3. 获取当前账号说明
创建新账号

图 3. 创建新账号过程
1 |
使用 Mtc_ProfExistUser 判断账号是否存在。 注意: 在获取账号前,需要确保客户端资源已经成功的初始化(Mtc_CliInit)。 |
2 |
使用 Mtc_ProfCreateUser 创建新账号,SDK 会创建新文件夹 |
表 4. 创建新账号说明
删除账号

图 4. 删除账号过程
1 |
使用 Mtc_ProfDeleteUser 删除账号。如果账号存在,则账号的用户文件和目录将被删除。 注意: 在获取账号前,需要确保客户端资源已经成功的初始化(Mtc_CliInit)。 |
表 5. 删除账号过程说明