1.前言
2.融云聊天的實現(xiàn)
3.自定義消息類型和自定義消息cell
4.融云使用過程中出現(xiàn)的問題及解決方法
5.結(jié)語
1.前言
之前做過一個項目的聊天是是基于 XMPP 協(xié)議，所有的東西都是自己寫的，工程量大，而且會出現(xiàn)各種各樣得問題，丟失消息的問題，所以新進入一家公司之后重新做一個項目給老板推薦聊天使用第三方的，最后權(quán)衡選擇了融云即時通訊。
2.融云聊天的實現(xiàn)
關(guān)于在融云上創(chuàng)建自己的應(yīng)用、集成 SDK、初始化等一些基本的我們在這就不多說了，按照他的教程可以很容易的完成。
①會話列表的實現(xiàn)
會話列表的實現(xiàn)其實也很簡單，就是創(chuàng)建一個繼承于RCConversationListViewController的控制器，然后重寫 init 的方法，這個里邊我們需要設(shè)定需要顯示的會話類型。
-(id)init{
self = [super init];
/**
<設(shè)置會話列表頭像為圓形>
**/
[self setConversationAvatarStyle:RC_USER_AVATAR_CYCLE];
if (self) {
//設(shè)置需要顯示哪些類型的會話
[self setDisplayConversationTypes:@[@(ConversationType_PRIVATE),
@(ConversationType_DISCUSSION),
@(ConversationType_CHATROOM),
@(ConversationType_GROUP),
@(ConversationType_APPSERVICE),
@(ConversationType_SYSTEM)]];
//設(shè)置需要將哪些類型的會話在會話列表中聚合顯示
[self setCollectionConversationType:@[@(ConversationType_DISCUSSION),
@(ConversationType_SYSTEM)]];
}
return self;
}
然后就是在- (void)viewWillAppear:(BOOL)animated寫一些界面將要顯示的時候的一些邏輯操作，比如提示新消息的小圓點或者消息數(shù)等。
- (void)viewWillAppear:(BOOL)animated{
[super viewWillAppear:animated];
/*更新底部紅點狀態(tài) 點擊cell讀取消息后 要刷新底部紅點*/
[[TJNotification sharedTJNotification]refreshNotificationPrompt];
}
之后再viewDidLoad里邊設(shè)定一些會話列表界面的一些屬性，設(shè)定刷新菊花、沒有消息時候的背景視圖、需要置頂?shù)臅挼鹊?/p>
- (void)viewDidLoad {
[super viewDidLoad];
/*設(shè)置默認屬性*/
self.conversationListTableView.separatorStyle = UITableViewCellSeparatorStyleSingleLine;
self.conversationListTableView.backgroundColor = [UIColor tj_mainColor];
self.edgesForExtendedLayout = UIRectEdgeNone;
UIView *footerView = [[UIView alloc] initWithFrame:CGRectMake(0, 0, SCREEN_WIDTH, 150)];
footerView.backgroundColor = [UIColor tj_mainColor];
self.conversationListTableView.tableFooterView = footerView;
self.emptyConversationView = self.noMessage;
//置頂特定UID 的會話
[[RCIMClient sharedRCIMClient] setConversationToTop:6 targetId:@"tanjie_user_1.0_2017" isTop:YES];
}
然后就是融云自己的一些方法根據(jù)我們的功能需要需要我們自己重寫，下面我就列舉兩個比較重要的，如果自己需要這些邏輯的話就可以重寫這些方法，
/*!
即將加載列表數(shù)據(jù)源的回調(diào)
@param dataSource 即將加載的列表數(shù)據(jù)源（元素為RCConversationModel對象）
@return 修改后的數(shù)據(jù)源（元素為RCConversationModel對象）
@discussion 您可以在回調(diào)中修改、添加、刪除數(shù)據(jù)源的元素來定制顯示的內(nèi)容，會話列表會根據(jù)您返回的修改后的數(shù)據(jù)源進行顯示。
數(shù)據(jù)源中存放的元素為會話Cell的數(shù)據(jù)模型，即RCConversationModel對象。
*/
- (NSMutableArray *)willReloadTableData:(NSMutableArray *)dataSource;
/*!
即將顯示Cell的回調(diào)
@param cell 即將顯示的Cell
@param indexPath 該Cell對應(yīng)的會話Cell數(shù)據(jù)模型在數(shù)據(jù)源中的索引值
@discussion 您可以在此回調(diào)中修改Cell的一些顯示屬性。
*/
- (void)willDisplayConversationTableCell:(RCConversationBaseCell *)cell
atIndexPath:(NSIndexPath *)indexPath;
緊接著我們需要點擊會話跳轉(zhuǎn)到會話界面，我們需要重寫這個方法。
- (void)onSelectedTableRow:(RCConversationModelType)conversationModelType conversationModel:(RCConversationModel *)model atIndexPath:(NSIndexPath *)indexPath
{
//我們把我們自己設(shè)定的兩個客服消息聚合到了一個會話里邊，所以這里根據(jù)消息類型跳轉(zhuǎn)不同的界面
if (conversationModelType == RC_CONVERSATION_MODEL_TYPE_COLLECTION){
TJChatListViewController *chatListVC = [[TJChatListViewController alloc]init];
NSArray *array = [NSArray arrayWithObject:[NSNumber numberWithInt:model.conversationType]];
[chatListVC setDisplayConversationTypes:array];
[chatListVC setCollectionConversationType:nil];
chatListVC.isEnteredToCollectionViewController = YES;
[self.navigationController pushViewController:chatListVC animated:YES];
}
else if (model.conversationModelType == ConversationType_PRIVATE){
TJConversationViewController *conversationVC = [[TJConversationViewController alloc]init];
conversationVC.conversationType =model.conversationType;
conversationVC.targetId = model.targetId;
conversationVC.title = model.conversationTitle;
[self.navigationController pushViewController:conversationVC animated:YES];
//解決鍵盤遮擋消息問題
[IQKeyboardManager sharedManager].enable = NO;
}
}
接著就是我們希望能刪除會話列表的某個會話，這時候我們需要重寫下面的方法
- (void)didDeleteConversationCell:(RCConversationModel *)model{
[[RCIMClient sharedRCIMClient] clearMessages:ConversationType_PRIVATE targetId:model.targetId];
RCIMClient *rcim = [[RCIMClient alloc]init];
//獲取未讀消息數(shù)
NSUInteger a = [rcim getUnreadCount:@[@(ConversationType_PRIVATE),@(ConversationType_SYSTEM)]];
//把未讀消息數(shù)賦值給單例，改變未讀消息數(shù)小紅點提示數(shù)
[TJMessageCount sharedTJMessageCount].messageCount = a;
}
最后如果你們自己的項目需要一些自定義的功能，比如自定義消息列表什么的，或者設(shè)置沒有消息的時候的占位圖等，那就根據(jù)自己的邏輯寫。
②會話界面的實現(xiàn)
會話界面的實現(xiàn)我們需要寫一個繼承于RCConversationViewController的控制器，因為為了知道我們是跟誰聊天的，所以我們要暴露一個UID給其他需要聊天的界面使用，到時候把 UID 傳到這個界面，如果沒有其他的邏輯，就簡單的聊天，寫到這里這個界面就可以了，但是如果你需要其他的功能操作，這個控制器我們還需要重寫其他的一些方法。由于融云提供的功能太多，我就不一一寫了，總之點進去RCConversationViewController這個控制器挑選你需要的功能。
/*!
點擊Cell中頭像的回調(diào)
@param userId 點擊頭像對應(yīng)的用戶ID
*/
- (void)didTapCellPortrait:(NSString *)userId;
/*!
長按Cell中頭像的回調(diào)
@param userId 頭像對應(yīng)的用戶ID
*/
- (void)didLongPressCellPortrait:(NSString *)userId;
這里說一下下邊的功能面板上添加的東西，我們可以自定義我們需要的功能圖標，但是自定義功能的按鈕的 tag 值盡量別選1開頭的，因為融云的功能按鈕的 tag 值都是以1開頭的，避免重復(fù)
// 在功能面板上插入一個Item，并標記tag，方便區(qū)分
[self.pluginBoardView insertItemWithImage:[UIImage imageNamed:@"tj_home_share_commodity_icon"]
title:@"文件"
tag:201];
下邊我們要重寫自定義擴展面板的回調(diào)方法
- (void)pluginBoardView:(RCPluginBoardView *)pluginBoardView clickedItemWithTag:(NSInteger)tag{
switch (tag) {
case 201:
{
[super pluginBoardView:pluginBoardView clickedItemWithTag:tag];//記得調(diào)用super父類的方法·
NSLog(@"shipin");
}
break;
default:
[super pluginBoardView:pluginBoardView clickedItemWithTag:tag];
NSLog(@"%ld",(long)pluginBoardView.tag);
break;
}
}
自定義消息類型和消息cell
這個功能的實現(xiàn)，我們需要做些什么工作呢？
第一步
肯定的是我們需要寫一個繼承與融云消息類RCMessageContent的類，具體怎么寫下面詳細說
第二步
我們需要寫一個繼承與融云消息cell的RCMessageCell的類，這個和我們平時 tableView 的 cell 自定義的書寫差不多
第三步
我們需要做的工作就是注冊一個消息類型(就是我們第一步寫的那個自定義的消息類)，這個注冊的消息類型最好注冊在我們專門寫的融云 delegate 的分類里邊，每次啟動 APP 都會走一遍，如果考慮到啟動時間，性能問題也可以在發(fā)送消息的時候注冊，這個看自己的取舍來決定注冊的位置
第四步
在會話界面注冊一個我們第二步寫的消息卡片 cell，到這里基本上自定義消息類型和消息 cell 已經(jīng)完成了
繼承融云消息類RCMessageContent
繼承這個類，融云怎么實現(xiàn)聊天的我們都要重寫，包括消息的編碼和解碼，以及包含在消息里邊的信息呈現(xiàn)在自定義的消息 cell 上所以我們要繼承NSCoding和RCMessageContentView協(xié)議，
自定義消息類 .h
#import <RongIMLib/RongIMLib.h>
#import <RongIMLib/RCMessageContentView.h>
//這個是自定義消息的標識符，和安卓端對接用的
#define RCLocalMessageTypeIdentifier @"App:SimpleMsg"
@interface TJShopingDetailMessageContent : RCMessageContent<NSCoding,RCMessageContentView>
//下面這兩個是我們發(fā)送消息對應(yīng)我們需要的鍵
@property(nonatomic,strong)NSString *content;
@property(nonatomic, strong) NSString* extra;
+(instancetype)messageWithContent:(NSString *)content;
@end
自定義消息類 .m
首先就是我們需要判定接收到的和發(fā)送的消息是不是我們自定義的消息，然后需要編碼還是解碼，需要把消息轉(zhuǎn)換成可讀的或者可以發(fā)送的格式，比如接收到的我們要解碼然后轉(zhuǎn)換成 json 類型的；
#import "TJShopingDetailMessageContent.h"
@implementation TJShopingDetailMessageContent
+(instancetype)messageWithContent:(NSString *)content {
TJShopingDetailMessageContent *msg = [[TJShopingDetailMessageContent alloc] init];
if (msg) {
msg.content = content;
}
return msg;
}
//存儲狀態(tài)和是否計入未讀數(shù)
+(RCMessagePersistent)persistentFlag {
//存儲并計入未讀數(shù)
return (MessagePersistent_ISCOUNTED);
}
#pragma mark – NSCoding protocol methods
#define KEY_TXTMSG_CONTENT @"content"
#define KEY_TXTMSG_EXTRA @"extra"
- (instancetype)initWithCoder:(NSCoder *)aDecoder
{
self = [super init];
if (self) {
self.content = [aDecoder decodeObjectForKey:KEY_TXTMSG_CONTENT];
self.extra = [aDecoder decodeObjectForKey:KEY_TXTMSG_EXTRA]; }
return self;
}
- (void)encodeWithCoder:(NSCoder *)aCoder
{
[aCoder encodeObject:self.content forKey:KEY_TXTMSG_CONTENT];
[aCoder encodeObject:self.extra forKey:KEY_TXTMSG_EXTRA];
}
#pragma mark – RCMessageCoding delegate methods
///將消息內(nèi)容編碼成json
-(NSData *)encode {
NSMutableDictionary *dataDict=[NSMutableDictionary dictionary];
[dataDict setObject:self.content forKey:@"content"];
if (self.extra) {
[dataDict setObject:self.extra forKey:@"extra"];
}
NSData *data = [NSJSONSerialization dataWithJSONObject:dataDict
options:kNilOptions
error:nil];
return data;
}
//將json解碼生成消息內(nèi)容
-(void)decodeWithData:(NSData *)data {
__autoreleasing NSError* __error = nil;
if (!data) {
return;
}
NSDictionary *dictionary = [NSJSONSerialization JSONObjectWithData:data
options:kNilOptions
error:&__error];
NSLog(@"dictionary == %@",dictionary);
if ([dictionary objectForKey:@"content"]) {
self.content = dictionary[@"content"];
NSLog(@"dictionary1111 == %@",dictionary[@"content"]);
self.extra = dictionary[@"extra"];
}else{
NSError *error;
NSData *data = [NSJSONSerialization dataWithJSONObject:dictionary options:kNilOptions error:nil];
NSString *content ;
if (!data) {
NSLog(@"%@",error);
}else{
content = [[NSString alloc]initWithData:data encoding:NSUTF8StringEncoding];
}
self.content = content;
}
}
//您定義的消息類型名，需要在各個平臺上保持一致，以保證消息互通,別以 RC 開頭，以免和融云系統(tǒng)沖突
+(NSString *)getObjectName {
return RCLocalMessageTypeIdentifier;
}
//最后一條消息是自定義消息的時候，可以更改在會話列表顯示的類型，為了區(qū)分消息類型
- (NSString *)conversationDigest
{
NSString *contentStr = @"【商品信息】";
return contentStr;
}
這樣我們自定義的消息類型已經(jīng)完成了，不過你還想完善一下就在這幾個方法里添加你想要的邏輯代碼。
自定義消息cell .h
這個和平時自定義 cell 一樣，只不過 model 不用我們創(chuàng)建，融云的就行，但是融云的 cell你要去他官方文檔看，看了才能為所欲為的去寫，其實和平常 自定義cell不一樣的就只有高度問題，他有一個extraHeight高度，就是是Cell根據(jù)界面上下文，需要額外顯示的高度（比如時間、用戶名的高度等），一般Cell的高度應(yīng)該是內(nèi)容顯示的高度再加上extraHeight的高度。
#import <RongIMKit/RongIMKit.h>
@interface TJShopingDetailMessageCell : RCMessageCell
@property(nonatomic, strong) UIImageView *bubbleBackgroundView;
@property(nonatomic,strong)UIImageView *contentImageView;
@property (nonatomic , strong)UILabel *titleNameLabel;
@property (nonatomic , strong)UILabel *priceLabel;
- (void)setDataModel:(RCMessageModel *)model;
- (void)initialize;
@end
自定義消息 cell .m
//當應(yīng)用自定義消息時，必須實現(xiàn)該方法來返回cell的Size
+ (CGSize)sizeForMessageModel:(RCMessageModel *)model
withCollectionViewWidth:(CGFloat)collectionViewWidth
referenceExtraHeight:(CGFloat)extraHeight {
//這里我們設(shè)定的高度是120，所以加上extraHeight
return CGSizeMake(ScreenWidth , 120*ADAPTERWIDTH + extraHeight);
}
//model 的 set 方法
- (void)setDataModel:(RCMessageModel *)model {
[super setDataModel:model];
[self setAutoLayout:model];
}
//布局我們可以寫在這個里邊
- (void)setAutoLayout:(RCMessageModel *)model{
//接收到的消息我們需要拿到需要的數(shù)據(jù)，賦值到自定義 cell 的控件上
TJShopingDetailMessageContent *shopingDetailContent = (TJShopingDetailMessageContent *)self.model.content;
if (shopingDetailContent) {
NSData *jsonData = [shopingDetailContent.content dataUsingEncoding:NSUTF8StringEncoding];
NSError *err;
NSDictionary *dic = [NSJSONSerialization JSONObjectWithData:jsonData
options:NSJSONReadingMutableContainers
error:&err];
NSLog(@"dic == %@",dic);
/******************自定義消息 cell 的布局和賦值************/
}
注冊消息類型和消息 cell
自定義的消息類型我是注冊在融云 delegate 的分類里，自定義消息的 cell 我注冊在會話控制器里
// 注冊自定義測試消息
[[RCIM sharedRCIM] registerMessageType:[TJShopingDetailMessageContent class]];
//注冊自定義消息Cell
[self registerClass:[TJShopingDetailMessageCell class] forMessageClass:[TJShopingDetailMessageContent class]];
差不多到這所有的都完成了，但是當我們和安卓端對接的時候問題出來了，找了好久找到了問題的所在，希望大家不要犯同樣的錯誤，當時我們安卓端發(fā)送的消息數(shù)據(jù)和我們這邊解析的數(shù)據(jù)格式不一樣，導(dǎo)致拿不到數(shù)據(jù)，最后我們重新設(shè)置了消息的格式解決了這個問題。
融云使用過程中出現(xiàn)的問題
估計使用融云的過程中會出現(xiàn)很多問題，我來列舉幾個，頭像不顯示問題、聊天時鍵盤遮擋消息內(nèi)容問題、頭像不能及時更新問題、用戶名顯示成 UID 問題、發(fā)送位置界面導(dǎo)航欄顏色問題等等。(太多了想不起來了，等到遇到問題的老哥問到了再說)
先說頭像和用戶名問題
都知道融云的頭像顯示有兩種方法，一種是發(fā)送消息體，打開就行了，但是有一個很大的弊端，就是如果你給一個聊天對象發(fā)送消息，他不回復(fù)你你是看不到他的頭像和用戶名的，而且發(fā)送消息體里邊帶有用戶信息，對發(fā)送消息的速度也會有一定的影響，而且還會浪費用戶的流量，一般這種都會用到自定義消息類型上，比如我們上邊的發(fā)送卡片，可以附帶一些我們需要展示的數(shù)據(jù)內(nèi)容，所以我們一般頭像顯示都會用另一種“用戶信息代理函數(shù)”，這種方法的原理就是，當我們改變頭像的時候，上傳頭像和用戶名到融云的 SDK，當我們發(fā)送消息的時候，他會去SDK 找看是否有這個用戶的頭像和用戶名，這樣是不是很方便。下面我們具體說一下怎么實現(xiàn)。
當時我用了第一種方法，因為簡單，一句代碼就搞定了，但是出現(xiàn)了對方?jīng)]有回復(fù)的時候，頭像顯示的是藍色的融云默認沒有頭像的圖片，用戶名顯示的是對方用戶名的 UID，一大串看著都難受。我就想到了用[self refreshConversationTableViewIfNeeded]這句代碼強刷界面，(但是這個方法盡量別用，融云已經(jīng)使用過這個方法刷新過界面了，使用不當特別消耗性能)你肯定想想不到成功了，但是出現(xiàn)了另一個問題，在那個聊天界面同級的界面都變得特別卡，打印一下數(shù)據(jù)，能看到一直在刷新，很可怕，所以這種方法肯定不行。
說實在的，融云的官方文檔寫的很亂，看了一遍又一遍都沒找到頭緒，就直接找融云的客服，他給我說頭像顯示要“用戶信息代理函數(shù)”，然后我才解決了所以的頭像問題，下面貼上具體的實現(xiàn)。
在融云 delegate 的分類里遵循這個數(shù)據(jù)源RCIMUserInfoDataSource,然后實現(xiàn)他的數(shù)據(jù)源方法，因為我們的用戶的身份比較多，所以根據(jù)傳過來的 UID進行了判斷
//數(shù)據(jù)信息代理方法
- (void)getUserInfoWithUserId:(NSString *)userId
completion:(void (^)(RCUserInfo *userInfo))completion{
NSString *uid = [TJAccountHelp sharedTJAccountHelp]._id;
NSString *head = [TJAccountHelp sharedTJAccountHelp].head;
if ([userId isEqualToString:uid]) {
RCUserInfo *userInfo = [[RCUserInfo alloc]init];
userInfo.userId = userId;
userInfo.name = [TJAccountHelp sharedTJAccountHelp].name;
userInfo.portraitUri = head;
return completion(userInfo);
}else if([userId isEqualToString:@"tanjie_user_1.0_2017"]) {
RCUserInfo *otherUser = [[RCUserInfo alloc]init];
otherUser.userId = userId;
otherUser.portraitUri = @"https://static.tanjie.shop/tanjie/tanjie.jpg";
otherUser.name = @"探街小弟";
return completion(otherUser);
}else if ([userId isEqualToString:@"tanjie_kefu_1"]) {
RCUserInfo *otherUser = [[RCUserInfo alloc]init];
otherUser.userId = userId;
otherUser.portraitUri = @"https://static.tanjie.shop/tanjie/tanjie.jpg";
otherUser.name = @"客服1";
return completion(otherUser);
}else if ([userId isEqualToString:@"tanjie_kefu_2"]) {
RCUserInfo *otherUser = [[RCUserInfo alloc]init];
otherUser.userId = userId;
otherUser.portraitUri = @"https://static.tanjie.shop/tanjie/tanjie.jpg";
otherUser.name = @"客服2";
return completion(otherUser);
}else{
RCUserInfo *otherUser = [[RCUserInfo alloc]init];
otherUser.userId = userId;
NSDictionary *dic = [[NSDictionary alloc]init];
dic = @{@"userid":userId};
[TJNetRequest postDictRequestWithURL:TJ_User_FindHeadName_URl parameters:dic success:^(id response) {
@try {
if ([self tj_requestSuccess:response]) {
NSDictionary *dict = [[NSDictionary alloc]init];
dict = response[@"obj"];
if ([dict[@"head"] isEqual:[NSNull null]]) {
otherUser.portraitUri = @"https://static.tanjie.shop/tanjie/defualt.jpg";
}else{
otherUser.portraitUri = dict[@"head"];
}
otherUser.name = dict[@"name"];
// 解決異步請求數(shù)據(jù)第一次不顯示頭像用戶名問題
completion(otherUser);
}
} @catch (NSException *exception) {
} @finally {
}
} failure:^(NSError *error) {
}];
}
}
做到這還沒完呢，如果你要是請求的服務(wù)器數(shù)據(jù)，一定要注意網(wǎng)絡(luò)請求，如果用的你們封裝好的請求方式，大多都是異步請求，就會出現(xiàn)第一次進入會話列表界面的時候還是不顯示頭像和用戶名，再次進入才顯示，所以具體怎么顯示你自己處理。大概到這里頭像和用戶名問題就解決了。
鍵盤問題
鍵盤問題其實很簡單，一句代碼就行了，如果你使用了第三方庫，在會話界面添加一句代碼
//解決鍵盤遮擋消息內(nèi)容
[[IQKeyboardManager sharedManager] setEnable:NO];
/*解決點擊系統(tǒng)鍵盤的語音按鈕，導(dǎo)致輸入工具欄被遮擋*/
- (void)keyboardWillShowNotification:(NSNotification *)notification {
if(!self.chatSessionInputBarControl.inputTextView.isFirstResponder)
{
[self.chatSessionInputBarControl.inputTextView becomeFirstResponder];
}
}
發(fā)送位置界面導(dǎo)航欄顏色問題
在融云 delegate 的分類里邊加一句代碼
[[UINavigationBar appearance] setBarTintColor:[UIColor tj_navBgColor]];
結(jié)語
以前特別喜歡過年，回來家里人一塊聊聊天，打打牌，但是今年我特別討厭過年，可能年齡大了，不是被逼婚就是在我面前說一些周圍的孩子考了什么公務(wù)員，什么事業(yè)單位啦，聽著就難受，自己不喜歡那種工作狀態(tài)才選擇了技術(shù)類的工作，跟他們說不下去了，就自己待著逛一下論壇，寫一下這一年因為工作忙欠下的文章。就這樣一年過去了。有喜歡的可以點個喜歡，不管有什么問題都可以留言問我，能幫忙的肯定幫忙。
