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

用户信息代理

用户信息代理 IUserInfoDelegate 支持同步获取用户信息、异步获取用户信息和更新用户信息。

swift@objc
public protocol IUserInfoDelegate: NSObjectProtocol {
    //同步获取用户信息数据
  @objc
  optional func getUserInfo(account: String) -> User?

    //异步获取用户数据
  @objc(fetchUserInfoList:completion:)
  optional func fetchUserInfo(accountList list: [String], completion: FetchCallback?)

    //用户数据更新 
  @objc(updateUserInfo:completion:)
  optional func updateUserInfo(values: [NSNumber: Any], completion: UpdateCallback?)
}

@protocol IUserInfoDelegate <NSObject>
    @optional
    //同步获取用户信息数据
    - (User * _Nullable)getUserInfoWithAccount:(NSString * _Nonnull)account SWIFT_WARN_UNUSED_RESULT;

    //异步获取用户数据
    - (void)fetchUserInfoList:(NSArray<NSString *> * _Nonnull)list completion:(void (^ _Nullable)(NSArray<User *> * _Nullable, NSError * _Nullable))completion;

    //用户数据更新 
    - (void)updateUserInfo:(NSDictionary<NSNumber *, id> * _Nonnull)values completion:(void (^ _Nullable)(NSError * _Nullable))completion;
@end

同步获取用户信息

IM UIKit 调用 getUserInfo 方法，可从您的应用本地同步获取用户信息。若本地没有用户数据，则该方法返回值为空。

为了不影响界面加载性能，建议不要在 IM UIKit 调用该方法时进行耗时操作。

func getUserInfo(account: String) -> User? {
        let user = User.init(userId: account, nickName: "昵称", avatarUrl: "头像")
        return user
    }
    

- (User * _Nullable)getUserInfoWithAccount:(NSString * _Nonnull)account {
    User * user = [[User alloc] initWithUserId:account nickName:@"昵称" avatarUrl:@"头像"];
    return user
}

异步获取用户信息

IM UIKit 调用 fetchUserInfo 方法，可从您的应用服务端异步获取用户信息，在获取成功之后将用户信息回调给 IM UIKit。IM UIKit 调用该方法时，您可进行耗时操作（请求网络等）。

该接口会将获取到的用户信息缓存在本地，所以需要避免此接口的滥调，导致存储过多无用数据到本地。

func fetchUserInfo(accountList list: [String], completion: FetchCallback?) {
        var userList = [User]()
        for uid in list {
            userList.append(User.init(userId: uid, nickName: "昵称", avatarUrl: "头像"))
        }
        completion!(userList,nil)
    }

- (void)fetchUserInfoList:(NSArray<NSString *> *)list completion:(void (^)(NSArray<User *> * _Nullable, NSError * _Nullable))completion {
    NSMutableArray<User *> *userList;
    for (NSString *uid in list) {
        [userList addObject:[[User alloc] initWithUserId:uid nickName:@"昵称" avatarUrl:@"头像"]];
    }
    completion(userList, nil);
}

更新用户信息

IM UIKit 调用 updateUserInfo 方法更新用户信息并获取被修改的用户信息字段。

该接口可一次性修改多个属性，如昵称，头像等，传入的数据键值对是 {@(NIMUserInfoUpdateTag) : NSString}，无效数据将被过滤。

func updateUserInfo(values: [NSNumber : Any], completion: UpdateCallback?) {
        
    }

- (void)updateUserInfo:(NSDictionary<NSNumber *,id> *)values completion:(void (^)(NSError * _Nullable))completion {
    
}

设置用户信息代理

您可调用IMKitClient类中addDelegate方法设置用户信息代理。设置之后，由您的应用来提供需要在界面显示的用户信息。如不再需要用户信息代理，可调用IMKitClient类中removeDelegate方法进行移除。移除之后，由 NIM SDK 提供需要在界面显示的用户信息。

• API 原型

  Swift

  swift/// 设置用户信息代理
  /// - Parameter delegate: 代理
  public func addDelegate(_ delegate: IUserInfoDelegate)
  
  /// 移除用户信息代理
  /// - Parameter delegate: 代理
  public func removeDelegate(_ delegate: IUserInfoDelegate)
  

  Objective-C

  /// 设置用户信息代理
  /// - param delegate 代理
  - (void)addDelegate:(id <IUserInfoDelegate> _Nonnull)delegate;
  /// 移除用户信息代理
  /// - param delegate 代理
  - (void)removeDelegate:(id <IUserInfoDelegate> _Nonnull)delegate;
  

• 示例代码

  Swift

  swift//设置代理
  IMKitClient.instance.addDelegate(self)
  
      func getUserInfo(account: String) -> User? {
          let user = User.init(userId: account, nickName: "昵称", avatarUrl: "头像")
          return user
      }
      
      func fetchUserInfo(accountList list: [String], completion: FetchCallback?) {
          var userList = [User]()
          for uid in list {
              userList.append(User.init(userId: uid, nickName: "昵称", avatarUrl: "头像"))
          }
          completion!(userList,nil)
      }
      
      func updateUserInfo(values: [NSNumber : Any], completion: UpdateCallback?) {
          
      }
  
  //移除代理
  IMKitClient.instance.removeDelegate(self)
  

  Objective-C

  //设置代理
  [[IMKitClient instance] addDelegate:self];
  
  - (User * _Nullable)getUserInfoWithAccount:(NSString * _Nonnull)account {
      User * user = [[User alloc] initWithUserId:account nickName:@"昵称" avatarUrl:@"头像"];
      return user
  }
  
  - (void)fetchUserInfoList:(NSArray<NSString *> *)list completion:(void (^)(NSArray<User *> * _Nullable, NSError * _Nullable))completion {
      NSMutableArray<User *> *userList;
      for (NSString *uid in list) {
          [userList addObject:[[User alloc] initWithUserId:uid nickName:@"昵称" avatarUrl:@"头像"]];
      }
      completion(userList, nil);
  }
  
  - (void)updateUserInfo:(NSDictionary<NSNumber *,id> *)values completion:(void (^)(NSError * _Nullable))completion {
      
  }
  
  //移除代理
  [[IMKitClient instance] removeDelegate:self];
  

用户信息说明

IM UIKit 通过 User 字段定义用户信息。

User 参数说明：

UserInfo参数说明：

用户信息处理逻辑

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