Docs
Resources
Tools
News
to top

用户管理

账号管理

用户与账号在服务个体是相同的,但是名称上是有不同的, 比如 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. 用户管理接口

读取账号列表

read account

图 1. 读取账号列表过程

1

使用 Mtc_ProfGetUserSize 获取账号目录中的所有账号(子目录)数目。

注意: 在读取账号列表前,需要确保客户端资源已经成功的初始化 (Mtc_CliInit)。 用户在初始化客户端时,还可以设置账号管理的目录(默认是 Profiles 目录)

2

使用 Mtc_ProfGetUser 获取索引位置的账号名称。

表 2. 读取账号列表说明

获取当前账号

get account

图 2. 获取当前账号过程

1

使用 Mtc_ProfGetCurUser 获取当前账号。如果没有创建或选择过账号,则返回空。

注意: 在获取账号前,需要确保客户端资源已经成功的初始化(Mtc_CliInit)。

表 3. 获取当前账号说明

创建新账号

create account

图 3. 创建新账号过程

1

使用 Mtc_ProfExistUser 判断账号是否存在。

注意: 在获取账号前,需要确保客户端资源已经成功的初始化(Mtc_CliInit)。

2

使用 Mtc_ProfCreateUser 创建新账号,SDK 会创建新文件夹

表 4. 创建新账号说明

删除账号

delete account

图 4. 删除账号过程

1

使用 Mtc_ProfDeleteUser 删除账号。如果账号存在,则账号的用户文件和目录将被删除。

注意: 在获取账号前,需要确保客户端资源已经成功的初始化(Mtc_CliInit)。

表 5. 删除账号过程说明

Juphoon © 2015 中文(简体)
关于我们 JusTalk 开发人员 招聘 隐私政策