IM UIKit 自 v9.2.6 起，提供用户信息提供者（IUserInfoDelegate），用于向您的应用获取用户信息。设置IUserInfoDelegate后，您的应用仅需负责提供数据源，IM UIKit 获取数据后将自动调用IUserInfoDelegate包含的方法设置、刷新用户头像与昵称等用户信息，并进行相关界面展示。

本文介绍IUserInfoDelegate的内置方法以及如何设置IUserInfoDelegate，实现用户信息的获取与更新。

用户信息提供者

IM UIKit 可通过用户信息提供者（IUserInfoDelegate）从应用获取和更新用户信息。

java
public interface IUserInfoDelegate {

    //同步获取用户信息数据
    UserInfo getUserInfo(String account)

    //异步获取用户数据
    boolean fetchUserInfo(List<String> accountList, FetchCallback<List<UserInfo>> callback)

    //用户数据更新
    public void updateUserInfo(
              @NonNull Map<UserField, ?> fields, @NonNull FetchCallback<Void> callback)

}

javaIMKitClient.setUserInfoDelegate(new IUserInfoDelegate() {
    @Override
    public UserInfo getUserInfo(@NonNull String account) {
        UserInfo userInfo = new UserInfo(account,"昵称","头像");
        return userInfo;
    }
    ...
},false);

javaIMKitClient.setUserInfoDelegate(new IUserInfoDelegate() {
    ...
    @Override
    public boolean fetchUserInfo(@NonNull List<String> accountList, @NonNull FetchCallback<List<UserInfo>> callback) {
        List<UserInfo> userInfoList = new ArrayList<>();
        for (String account:accountList){
            userInfoList.add(UserInfo userInfo = new UserInfo(account,"昵称","头像"));
        }
        callback.onSuccess(userInfoList);
        return true;
    }
    ...
},false);

javaIMKitClient.setUserInfoDelegate(new IUserInfoDelegate() {
    ...
    @Override
    public void updateUserInfo(@NonNull Map<UserField, ?> fields, @NonNull FetchCallback<Void> callback) {

    }
},false);

前提条件

已完成 IM UIKit 的初始化且已加载相关界面。

实现方法

调用IMKitClient类中setUserInfoDelegate方法设置用户信息提供者。设置之后，由您的应用来提供需要在界面显示的用户信息。调用时可通过useCache参数设置用户信息缓存至内存。设置该功能之后，在应用的生命周期中，如果曾获取过用户或群组的信息，便会在内存中缓存该信息。只要 IM UIKit 可从缓存中获取到所需信息，便不会再触发调用获取用户信息的接口。

如不再需要用户信息提供者，可调用IMKitClient类中removeUserInfoDelegate方法进行移除。移除之后，由 NIM SDK 提供需要在界面显示的用户信息。

• API 原型

java//设置用户信息提供者。useCache代表是否使用内存缓存，如果使用则优先从内存中获取
IMKitClient.setUserInfoDelegate(IUserInfoDelegate delegate,boole useCache);

java//移除用户信息提供者
IMKitClient.removeUserInfoDelegate();

• 示例代码

javaIMKitClient.setUserInfoDelegate(new IUserInfoDelegate() {
    
    @Override
    public UserInfo getUserInfo(@NonNull String account) {
        UserInfo userInfo = new UserInfo(account,"昵称","头像");
        return userInfo;
    }

    @Override
    public boolean fetchUserInfo(@NonNull List<String> accountList, @NonNull FetchCallback<List<UserInfo>> callback) {
        List<UserInfo> userInfoList = new ArrayList<>();
        for (String account:accountList){
            userInfoList.add(UserInfo userInfo = new UserInfo(account,"昵称","头像"));
        }
        callback.onSuccess(userInfoList);
        return true;
    }
    
    @Override
    public void updateUserInfo(@NonNull Map<UserField, ?> fields, @NonNull FetchCallback<Void> callback) {

    }

},false);

相关参考

用户信息说明

IM UIKit 通过UserInfo字段定义用户信息，具体用户信息类型如下：

用户信息处理逻辑

在您设置用户信息提供者并自行实现相应逻辑之后，IM UIKit 处理用户信息的流程如下：