項目中涉及到即時通訊模塊、使用了融云的框架、前兩天開始做到頭像昵稱設置、起初按照文檔去做但是就是顯示不正常、后來仔細研究才發現又走到坑里了、今天就系統的說一下其中遇到的問題吧。
首先我們來看看融云的開發文檔中的描述
// RCIM Class
/*!
用戶信息提供者
@discussion SDK需要通過您實現的用戶信息提供者,獲取用戶信息并顯示。
*/
@protocol RCIMUserInfoDataSource <NSObject>
/*!
獲取用戶信息
@param userId 用戶ID
@param completion 獲取用戶信息完成之后需要執行的Block
@param userInfo(in completion) 該用戶ID對應的用戶信息
@discussion SDK通過此方法獲取用戶信息并顯示,請在completion中返回該用戶ID對應的用戶信息。
在您設置了用戶信息提供者之后,SDK在需要顯示用戶信息的時候,會調用此方法,向您請求用戶信息用于顯示。
*/
- (void)getUserInfoWithUserId:(NSString *)userId
completion:(void (^)(RCUserInfo *userInfo))completion;
@end
/*!
群組信息提供者
@discussion SDK需要通過您實現的群組信息提供者,獲取群組信息并顯示。
*/
@protocol RCIMGroupInfoDataSource <NSObject>
/*!
獲取群組信息
@param groupId 群組ID
@param completion 獲取群組信息完成之后需要執行的Block
@param groupInfo(in completion) 該群組ID對應的群組信息
@discussion SDK通過此方法獲取用戶信息并顯示,請在completion的block中返回該用戶ID對應的用戶信息。
在您設置了用戶信息提供者之后,SDK在需要顯示用戶信息的時候,會調用此方法,向您請求用戶信息用于顯示。
*/
- (void)getGroupInfoWithGroupId:(NSString *)groupId
completion:(void (^)(RCGroup *groupInfo))completion;
@end
/*!
用戶信息提供者
@discussion SDK需要通過您實現的用戶信息提供者,獲取用戶信息并顯示。
*/
@property(nonatomic, weak) id<RCIMUserInfoDataSource> userInfoDataSource;
/*!
群組信息提供者
@discussion SDK需要通過您實現的群組信息提供者,獲取群組信息并顯示。
*/
@property(nonatomic, weak) id<RCIMGroupInfoDataSource> groupInfoDataSource;
是不是覺得自己已經秒懂、OK、來自己動手做一做、有沒有感覺有坑了、哈哈、有坑就對了
接下來說說具體的做法:
實際上融云在針對頭像昵稱設置這塊有兩種處理方法、當然、也正是因為有兩種方法、才會讓我們一不小心就被自己坑、好了、我們分別來具體的看看到底有什么區別吧
PlanA:使用消息攜帶用戶信息
這種方式會在每條發送的消息里都攜帶當前登陸用戶的信息,增加消息的長度。
iOS端:
// 設置當前用戶信息
[RCIM sharedRCIM].currentUserInfo = [[RCUserInfo alloc] initWithUserId:@"當前登錄用戶的融云id" name:@"當前登錄用戶的用戶名" portrait:@"用戶頭像的url"];
// 設置消息體內是否攜帶用戶信息
[RCIM sharedRCIM].enableMessageAttachUserInfo = YES;
/*!
是否在發送的所有消息中攜帶當前登錄的用戶信息,默認值為NO
@discussion 如果設置為YES,則會在每一條發送的消息中攜帶當前登錄用戶的用戶信息。
收到一條攜帶了用戶信息的消息,SDK會將其信息加入用戶信息的cache中并顯示;
若消息中不攜帶用戶信息,則仍然會通過用戶信息提供者獲取用戶信息進行顯示。
@warning 需要先設置當前登錄用戶的用戶信息,參考RCIM的currentUserInfo。
*/
@property(nonatomic, assign) BOOL enableMessageAttachUserInfo;
Android端:
/**
* 設置當前用戶信息,
*
* @param userInfo 當前用戶信息
*/
RongIM.getInstance().setCurrentUserInfo(userInfo);
接下來,在 init 之后調用下面方法設置消息攜帶用戶信息。
/**
* 設置消息體內是否攜帶用戶信息。
*
* @param state 是否攜帶用戶信息,true 攜帶,false 不攜帶。
*/
RongIM.getInstance().setMessageAttachedUserInfo(true);
接收方在接收到消息后,SDK 會自動從消息中取出用戶信息,并顯示到 UI 上
以上所述為第一種設置方式,可以看出其實這種方式比較不好的一點就是會在每條消息中都攜帶用戶的個人信息,造成大量的冗余,所以并不是特別推薦的方法。
需要注意的是,如果 安卓端 使用這種方式跟 iOS 互通時,需要 iOS 側也在消息里攜帶用戶信息,這樣才能在兩側都正常顯示昵稱和頭像。
另外,在測試過程中發現,iOS中使用這種方式時會出現一個問題就是:如果你給朋友發消息,發完以后在會話列表頁面,對方如果沒有回復的話,是顯示不出來對方的頭像和昵稱的,只有對方看到消息回復后才會正常顯示,所以說這個也算是一個bug吧。
因此,現在我們來看看第二種方案吧。
PlanB:設置用戶信息提供者
iOS端:
首先遵守協議:RCIMUserInfoDataSource,RCIMGroupInfoDataSource
在- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions方法中 設置代理:
[[RCIM sharedRCIM] setUserInfoDataSource:self];
[[RCIM sharedRCIM] setGroupInfoDataSource:self];
實現代理方法,以個人信息為例:
- (void)getUserInfoWithUserId:(NSString *)userId
completion:(void (^)(RCUserInfo *userInfo))completion
{
if ([userId isEqualToString:@"當前登錄用戶的融云id"]) {
return completion([[RCUserInfo alloc] initWithUserId:userId name:@"當前登錄用戶的用戶名" portrait:@"當前登錄用戶頭像的url"]);
}else
{
根據存儲聯系人信息的模型,通過 userId 來取得對應的name和頭像url,進行以下設置(此處因為項目接口尚未實現,所以就只能這樣給大家說說,請見諒)
return completion([[RCUserInfo alloc] initWithUserId:userId name:@"name" portrait:@"http://pic32.nipic.com/20130827/12906030_123121414000_2.png"]);
}
}
// 從 2.6.0 開始 IMKit 可以緩存用戶信息到數據庫里,開發者可以開啟 RCIM.h 里的enablePersistentUserInfoCache (當然也可以不用寫這個,個人感覺沒有什么顯著的用處)
[RCIM sharedRCIM].enablePersistentUserInfoCache = YES;
/*!
獲取群組信息
@param groupId 群組ID
@param completion 獲取群組信息完成之后需要執行的Block
@param groupInfo(in completion) 該群組ID對應的群組信息
@discussion SDK通過此方法獲取用戶信息并顯示,請在completion的block中返回該用戶ID對應的用戶信息。
在您設置了用戶信息提供者之后,SDK在需要顯示用戶信息的時候,會調用此方法,向您請求用戶信息用于顯示。
*/
- (void)getGroupInfoWithGroupId:(NSString *)groupId
completion:(void (^)(RCGroup *groupInfo))completion
{
// 此處做相應的群組設置即可,獲取群組信息的流程與獲取用戶信息的流程一致
}
刷新 SDK 緩存
當用戶信息或者群組信息發生變化之后,可以調用 RCIM 中的 -refreshUserInfoCache:withUserId: 或 -refreshGroupInfoCache:withGroupId: 方法通知 IMKit 更新緩存
//RCIM Class
/*!
更新SDK中的用戶信息緩存
@param userInfo 需要更新的用戶信息
@param userId 需要更新的用戶ID
@discussion 使用此方法,可以更新SDK緩存的用戶信息。
但是處于性能和使用場景權衡,SDK不會在當前View立即自動刷新(會在切換到其他View的時候再刷新該用戶的顯示信息)。
如果您想立即刷新,您可以在會話列表或者聊天界面reload強制刷新。
*/
- (void)refreshUserInfoCache:(RCUserInfo *)userInfo
withUserId:(NSString *)userId;
/*!
更新SDK中的群組信息緩存
@param groupInfo 需要更新的群組信息
@param groupId 需要更新的群組ID
@discussion 使用此方法,可以更新SDK緩存的群組信息。
但是處于性能和使用場景權衡,SDK不會在當前View立即自動刷新(會在切換到其他View的時候再刷新該群組的顯示信息)。
如果您想立即刷新,您可以在會話列表或者聊天界面reload強制刷新。
*/
- (void)refreshGroupInfoCache:(RCGroup *)groupInfo
withGroupId:(NSString *)groupId;
安卓端:
/**
* 設置用戶信息的提供者,供 RongIM 調用獲取用戶名稱和頭像信息。
*
* @param userInfoProvider 用戶信息提供者。
* @param isCacheUserInfo 設置是否由 IMKit 來緩存用戶信息。<br>
* 如果 App 提供的 UserInfoProvider
* 每次都需要通過網絡請求用戶數據,而不是將用戶數據緩存到本地內存,會影響用戶信息的加載速度;<br>
* 此時最好將本參數設置為 true,由 IMKit 將用戶信息緩存到本地內存中。
* @see UserInfoProvider
*/
RongIM.setUserInfoProvider(new RongIM.UserInfoProvider() {
@Override
public UserInfo getUserInfo(String userId) {
return findUserById(userId);//根據 userId 去你的用戶系統里查詢對應的用戶信息返回給融云 SDK。
}
}, true);
// 開發者自己重寫 findUserById 方法通過if-else獲取用戶信息即可實現.
以上就是第二種方法的設置,其實可以看出我們最好的方法就是使用第二種“設置用戶信息提供者”來顯示頭像昵稱。
簡而言之,在iOS端設置融云頭像和昵稱顯示的時候,步驟就是:
1-遵守協議
RCIMUserInfoDataSource,RCIMGroupInfoDataSource
2-設置代理
[[RCIM sharedRCIM] setUserInfoDataSource:self];
[[RCIM sharedRCIM] setGroupInfoDataSource:self];
3-實現代理方法(if-else判斷是否是當前用戶,進行對應的屬性設置即可)
- (void)getUserInfoWithUserId:(NSString *)userId
completion:(void (^)(RCUserInfo *userInfo))completion;
- (void)getGroupInfoWithGroupId:(NSString *)groupId
completion:(void (^)(RCGroup *groupInfo))completion;
另外,最重要的一點就是不要將兩種方法混在一起使用,這樣會造成不必要的bug。
以上就是關于融云頭像昵稱設置的相關內容,希望可以對大家有所幫助
我是姣爺,我在簡書,和你們一起,加油,
康撒哈米噠~~~