用户注册与登录

本文介绍用户注册模式与登录方式。

用户注册

登录 SDK 前，你需要先创建环信 IM 用户。创建用户前，需先在 环信控制台 的 即时通讯 > 基础功能 > 用户 页面设置用户注册模式。

用户注册模式分为以下两种：

• 授权注册：通过环信提供的 REST API 注册用户。该方式适用于正式生产环境，注册成功后，你可以将用户账号保存到你的应用服务器或返回给客户端。
• 开放注册：允许客户端或 REST API 直接注册用户。该方式一般用于体验 Demo 和测试环境，正式环境不推荐使用。

设置注册模式后，你可以通过以下方式创建用户：

1. 调用 REST API 创建用户

   • 授权注册：调用 授权注册单个用户 或 批量授权注册用户 接口创建用户。
   • 开放注册：开启开放注册后，可通过客户端或 REST API 开放注册用户 创建用户。

2. 通过环信控制台创建用户

   你可以在 环信控制台 创建正式环境或测试环境下的用户，详见 创建用户。

用户登录

初始化环信即时通讯 IM SDK 后，你需要调用登录接口进行登录。只有登录成功后，你才能正常使用 IM 的各种功能，例如消息和会话。

即时通讯 IM 支持用户 ID 和 token 登录。

参数	类型	是否必需	描述
username	String	是	用户 ID，长度不可超过 64 个字节。不可设置为空。支持以下字符集： - 26 个小写英文字母 a-z； - 10 个数字 0-9； - “_”, “-”, “.”。 注意 - 请勿使用大写英文字母 A-Z。若你同时使用了大写字母和小写字母，响应中返回的用户 ID 只包含小写字母。 - 用户 ID 为公开信息，请勿使用 UUID、邮箱地址、手机号等敏感信息。
token	String	是	token 可以通过调用 REST API 获取，即传入用户 ID （或用户 ID + 密码）和 token 有效期参数获取，详见 环信用户 token 的获取。 注意 - 你可以在调用 REST API 获取 token 时，传入 ttl 参数，设置 token 的有效期。此外，你也可以通过 环信控制台的 用户管理 页面设置 token 的有效期。该参数值以最新设置为准。 - 环信服务器完全信赖用户 token，为避免业务受影响，你需要确保 token 的安全。

登录流程

提示

1. 关于获取 token，详见 获取 App Token和 获取 User Token。
2. 获取 token 时，token 有效期 ttl 以传入的值为准。若不传该参数，以环信控制台的 用户管理 页面的 token 有效期的设置为准，默认为 60 天。若设置为 0，则 token 永久有效。