登录

大约 2 分钟

登录

初始化即时通讯 IM SDK 后，你需要首先调用接口登录。登录成功后，才能使用即时通讯 IM 的功能。

用户注册

创建用户

即时通讯 IM 提供以下两种方式创建用户：

  1. 展开控制台左上角下拉框，选择需要开通即时通讯 IM 服务的项目。

  2. 点击左侧导航栏的全部产品。

  3. 在下拉列表中找到即时通讯 IM 并点击。

  4. 在即时通讯 IM 页面，进入运营管理标签页。

  5. 在用户 页签下，点击创建IM用户。

  6. 在弹出的对话框中，配置用户相关参数，点击确定。

img

获取用户 token

创建用户后，在用户列表点击对应的用户的操作一栏中的更多，选择查看Token。

在弹出的对话框中，可以查看用户 Token，也可以点击重新生成，生成用户 token。

img

在生产环境中，为了安全考虑，你需要部署 App Server 生成 Token，详见 Token 鉴权文档。

登录方式

  1. 用户 ID + token 是更加安全的登录方式。

使用 token 登录时需要处理 token 过期的问题，比如在每次登录时更新 token 等机制。

chatClient
  .open({
    user: "username",
    accessToken: "token",
  })
  .then(() => {
    console.log("login success");
  })
  .catch((reason) => {
    console.log("login fail", reason);
  });
  1. 用户 ID + 密码登录是传统的登录方式。用户 ID 和密码均由你的终端用户自行决定，密码需要符合密码规则要求。
chatClient
  .open({
    user: "username",
    pwd: "password",
  })
  .then(() => {
    console.log("login success");
  })
  .catch((reason) => {
    console.log("login fail", reason);
  });

退出登录

chatClient.close();

多设备登录

除了单端单设备登录，即时通讯 IM 支持同一账号在多端的多个设备上登录。多设备登录时，若同端设备数量超过限制，新登录的设备会将之前登录的设备踢下线。

关于多设备登录场景中的设备数量限制、互踢策略以及信息同步，详见多设备登录文档。

上次编辑于: