用户注册与登录
大约 2 分钟
Andorid 集成文档
用户注册与登录
本文介绍用户注册模式与登录方式。
用户注册模式
即时通讯 IM 提供以下两种方式创建用户:
调用 RESTful API 注册用户账号,注册后保存到你的服务器或返给客户端。
在声网控制台上创建用户。
创建用户
在声网控制台按照如下步骤创建用户:
展开控制台左上角下拉框,选择需要开通即时通讯 IM 服务的项目。
点击左侧导航栏的全部产品。
在下拉列表中找到即时通讯 IM 并点击。
在即时通讯 IM 页面,进入运营管理标签页。
在用户 页签下,点击创建IM用户。
在弹出的对话框中,配置用户相关参数,点击确定。
获取用户 token
创建用户后,在用户列表点击对应的用户的操作一栏中的更多,选择查看Token。
在弹出的对话框中,可以查看用户 Token,也可以点击重新生成,生成用户 token。
用户登录
初始化即时通讯 IM SDK 后,你需要调用登录接口进行登录。只有登录成功后,你才能正常使用 IM 的各种功能,例如消息和会话。
目前登录服务器支持主动和自动登录。主动登录有两种方式:
- 用户 ID + 密码
- 用户 ID + token
参数 | 类型 | 是否必需 | 描述 |
---|---|---|---|
username | String | 是 | 用户 ID,长度不可超过 64 个字节。不可设置为空。支持以下字符集: - 26 个小写英文字母 a-z; - 26 个大写英文字母 A-Z; - 10 个数字 0-9; - “_”, “-”, “.”。 注意
|
token | String | 是 | token 可以通过调用 REST API 获取,即传入用户 ID (或用户 ID + 密码)和 token 有效期参数获取,详见 使用 token 验证。 |
password | String | 是 | 用户的登录密码,长度不可超过 64 个字符。 |
登录流程
- 用户 ID + 密码
- 用户 ID + Token
提示
关 token 鉴权,详见 使用 Token 鉴权。