跳到主要内容

用户概述

您的用户需要接入融云服务,才能使用即时通讯(IM)功能。在融云的体系中,"用户"指持有有效 Token 并成功连接融云 IM 服务的应用用户。

注册用户

您需要通过应用服务器(App Server),使用您用户的 userId 调用融云的注册用户接口,来换取唯一的用户身份凭证(Token)。这一步骤必须通过服务端 API 完成。

应用客户端在连接融云 IM 服务端时,必须携带此 Token 作为凭证。融云会验证 Token 的有效性,以确保连接安全。

注册用户数限制

  • 开发环境?中,注册用户数上限为 100。
  • 生产环境?中,升级为 IM 旗舰版IM 尊享版后,注册用户数无限制。

删除用户

您可以在应用的开发环境下,通过控制台删除已注册的测试用户,以管理测试用户数量。生产环境不支持此操作。

注销用户

注销用户是指在融云服务中删除用户数据。您的应用可通过服务端注销用户 API 使用该功能,实现用户销户,以满足应用上架或合规要求。

提示

注销用户的能力仅通过服务端 API 提供。

注销成功后,与该 userId 相关的数据将被删除。您可以查询所有已注销的 userId。如有需要,您也可以重新激活已被注销的 userId,但请注意,用户相关的个人数据无法恢复。

用户信息

用户信息泛指用户的昵称、头像、群昵称、群头像等数据。默认情况下,融云不存储和维护您应用的用户信息,您需要在自己的服务器上管理这些数据。

如果您希望将用户信息交由融云管理,可以开通并使用融云的用户信息托管服务。

好友关系

默认情况下,融云 IM 服务不保存您应用用户的好友关系数据,也不干预用户的好友关系逻辑。您的应用服务器(App Server)须自行维护用户好友关系。如您希望通过融云管理好友关系,请开通用户信息托管服务,该服务提供了好友关系管理功能。

如使用好友关系服务,默认非好友间也可以互发消息。如需限制为仅好友可互发单聊消息,可在控制台的开发者 > 信息托管服务 > 功能设置中开启此功能。

在不使用融云提供的好友关系管理服务时,如果您需要限制用户间的消息收发行为(例如,防止由于userId 泄漏,恶意用户越过好友关系向其他用户发送骚扰消息),可以使用用户白名单服务。开启白名单后,用户将仅能接收来自其白名单中用户的消息。

用户管理接口

功能分类功能描述客户端 API服务端 API
注册用户为您的用户获取 Token。不提供注册用户
删除用户参见上文删除用户不提供不提供
作废 Token废弃指定时间点前获取的 Token。不提供作废 Token
注销用户在融云服务中停用用户 ID 并删除其个人数据。不提供注销用户
查询已注销用户获取已注销的用户 ID 列表。不提供查询已注销用户
重新激活用户重新启用已注销的用户 ID。不提供重新激活用户 ID
设置融云服务端的用户信息设置用户名称与头像,用于推送等服务。不提供修改用户信息
获取融云服务端的用户信息获取用户在融云注册的信息(包括用户的创建时间、和用于推送的用户名称、头像 URL)。不提供获取信息
修改融云服务端的用户信息修改用于推送的用户名称与头像。不提供修改信息
封禁用户禁止用户连接融云 IM 服务,立即生效。可设置封禁时长,支持主动解封及查询被封禁用户的用户 ID、封禁结束时间。不提供添加封禁用户解除封禁用户查询封禁用户
查询用户在线状态查询指定用户的在线状态。不提供查询在线状态
加入黑名单将指定用户加入黑名单。在 A 用户黑名单中的用户无法向 A 发送消息。加入黑名单加入黑名单
移出黑名单将指定用户从黑名单中移除。移出黑名单移出黑名单
查询用户是否在黑名单中检查指定用户是否在当前用户的黑名单中。查询用户是否在黑名单中不提供
获取黑名单列表获取当前用户的黑名单列表。获取黑名单列表查询黑名单
用户白名单开启后,用户仅能接收来自其白名单中用户的消息。不提供开启用户白名单用户白名单状态查询添加白名单移出白名单查询白名单