融云即时通讯（一）

第一次写文章，用来记录自己研究的融云iOS开发。

http://www.rongcloud.cn/docs/ios.html 这个是官方的文档，看了非常有帮助，有不懂的也可以查询。

（1） 使用cocoa pods导入，使用[[RCIMsharedRCIM]initWithAppKey:AppKey]类方法，连接融云服务器。

（2）[[RCIMsharedRCIM]connectWithToken:APPTokensuccess:^(NSString *userId) {

        NSLog(@"登陆成功。当前登录的用户ID：%@", userId);

    } error:^(RCConnectErrorCode status) {

        NSLog(@"登陆的错误码为:%ld", (long)status);

    } tokenIncorrect:^{

        //token过期或者不正确。

        //如果设置了token有效期并且token过期，请重新请求您的服务器获取新的token

        //如果没有设置token有效期却提示token错误，请检查您客户端和服务器的appkey是否匹配，还有检查您获取token的流程。

        NSLog(@"token错误");

    }];

使用上面的方法通过token值登陆，这里要说的是token值要通过请求获取，融云建议的是自己公司的服务器端向融云服务器请求，然后再由app端向自己公司的服务器请求，这是为了安全考虑。在自己测试时可以自己写个请求方法，要注意设置请求头，具体的可以自行百度，也可以使用融云的api调试工具获取token。（提示一下，如果很久以前申请的app应用信息可能会出现请求失败，我就被坑了很久，然后重新申请了一个应用）。

（3）一对一的聊天窗口

    RCConversationViewController *chat = [[RCConversationViewControlleralloc]init];

    //设置会话的类型，如单聊、讨论组、群聊、聊天室、客服、公众服务会话等

    chat.conversationType =ConversationType_PRIVATE;

    //设置会话的目标会话ID。（单聊、客服、公众服务会话为对方的ID，讨论组、群聊、聊天室为会话的ID）

    chat.targetId =@"对方的id";

    //设置聊天会话界面要显示的标题

    chat.title =@"想显示的会话标题";

    //显示聊天会话界面

    [self.navigationControllerpushViewController:chatanimated:YES];

使用上面的方法就能进入集成好的聊天页面了

（4）用户的头像和昵称显示

这里融云是没有方法直接获取头像和昵称的数据的，所以我们需要通过自己公司服务器获取和存储数据，然后设置数据。

<RCIMUserInfoDataSource>实现代理

[[RCIMsharedRCIM]setUserInfoDataSource:self];

需要重写这个代理方法

- (void)getUserInfoWithUserId:(NSString *)userId completion:(void (^)(RCUserInfo *))completion{

        RCUserInfo *userinfo = [[RCUserInfoalloc]init];

        userinfo.userId = userId;

//通过网络请求获取name和URL

        userinfo.name =@“name”;

        NSString *image =@"http://tx.haiqq.com/uploads/allimg/160417/1_041F15KK0L.jpg"; //头像的url

        completion(userinfo);

}

当进入到聊天界面的时候系统会自动调用这个代理方法设置，注意测试的时候使用图片不能太大，不然显示不出来，不要超过200*200，最好是100*100以内

这时候就会显示出头像和昵称了。融云还提供了刷新用户信息的方法，不过只是在推送时用到。

- (void)refreshUserInfoCache:(RCUserInfo *)userInfo withUserId:(NSString *)userId;//通过单例调用

设置当前的用户信息

[RCIMsharedRCIM].currentUserInfo = userinfo;

[RCIMsharedRCIM].globalConversationAvatarStyle =RC_USER_AVATAR_CYCLE;//设置头像是圆形还是方形，默认是方形，聊天列表

[RCIMsharedRCIM].globalConversationPortraitSize =CGSizeMake(50,50);//设置头像大小，默认是46*46，设置时必须大于36*36，否则无效

    [RCIMsharedRCIM].globalMessageAvatarStyle =RC_USER_AVATAR_CYCLE;//聊天对话窗口

[RCIMsharedRCIM].globalMessagePortraitSize = CGSizeMake(50,50);

（5）聊天列表的显示

这里是自己新建一个类 YourTestChatViewController ，继承自RCConversationListViewController

- (void)viewDidLoad {

    //重写显示相关的接口，必须先调用super，否则会屏蔽SDK默认的处理

    [superviewDidLoad];

    

    //设置需要显示哪些类型的会话

    [selfsetDisplayConversationTypes:@[@(ConversationType_PRIVATE),

                                        @(ConversationType_DISCUSSION),

                                        @(ConversationType_CHATROOM),

                                        @(ConversationType_GROUP),

                                        @(ConversationType_APPSERVICE),

                                        @(ConversationType_SYSTEM)]];

    //设置需要将哪些类型的会话在会话列表中聚合显示

    [selfsetCollectionConversationType:@[@(ConversationType_DISCUSSION),

                                          @(ConversationType_GROUP)]];

}

- (void)onSelectedTableRow:(RCConversationModelType)conversationModelType

         conversationModel:(RCConversationModel *)model

               atIndexPath:(NSIndexPath *)indexPath {

    RCConversationViewController *conversationVC = [[RCConversationViewControlleralloc]init];

    conversationVC.conversationType = model.conversationType;

    conversationVC.targetId = model.targetId;

    conversationVC.title =@"想要的title";

    [self.navigationControllerpushViewController:conversationVCanimated:YES];

}

这两个方法是直接融云文档上抄的，还没研究过，不过显示的是一个对话的列表页面。

（6）讨论组和聊天室创建

讨论组

 NSArray *array = [NSArrayarrayWithObjects:@"111",@"123",@"0001",@"0002",nil];

    [[RCIMsharedRCIM] createDiscussion:@"讨论组"userIdList:array success:^(RCDiscussion *discussion) {

        dispatch_sync(dispatch_get_main_queue(), ^{//这个必须是在主线程执行，因为融云的讨论组创建方法是在子线程创建的，所以不调用主线程就不能跳转

            [selfset:discussion];

        });        

    } error:^(RCErrorCode status) {

        NSLog(@"%ld",(long)status);

    }];

- (void)set:(RCDiscussion *)discussion{

    RCConversationViewController *chatRoom = [[RCConversationViewControlleralloc]init];

    chatRoom.conversationType =ConversationType_DISCUSSION;

    chatRoom.targetId = discussion.discussionId;

    chatRoom.title = discussion.discussionName;

    //设置加入聊天室时需要获取的历史消息数量，最大值为50

    chatRoom.defaultHistoryMessageCountOfChatRoom =20;

    [self.navigationControllerpushViewController:chatRoomanimated:YES];

}

聊天室

RCConversationViewController *chat = [[RCConversationViewController alloc]init];

        //设置会话的类型为聊天室

        chat.conversationType = ConversationType_CHATROOM;

        //设置会话的目标会话ID

        chat.targetId = @"123456";

        //设置聊天会话界面要显示的标题

        chat.title = @"聊天室";

        //设置加入聊天室时需要获取的历史消息数量，最大值为50

        chat.defaultHistoryMessageCountOfChatRoom = 20;

        //显示聊天会话界面

        [self.navigationController pushViewController:chat animated:YES];

（7）获取对话列表

NSArray *array = [NSArrayarrayWithObjects:[NSNumbernumberWithInteger:ConversationType_PRIVATE],[NSNumbernumberWithInteger:ConversationType_DISCUSSION],nil];

    NSArray *listArray = [[RCIMClient sharedRCIMClient]getConversationList:array];

（8）扩展功能板块的自定义

首先要新建一个类，继承自RCConversationViewController

- (void)viewDidLoad {

    [superviewDidLoad];

    // Do any additional setup after loading the view.

    [self.pluginBoardView insertItemWithImage:imagePic

                                        title:title

                                      atIndex:0

                                          tag:101];

//    或添加到最后的：

    [self.pluginBoardView insertItemWithImage:imagePic

                                        title:title

                                          tag:101];

//    删除指定位置的方法：

    [self.pluginBoardViewremoveItemAtIndex:0];

//    删除指定标签的方法：

    [self.pluginBoardViewremoveItemWithTag:101];

//    删除所有：

    [self.pluginBoardViewremoveAllItems];

//    更换现有扩展项的图标和标题:

    [self.pluginBoardView updateItemAtIndex:0 image:newImage title:newTitle];

//    或者根据tag来更换

    [self.pluginBoardView updateItemWithTag:101 image:newImage title:newTitle];

}

//重写点击方法

- (void)pluginBoardView:(RCPluginBoardView *)pluginBoardView clickedItemWithTag:(NSInteger)tag{

//系统本来带有3个扩展功能，tag＝1001是照片，tag＝1002是拍照，tag＝1003是定位

    [superpluginBoardView:pluginBoardViewclickedItemWithTag:tag];

    if (tag ==101) {

        //点击事件处理

    }

}

(10)改变聊天背景

在 RCConversationViewController 的继承类的 viewDidLoad 方法中，加入以下代码即可设置聊天界面背景图：

self.conversationMessageCollectionView.backgroundView=[[UIImageView alloc]initWithImage:[UIImage imageNamed:@"图片名"]];

但是上面的方法在frame变换时会变形，下面可以解决

//设置conversationMessageCollectionView的背景色为透明

    self.conversationMessageCollectionView.backgroundColor = [UIColorclearColor];

    //设置self.view.backgroundColor用自己的背景图片

    self.view.backgroundColor = [UIColorcolorWithPatternImage:[UIImageimageNamed:@""]];

（11）发送消息

- (void)sendMessage:(RCMessageContent *)messageContent pushContent:(NSString *)pushContent; //文字

- (void)sendImageMessage:(RCImageMessage *)imageMessage pushContent:(NSString *)pushContent; //图片

- (void)resendMessage:(RCMessageContent *)messageContent;//重新发送

- (void)deleteMessage:(RCMessageModel *)model;//删除消息

总结一下，使用IMKit框架的话，融云有继承好的RCConversationViewController类，直接调用就可以用，也可以自己写一个类，继承自RCConversationViewController，在用到的方法里面使用［super 。。。］就可以使用融云添加好的方法，后面可以自己添加想要的内容，在聊天界面需要使用的接口操作可以查看RCConversationViewController.h，里面方法介绍很详细也很全面。如果还需要功能只能自己写或者在融云上提交工单，申请开发。