跳到主要内容

用户信息

要在 Global IM UIKit UI 上展示用户头像、昵称等,需要应用层(App)主动向 Global IM UIKit SDK 提供用户信息UserInfo)。

Global IM UIKit 使用 UserInfoConfig 类统一管理以下数据。App 需要使用 UserInfoConfig 向 Global IM UIKit 提供数据,用于在 UI 上展示。

  • 用户信息:包含昵称、头像
  • 群组信息:包含群组名称、群组头像
  • 群成员用户信息:仅支持群用户昵称

用户信息、群组信息、群成员用户信息必须由应用开发者主动从 App 服务端获取,并提供给 SDK。融云不提供 App 用户与群组信息托管服务。融云服务端的用户昵称及头像仅用于推送服务。

本文仅描述了应用层(App)如何为 Global IM UIKit SDK 提供用户昵称与头像(UserInfo):

UserInfo userInfo = new UserInfo(userId, "userId 对应的名称", Uri.parse("userId 对应头像地址"));

刷新用户信息

如果 App 本地持有用户信息数据(例如当前登录用户的昵称和头像),可直接刷新本地缓存和数据库中存储的用户信息(头像与昵称)。刷新后,Global IM UIKit UI 会展示最新的用户信息 UserInfo

刷新用户信息必须在 Global IM UIKit 已成功建立 IM 连接后操作,否则无法刷新本地数据。可能适用场景如下:

  • App 首次启动,并成功建立 IM 连接以后,可以将自身业务所需的用户信息批量提供给 SDK,由 SDK 写入缓存与本地数据库,供后续使用。
  • 在 IM 建立连接后,如果用户昵称、头像等信息变动,由 App 服务端通知客户端(例如使用消息),客户端调用接口刷新用户信息。
UserInfo userInfo = new UserInfo(userId, "userId 对应的名称", Uri.parse("userId 对应头像地址"));
ConfigCenter.getUserInfoConfig().refreshUserInfoCache(userInfo);

如果 App 本地不持有数据,推荐在 Global IM UIKit 需要展示数据时动态提供用户信息。

动态提供用户信息

从 Global IM UIKit 5.X 版本开始,SDK 设计了「用户信息提供者」UserDataProvider.UserInfoProvider 接口类。如果 Global IM UIKit 无法从 UserInfoConfig 中获取用户信息,将触发 UserInfoProvidergetUserInfo 回调方法。App 应在该回调中提供 SDK 所需要的用户头像与昵称。

获取用户信息数据后,SDK 会自动设置、刷新用户头像与昵称,以及实现相关 UI 展示。

public interface UserInfoProvider {
/**
* 获取用户信息。
*
* @param userId 用户 Id。
* @return 用户信息。
*/
UserInfo getUserInfo(String userId);
}

步骤 1:设置用户信息提供者

使用 ConfigCenter.getUserInfoConfig().setUserInfoProvider() 方法设置用户信息提供者。必须在 SDK 初始化之后,建立 IM 连接之前设置。建议在应用生命周期内设置。

// 允许 SDK 在本地持久化存储用户信息
boolean isCacheUserInfo = true;

ConfigCenter.getUserInfoConfig().setUserInfoProvider(new UserDataProvider.UserInfoProvider() {
@Override
public UserInfo getUserInfo(String userId) {
...// 此处需要 App 提供用户信息。
}
}, isCacheUserInfo);
参数类型说明
userInfoProviderUserDataProvider.UserInfoProvider用户信息提供者接口
isCacheUserInfoboolean是否持久化存储用户信息到 SDK 的本地数据库。true 表示存储。false 表示不存储。

建议设置 isCacheUserInfotrue,即在本地持久化存储用户信息。

在 App 的生命周期中,如果 SDK 获取过用户的信息,便会在内存中缓存该信息。允许持久化存储后,SDK 优先从本地数据库中获取用户信息,App 下次启动时数据仍然可用。SDK 在处理对应信息时默认行为如下:

  1. 当 SDK 需要在 UI 上显示用户信息时,首先从内存中查询已获取的数据。
  2. 如果 SDK 可从缓存或本地数据库中查询到所需信息,将直接将数据返回 UI 层并刷新 UI。
  3. 如果 SDK 未能从缓存或本地数据库查询到所需信息,则将触发 UserDataProvider.UserInfoProvider 的回调方法,并尝试从应用层获取信息。收到应用层提供的相应信息后,SDK 将刷新 UI。

步骤 2:提供用户信息给 SDK

在需要展示用户信息时(例如会话列表页面、会话页面),Global IM UIKit 首先会根据用户 ID 逐个调用 UserInfoConfiggetUserInfo 方法获取用户信息。如果 SDK 无法在缓存或本地数据库中查询到所需用户信息,则会触发 UserDataProvider.UserInfoProvider 的回调方法,要求 App 提供用户信息数据。

请在 UserDataProvider.UserInfoProvidergetUserInfo 回调触发时,向 SDK 提供用户信息数据。

  • 异步获取用户信息,再手动刷新: App 可以使用该方式避免耗时操作影响 UI。

    1. App 需要在 getUserInfo 方法中直接返回 null,同时,App 应在该方法中触发自行获取 userId 的用户信息的逻辑。注意,该步骤会将 userId 的用户信息临时置为空。

      ConfigCenter.getUserInfoConfig().setUserInfoProvider(new UserDataProvider.UserInfoProvider {
      @Override
      public UserInfo getUserInfo(String userId) {
      ...// 在需要展示用户信息时(例如会话列表页面、会话页面),Global IM UIKit 首先会根据用户 ID 逐个调用 getUserInfo。
      // 此处由 App 自行完成异步请求用户信息的逻辑。后续通过 refreshUserInfoCache 提供给 SDK。
      return null;
      }

      }, true);
    2. App 成功获取 userId 的用户信息数据后,再调用 UserInfoConfigrefreshUserInfoCache 方法,手动刷新 userId 用户信息。SDK 在收到该用户的信息后会刷新 UI。详见刷新用户信息

      UserInfo userInfo = new UserInfo(userId, "userId 对应的名称", Uri.parse("userId 对应的头像地址"))
      ConfigCenter.getUserInfoConfig().refreshUserInfoCache(userInfo);
  • 同步返回用户信息:App 也可以直接返回 userId 的用户信息。SDK 在收到该用户的信息后会刷新 UI。

    ConfigCenter.getUserInfoConfig().setUserInfoProvider(new UserDataProvider.UserInfoProvider() {
    @Override
    public UserInfo getUserInfo(String userId) {
    UserInfo userInfo = new UserInfo(userId, "userId 对应的名称", Uri.parse("userId 对应的头像地址"))
    return userInfo;
    }
    }, true);