群成员用户信息

要在 Global IM UIKit UI 上展示群成员昵称，需要应用层（App）主动向 Global IM UIKit SDK 提供群成员用户信息（GroupUserInfo）。

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

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

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

本文仅描述了应用层（App）如何为 Global IM UIKit SDK 提供群成员昵称与头像（GroupUserInfo）。

Java

GroupUserInfo groupUserInfo = new GroupUserInfo(groupId, userId, nickname, extra);

刷新群成员用户信息

如果 App 本地持有群组用户信息数据（群昵称），可直接刷新本地缓存和数据库中存储的群组用户信息数据。刷新后，Global IM UIKit UI 会展示最新的群成员用户信息 GroupUserInfo。

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

• App 首次启动，并成功建立 IM 连接以后，可以将自身业务所需的群组用户信息批量提供给 SDK，由 SDK 写入缓存与本地数据库，供后续使用。
• 在 IM 建立连接后，如果群组用户昵称变动，由 App 服务端通知客户端（例如使用消息），客户端调用接口刷新群组用户信息。

Java

ConfigCenter.getUserInfoConfig().refreshGroupUserInfoCache(groupUserInfo);

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

动态提供群成员用户信息

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

获取群成员用户信息数据后，SDK 会自动设置、群成员的群内昵称，以及实现相关 UI 展示。

Java

/**
     * GroupUserInfo提供者。
     */
public interface GroupUserInfoProvider {
  /**
         * 获取GroupUserInfo。
         *
         * @param groupId 群组id。
         * @param userId  用户id。
         * @return GroupUserInfo。
         */
  GroupUserInfo getGroupUserInfo(String groupId, String userId);
}

步骤 1：设置群成员用户信息提供者

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

Java

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

ConfigCenter.getUserInfoConfig().setGroupUserInfoProvider(new UserDataProvider.GroupUserInfoProvider() {
  @Override
  public GroupUserInfo getGroupUserInfo(String groupId, String userId) {
    ...// 此处需要 App 提供群成员用户信息。
  }
}, isCacheGroupUserInfo);

参数	类型	说明
groupUserInfoProvider	UserDataProvider.GroupUserInfoProvider	群成员用户信息提供者接口
isCacheGroupUserInfo	boolean	是否持久化存储群成员用户信息到 SDK 的本地数据库。true 表示存储。false 表示不存储。

建议设置 isCacheGroupUserInfo 为 true，即在本地持久化存储群成员用户信息。

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

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

步骤 2：提供群成员用户信息给 SDK

需要展示群成员用户信息时（例如会话列表页面、群聊会话页面），Global IM UIKit 会为这些用户逐个调用 UserInfoConfig 的 getGroupUserInfo 方法获取用户信息。如果 SDK 无法在缓存或本地数据库中查询到所需数据，则会触发 UserDataProvider.GroupUserInfoProvider 的回调方法，要求 App 提供群成员信息数据。

请在 UserDataProvider.GroupUserInfoProvider 的 getGroupUserInfo 回调触发时，向 SDK 提供的群成员用户信息。

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

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

     Java

     ConfigCenter.getUserInfoConfig().setGroupUserInfoProvider(new UserDataProvider.GroupUserInfoProvider() {
       @Override
       public GroupUserInfo getGroupUserInfo(String groupId, String userId) {
         ... // 在需要展示群组信息时（例如会话列表页面、会话页面），Global IM UIKit 首先会根据群组 ID 和用户 ID 逐次调用 getGroupUserInfo。
         // 此处由 App 自行完成异步请求用户信息的逻辑。后续通过 refreshGroupUserInfoCache 提供给 SDK。
         return null;
       }
     }, true);

  2. App 成功获取 userId 的在群组内的昵称数据后，再调用 refreshGroupUserInfoCache 方法，手动刷新群组成员昵称。SDK 在收到该群成员用户信息后会刷新 UI。详见刷新群成员用户信息。

• 同步返回群成员信息：App 也可以直接返回 userId 的群成员用户信息。SDK 在收到该数据后会刷新 UI。

  Java

  ConfigCenter.getUserInfoConfig().setGroupUserInfoProvider(new UserDataProvider.GroupUserInfoProvider() {
    @Override
    public GroupUserInfo getGroupUserInfo(String groupId, String userId) {
      GroupUserInfo groupUserInfo = new GroupUserInfo(groupId, userId, "小花");
      return groupUserInfo; //同步返回群成员昵称。
    }
  }, true);