跳到主要内容

用户信息

本文主要描述如何设置用户、群组、群成员的昵称、头像等信息,具体涵盖以下内容:

  • 设置当前登录的用户的昵称与头像。
  • 通过多种信息提供者协议,从 App 层获取用户、群组、群成员、群成员列表等信息,提供给 SDK,用于设置与显示。
  • 如何持久化存储用户信息、群组信息、群成员信息。

启用持久化存储

Global IM UIKit 支持将用户信息、群组信息、群成员信息持久化存储到本地数据库中。不支持持久化存储群成员列表信息。

当需要将用户信息、群组信息、群成员信息在本地持久化保存的时候,可以设置 RCIMKitClient 类的 enableUserInfoPersistence 属性为 YES,信息将被同时缓存到内存和数据库,App 下次启动时缓存仍然有效。

请在初始化之后,连接之前设置持久化存储属性。

@property (nonatomic, assign) BOOL enableUserInfoPersistence;

默认为 NO。信息只缓存到内存,在 App 生命周期结束时会被清除,App 下次启动时将再次通过对应的信息提供者协议获取信息。

了解信息提供者协议

Global IM UIKit 设计并提供了以下信息提供者协议,用于向应用层获取信息。开发者需要实现该协议,提供正确的数据。

应用层仅需负责提供数据源,SDK 获取数据后会自动设置、刷新用户头像与昵称,以及相关 UI 展示。

建议在 AppDelegate 或者其他单例中遵循以上协议。

在 App 的生命周期中,如果 SDK 获取过用户或群组的信息,便会在内存中缓存该信息。只要 SDK 可从缓存中获取到所需信息,便不会再触发获取该信息的回调。

在处理用户、群组信息时,SDK 的默认行为如下:

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

设置当前登录的用户信息

开发者与融云服务器建立连接之后,应该设置当前登录用户的用户信息,已确保 SDK 可正常在界面上显示本端用户头像。

属性说明

如果传入的用户信息中的用户 ID 与当前登录的用户 ID 不匹配,SDK 会将其忽略。

@property (nonatomic, strong) RCUserInfo *currentUserInfo;

代码示例

请在成功与融云服务端建立连接之后设置,您可以在连接成功的回调中进行设置。

RCUserInfo *currentUserInfo = [[RCUserInfo alloc] initWithUserId:userId name:userNickName portrait:userPortraitUri];
[RCIMKitClient shared].currentUserInfo = currentUserInfo;

设置其他用户的用户信息

用户信息提供者(RCIMKitUserInfoDataSource 协议)用于获取非本端登录用户的用户信息,例如昵称、头像等。

代理回调

SDK 通过代理向应用层获取用户信息。

设置代理委托

请在 SDK 初始化之后,连接融云服务器之前设置代理委托。

[RCIMKitClient shared].userInfoDataSource = self;

代理方法

@protocol RCIMKitUserInfoDataSource <NSObject>

/// SDK 的回调,用于向 App 获取用户信息
///
/// - Parameter userId: 用户ID
/// - Parameter completion: 获取用户信息完成之后需要执行的Block [userInfo:该用户ID对应的用户信息]
///
/// SDK通过此方法获取用户信息并显示,请在completion中返回该用户ID对应的用户信息。
/// 在您设置了用户信息提供者之后,SDK在需要显示用户信息的时候,会调用此方法,向您请求用户信息用于显示。
- (void)getUserInfoWithUserId:(NSString *)userId completion:(void(^)(RCUserInfo *userInfo))completion;

@end

代码示例

以下代码示例来自 TestDemo 项目(GitHub · Gitee) 。

- (void)getUserInfoWithUserId:(NSString *)userId completion:(void(^)(RCUserInfo *userInfo))completion {
//开发者调自己的服务器接口,根据 userID 异步请求用户信息
[RCDUserInfoManager getUserInfoFromServer:userId
complete:^(RCUserInfo *userInfo) {
//将请求回来的用户信息通过 completion 回调给 SDK
return completion(userInfo);
}];
}

获取用户信息

可以调用以下方法获取用户信息。SDK 将首先尝试从本地缓存获取数据。如已允许 SDK 进行持久化存储(即已在 RCIMKitClient.h 里开启 enableUserInfoPersistence),SDK 还会尝试从本地数据库中获取用户信息。

如果本地没有相关信息的数据,则会触发相应的回调方法,从应用层获取数据。

调用示例

[[RCIMKitClient shared] getCachedUserInfo:@"userId"];

刷新用户信息

您可以通过下面的方法更新 SDK 在本地缓存的用户信息。如已允许 SDK 进行持久化存储(即已在 RCIMKitClient.h 里开启 enableUserInfoPersistence),SDK 还会更新本地数据库中的用户信息。

调用示例

RCUserInfo *user = [[RCUserInfo alloc] initWithUserId:@"userId" name:@"userName" portrait:@"http://portrait"];

[[RCIMKitClient shared] refreshUserInfoCache:user];

清除用户信息

您可以通过下面的方法清除 SDK 在本地缓存的用户信息。如已允许 SDK 进行持久化存储(即已在 RCIMKitClient.h 里开启 enableUserInfoPersistence),SDK 还会清除本地数据库中的用户信息。

调用示例

[[RCIMKitClient shared] clearCachedUserInfo];

设置群组信息

群组信息提供者(RCIMKitGroupInfoDataSource 协议)用于获取群组的昵称、头像。

代理回调

SDK 通过代理向应用层获取群组信息。

设置代理委托

[RCIMKitClient shared].groupInfoDataSource = self;

代理方法

@protocol RCIMKitGroupInfoDataSource <NSObject>

/// SDK 的回调,用于向 App 获取群组信息
///
/// - Parameter groupId: 群组ID
/// - Parameter completion: 获取群组信息完成之后需要执行的Block [groupInfo:该群组ID对应的群组信息]
///
/// SDK通过此方法获取群组信息并显示,请在completion的block中返回该群组ID对应的群组信息。
/// 在您设置了群组信息提供者之后,SDK在需要显示群组信息的时候,会调用此方法,向您请求群组信息用于显示。
- (void)getGroupInfoWithGroupId:(NSString *)groupId completion:(void(^)(RCGroup *groupInfo))completion;

@end

代码示例

以下代码示例来自 TestDemo 项目(GitHub · Gitee) 。

- (void)getGroupInfoWithGroupId:(NSString *)groupId completion:(void(^)(RCGroup *groupInfo))completion {
//开发者调自己的服务器接口根据userID异步请求数据
[RCDGroupManager getGroupInfoFromServer:groupId
complete:^(RCGroup * groupInfo) {
return completion(groupInfo);
}];
}

获取群组信息

可以调用以下方法获取群组信息。SDK 将首先尝试从本地缓存获取数据。如已允许 SDK 进行持久化存储(即已在 RCIMKitClient.h 里开启 enableUserInfoPersistence),SDK 还会尝试从本地数据库中获取群组信息。

如果本地没有相关信息的数据,则会触发相应的回调方法,从应用层获取数据。

调用示例

[[RCIMKitClient shared] getCachedGroupInfo:@"groupId"];

刷新群组信息

构造群组信息RCGroup),方法如下:

RCGroup *group = [[RCGroup alloc] initWithGroupId:@"groupId" groupName:@"groupName" portraitUri:@"http://portraitUri"];
/// 5.4.1 及之后,新增 NSString 类型的 extra 字段
group.extra = @"groupExtra";

您可以通过下面的方法更新 SDK 在本地缓存的群组信息。如已允许 SDK 进行持久化存储(即已在 RCIMKitClient.h 里开启 enableUserInfoPersistence),SDK 还会刷新本地数据库中的群组信息。

[[RCIMKitClient shared] refreshGroupInfoCache:group];

清除群组信息

您可以通过下面的方法清除 SDK 在本地缓存的群组信息。如已允许 SDK 进行持久化存储(即已在 RCIMKitClient.h 里开启 enableUserInfoPersistence),SDK 还会清除本地数据库中的群组信息。

调用示例

[[RCIMKitClient shared] clearCachedGroupInfo];

群成员信息

群成员信息提供者(RCIMKitGroupUserInfoDataSource协议)用于获取群组成员的昵称、头像。如果未遵循该协议,SDK 默认使用用户信息协议。

代理回调

SDK 通过代理向应用层获取群成员信息(昵称、头像)。

设置代理委托

请在 SDK 初始化之后,连接融云服务器之前设置代理委托。

[RCIMKitClient shared].groupUserInfoDataSource = self;

代理方法

@protocol RCIMKitGroupUserInfoDataSource <NSObject>

/// SDK 的回调,用于向 App 获取用户在群组中的群名片信息
///
/// - Parameter userId: 用户ID
/// - Parameter groupId: 群组ID
/// - Parameter completion: 获取群名片信息完成之后需要执行的Block [userInfo:该用户ID在群组中对应的群名片信息]
///
/// 如果您使用了群名片功能,SDK需要通过您实现的群名片信息提供者,获取用户在群组中的名片信息并显示。
- (void)getUserInfoWithUserId:(NSString *)userId
inGroup:(NSString *)groupId
completion:(void(^)(RCUserInfo *userInfo))completion;

@end

代码示例

以下代码示例来自 TestDemo 项目(GitHub · Gitee) 。

- (void)getUserInfoWithUserId:(NSString *)userId
inGroup:(NSString *)groupId
completion:(void(^)(RCUserInfo *userInfo))completion {
[RCDGroupManager getGroupMemberDetailInfoFromServer:userId
groupId:groupId
complete:^(RCUserInfo *memberInfo) {
return completion(memberInfo);
}];
}

获取群成员信息

可以调用以下方法获取群成员信息(昵称、头像)。SDK 将首先尝试从本地缓存获取数据。如已允许 SDK 进行持久化存储(即已在 RCIMKitClient.h 里开启 enableUserInfoPersistence),SDK 还会尝试从本地数据库中获取群成员信息。

如果本地没有相关信息的数据,则会触发相应的回调方法,从应用层获取数据。

调用示例

[[RCIMKitClient shared] getCachedGroupUserInfo:@"userId" withGroupId:@"groupId"];

刷新群成员信息

您可以通过下面的方法更新 SDK 在本地缓存的群成员信息(昵称、头像)。如已允许 SDK 进行持久化存储(即已在 RCIM.h 里开启 enableUserInfoPersistence),SDK 还会更新本地数据库中的群成员信息。

调用示例

RCUserInfo *user = [[RCUserInfo alloc] initWithUserId:@"userId" name:@"userName" portrait:@"http://portrait"];

[[RCIMKitClient shared] refreshCachedGroupUserInfo:user withGroupId:@"groupId"];

清除群成员信息

您可以通过下面的方法清除 SDK 在本地缓存的群成员信息(昵称、头像)。如已允许 SDK 进行持久化存储(即已在 RCIMKitClient.h 里开启 enableUserInfoPersistence),SDK 还会清除本地数据库中的群成员信息。

调用示例

[[RCIMKitClient shared] clearCachedGroupUserInfo];

设置群成员列表信息

在群组会话页面中使用 @ 等功能时,SDK 需要应用层提供群成员列表。

注意,SDK 不会缓存群成员列表信息。

代理回调

设置代理委托

请在 SDK 初始化之后,连接融云服务器之前设置代理委托。

[RCIMKitClient shared].groupMemberDataSource = self;

代理方法

@protocol RCIMKitGroupMemberDataSource <NSObject>
@optional

/// SDK 的回调,用于向 App 获取当前群组成员列表(需要实现用户信息提供者 RCIMKitUserInfoDataSource)
///
/// - Parameter groupId: 群ID
/// - Parameter resultBlock: 获取成功之后需要执行的Block [userIdList:群成员ID列表]
///
/// SDK通过此方法群组中的成员列表,请在resultBlock中返回该群组ID对应的群成员ID列表。
/// 在您设置了群组成员列表提供者之后,SDK在需要获取群组成员列表的时候,会调用此方法,向您请求群组成员用于显示。
- (void)getAllMembersOfGroup:(NSString *)groupId result:(void(^)(NSArray<NSString *> *userIdList))resultBlock;

@end

代码示例

以下代码示例来自 TestDemo 项目(GitHub · Gitee) 。

- (void)getAllMembersOfGroup:(NSString *)groupId result:(void (^)(NSArray<NSString *> *))resultBlock {
[RCDGroupManager getGroupMembersFromServer:groupId
complete:^(NSArray<NSString *> *_Nonnull memberIdList) {
return resultBlock(memberIdList);
}];
}