实现两个不同APP之间的聊天功能原创
财税管理
IT技术
金蝶云社区-honey缘木鱼
honey缘木鱼
1人赞赏了该文章 1,869次浏览 未经作者许可，禁止转载编辑于2019年04月17日 10:14:46
summary-icon摘要由AI智能服务提供

本文介绍了在一个新项目中实现跨APP即时通讯的过程，作者选择了容云（而非环信）作为第三方框架。文章详细说明了从注册获取App Key、下载SDK、SDK集成、到IMLib和IMKit使用的全过程。其中，涉及了SDK的手动集成、初始化与连接服务器、会话列表和会话页面的快速启动与定制、用户信息的获取与显示、消息缓存与推送设置等关键环节。特别提到了在Xcode和iOS新版本中的注意事项，如系统库依赖变更，以及如何通过容云SDK处理用户信息、消息缓存和推送等核心功能。

以前做过聊天的项目，群聊和单聊都是在一个项目中进行的，这次的项目需求是在不同的APP中实现即时通讯，想着很复杂的样子，没想到实现起来那么容易。

一.选择第三方框架（环信？，容云?）

上次做聊天功能时用的容云，这次本想着用下环信，看环信API时，真心感到累！不能浪费太长时间，于是最后的决定还是容云吧！

二.注册获得App Key和下载SDK

  1. 注册登录后，在容云的控制台获得App Key。


    2.选择自己需要的功能去官网下载

    下载SDK

三.SDK 集成(手动集成)

1.把下载IMLib和IMKit 手动拖到自己的项目中。


2.添加系统库依赖


注：苹果在 XCode10 和 iOS12 中移除了 libstdc++ 这个库,由 libc++ 这个库取而代之。


  1. 在 Xcode 项目 Build Settings -> Other Linker Flags 中，增加 "-ObjC"。

  2. 在 Xcode 项目 Build Settings->Search Paths 中SDK路径是否正确。


四.IMLib和IMKit 的使用

  1. 初始化
    在AppDelegate.m文件中引入头文件#import <RongIMKit/RongIMKit.h>

  //初始化融云SDK appKey即是在容云控制台获得的
    [[RCIM sharedRCIM] initWithAppKey:@“3argexb6**ve”];

2.连接融云服务器

[[RCIM sharedRCIM] connectWithToken:@"YourTestUserToken"  success:^(NSString *userId) {    NSLog(@"登陆成功。当前登录的用户ID：%@", userId);
} error:^(RCConnectErrorCode status) {  
  NSLog(@"登陆的错误码为:%d", status);
} tokenIncorrect:^{  
  //token过期或者不正确。
    //如果设置了token有效期并且token过期，请重新请求您的服务器获取新的token
    //如果没有设置token有效期却提示token错误，请检查您客户端和服务器的appkey是否匹配，还有检查您获取token的流程。
    NSLog(@"token错误");
}];

注:
(1).如何获取token？


必须在服务器端请求 Token，因为获取 Token 时需要提供 App Key 和 App Secret。如果在客户端请求 Token，假如 App 代码一旦被反编译，则会导致 App Key和App Secret 泄露。作为前端的我们需要Token来做测试，容云已经想到这一问题，为我们提供API调试，获取token。


(2).登录完成后，记得回到主线程

// 在主线程更新UIdispatch_sync(dispatch_get_main_queue(), ^(){         
      // 就是这里进行页面跳转啊，刷新UI
            });

  1. 会话列表
    直接用RCConversationListViewController 或者继承它创建一个控制器，即可快速启动和使用会话列表界面。

- (void)viewDidLoad {
    [super viewDidLoad];  
    //设置需要显示哪些类型的会话
    [self setDisplayConversationTypes:@[@(ConversationType_PRIVATE),
    @(ConversationType_GROUP)]];  
    //设置需要将哪些类型的会话在会话列表中聚合显示
    [self setCollectionConversationType:@[@(ConversationType_PRIVATE),
    @(ConversationType_GROUP)]];
}

注:
您需要设置在会话列表界面显示哪些类型的会话，以及将哪些类型的会话在会话列表中聚合显示。
聚合显示指的是此类型所有会话，在会话列表中聚合显示成一条会话，点击进去会显示此类型的具体会话列表。

/*!
 点击Cell头像的回调

 @param model   会话Cell的数据模型
 */- (void)didTapCellPortrait:(RCConversationModel *)model;/*!
 长按Cell头像的回调

 @param model   会话Cell的数据模型
 */- (void)didLongPressCellPortrait:(RCConversationModel *)model;

4.会话页面
融云 IMKit 中已经实现了完整的会话页面，包含发送、接收、更新等 UI，并覆盖常用的 IM 交互场景，您直接使用或继承 RCConversationViewController，即可快速启动和使用会话页面。创建一个 ChatViewController控制器 继承 RCConversationViewController，点击会话列表时进入会话页面方法

/**
 *重写RCConversationListViewController的onSelectedTableRow事件
 *
 *  @param conversationModelType 数据模型类型
 *  @param model                 数据模型
 *  @param indexPath             索引
 */-(void)onSelectedTableRow:(RCConversationModelType)conversationModelType conversationModel:(RCConversationModel *)model atIndexPath:(NSIndexPath *)indexPath
{
    ChatViewController *conversationVC = [[ChatViewController alloc]init];
    conversationVC.conversationType =model.conversationType;
    conversationVC.targetId = model.targetId;
     conversationVC.title = model.conversationTitle;
    conversationVC.hidesBottomBarWhenPushed = YES;
    [self.navigationController pushViewController:conversationVC animated:YES];
}

注:
（1).用户信息如何传给容云？会话列表上的用户头像和昵称如何显示？


userInfoDataSource 和 groupMemberDataSource两个代理会为我们完美的解决显示用户信息的问题。
设置代理：

[RCIM sharedRCIM].userInfoDataSource =self;
[RCIM sharedRCIM].groupMemberDataSource =self;

实现代理的方法：

/**
 *此方法中要提供给融云用户的信息，建议缓存到本地，然后改方法每次从您的缓存返回
 */- (void)getUserInfoWithUserId:(NSString *)userId completion:(void(^)(RCUserInfo* userInfo))completion
{    //此处为了演示写了一个用户信息
    if ([@"123456" isEqual:userId]) {
        RCUserInfo *user = [[RCUserInfo alloc]init];
        user.userId = @"123456";
        user.extra = @"全国总店";
        user.name = @"dddd";
        user.portraitUri = @"https://kxlj.oss-cn-hangzhou.aliyuncs.com/diary-pic/15547206992190";        return completion(user);
    }else if([@"222222" isEqual:userId]) {
        RCUserInfo *user = [[RCUserInfo alloc]init];
        user.userId = @"222222";
        user.name = @"用户3";
        user.portraitUri = @"https://kxlj.oss-cn-hangzhou.aliyuncs.com/diary-pic/15547206992190";        return completion(user);
    }
}

当需要显示用户信息的时候，IMKit自己会走这个方法去查询用户信息，然后显示在适当的位置。

（2).点击头像的方法？

/*!
 点击Cell中头像的回调

 @param userId  点击头像对应的用户ID
 */- (void)didTapCellPortrait:(NSString *)userId;/*!
 长按Cell中头像的回调

 @param userId  头像对应的用户ID
 */- (void)didLongPressCellPortrait:(NSString *)userId;

  1. 消息缓存
    IMKit是如何缓存的呢？怎么才能在断网的时候显示聊天记录呢？我们所担心的这些，云容都已经想到方法，在此不得不佩服容云开发者的强大。

[RCIM sharedRCIM].enablePersistentUserInfoCache = YES;

在AppDelegate里面如果设置enablePersistentUserInfoCache设置为NO，则SDK在需要显示用户信息时，会调用用户信息提供者获取用户信息并缓存到Cache，此Cache在App生命周期结束时会被移除，下次启动时会再次通过用户信息提供者获取信息。
如果设置为YES，则会将获取到的用户信息持久化存储在本地，App下次启动时Cache会仍然有效。

/*!
 获取SDK中缓存的用户信息 
 @param userId  用户ID 
 @return      SDK中缓存的用户信息
 */- (RCUserInfo *)getUserInfoCache:(NSString *)userId;

在我们服务端获取token成功之后我们会去连接融云的服务器，断网的时候当然我们不能获取到token了。
我们需要在获取token成功之后缓存一下这个token，

[NSUserDefaults standardUserDefaults] setObject:token forKey:KRongCloudToken];

再次登录的时候，如果获取token失败了，那在登录失败的方法中用缓存的token连接融云服务器，根据UserId拿到用户信息。

  1. 消息推送
    根据官网推送说明在容云控制台上传自己生成的推送证书。
    在代码中请求远程推送权限

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {    self.window = [[UIWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]]; /**
     * 推送处理1
     */
    if ([application
         respondsToSelector:@selector(registerUserNotificationSettings:)]) {   
              //注册推送, iOS 8
        UIUserNotificationSettings *settings = [UIUserNotificationSettings
                                                settingsForTypes:(UIUserNotificationTypeBadge |                                                                  UIUserNotificationTypeSound |                                                                  UIUserNotificationTypeAlert)
                                           categories:nil];
        [application registerUserNotificationSettings:settings];
    } else {   
         UIRemoteNotificationType myTypes = UIRemoteNotificationTypeBadge |UIRemoteNotificationTypeAlert |        UIRemoteNotificationTypeSound;
        [application registerForRemoteNotificationTypes:myTypes];
    }
  [[NSNotificationCenter defaultCenter]
     addObserver:self
     selector:@selector(didReceiveMessageNotification:)
     name:RCKitDispatchMessageNotification
     object:nil];

需要将 didRegisterForRemoteNotificationsWithDeviceToken: 获取到的 deviceToken ，转为 NSString 类型，并去掉其中的空格和尖括号，传给 SDK。
SDK 会将此 deviceToken 保存，在 Connect 时会自动上传到融云服务器，并与用户 ID 绑定，用于远程推送。

/**
 *  将得到的devicetoken 传给融云用于离线状态接收push ，您的app后台要上传推送证书
 *
 *  @param application <#application description#>
 *  @param deviceToken <#deviceToken description#>
 */- (void)application:(UIApplication *)application
didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {  
  NSString *token =
    [[[[deviceToken description] stringByReplacingOccurrencesOfString:@"<"
                                                           withString:@""]
      stringByReplacingOccurrencesOfString:@">"
      withString:@""]
     stringByReplacingOccurrencesOfString:@" "
     withString:@""];
    
    [[RCIMClient sharedRCIMClient] setDeviceToken:token];
}

五.功能拓展

  1. 两个APP端之间如何聊天？

我们只需要申请一套 App Key / App Secrect，提供给两个 App 使用即可。上线前，您需要在开发者平台上填写这两个应用的包名（Bundle Identifier）即可。
在测试中我们只需要在API调试中，申请两个Token，一个是目标的userId，一个是自己。也同样在以下方法中实现用户信息的刷新。

 设置  [[RCIM sharedRCIM] setUserInfoDataSource:self];
 - (void)getUserInfoWithUserId:(NSString *)userId 
 completion:(void(^)(RCUserInfo* userInfo))completion{}

  1. 聊天列表头布局显示，设计如下图


    在聊天列表上面显示

因为我们自己创建的控制器是集成RCConversationListViewController的，所以我们可以当成tableView的tableHeaderView。

   self.conversationListTableView.tableHeaderView = self.tableHeaderView; 
   //设置tableView头部
    self.conversationListTableView.tableFooterView = [UIView new];
    //这样就不会显示多余的分割线啦
    self.conversationListTableView.backgroundColor = [UIColor whiteColor];  
    self.conversationListTableView.layoutMargins = UIEdgeInsetsZero;   
    self.conversationListTableView.separatorInset = UIEdgeInsetsZero;   
    self.topCellBackgroundColor = [UIColor blueColor]; // 置顶的消息背景颜色,

3.会话列表页，cell的左滑显示 置顶，表为未读，删除
直接用tableView的代理方法

- (NSArray<UITableViewRowAction *> *)tableView:(UITableView *)tableView editActionsForRowAtIndexPath:(NSIndexPath *)indexPath {
    RCConversationModel *model = self.conversationListDataSource[indexPath.row];    UITableViewRowAction *deleteRoWAction = [UITableViewRowAction rowActionWithStyle:UITableViewRowActionStyleDefault title:@"删除" handler:^(UITableViewRowAction *action, NSIndexPath *indexPath) {
        
        [[RCIMClient sharedRCIMClient] removeConversation:ConversationType_PRIVATE targetId:model.targetId];
        [self refreshConversationTableViewIfNeeded];
        
    }];    UITableViewRowAction *readRoWAction;
       if (model.unreadMessageCount > 0) {
        readRoWAction = [UITableViewRowAction rowActionWithStyle:UITableViewRowActionStyleNormal title:@"标为已读" handler:^(UITableViewRowAction *action, NSIndexPath *indexPath) {
            [[RCIMClient sharedRCIMClient] clearMessagesUnreadStatus:ConversationType_PRIVATE targetId:model.targetId];
            
            [self refreshConversationTableViewIfNeeded];
        }];
    } else {
        readRoWAction = [UITableViewRowAction rowActionWithStyle:UITableViewRowActionStyleNormal title:@"标为未读" handler:^(UITableViewRowAction *action, NSIndexPath *indexPath) {
            [[RCIMClient sharedRCIMClient] setMessageReceivedStatus:model.lastestMessageId receivedStatus:ReceivedStatus_UNREAD];
            [self refreshConversationTableViewIfNeeded];
            // 刷新tableView
        }];
    }    UITableViewRowAction *topRoWAction; 
       if (model.isTop) {
        topRoWAction = [UITableViewRowAction rowActionWithStyle:UITableViewRowActionStyleNormal title:@"取消置顶" handler:^(UITableViewRowAction *action, NSIndexPath *indexPath) {
            [[RCIMClient sharedRCIMClient] setConversationToTop:1 targetId:model.targetId isTop:NO];
            [self refreshConversationTableViewIfNeeded];
        }];
        topRoWAction.backgroundColor = [UIColor redColor];
    } else {
        topRoWAction = [UITableViewRowAction rowActionWithStyle:UITableViewRowActionStyleNormal title:@"置顶" handler:^(UITableViewRowAction *action, NSIndexPath *indexPath) {
            [[RCIMClient sharedRCIMClient] setConversationToTop:1 targetId:model.targetId isTop:YES];
            [self refreshConversationTableViewIfNeeded];
        }];
        topRoWAction.backgroundColor =  [UIColor redColor];
    }    return @[deleteRoWAction, readRoWAction, topRoWAction];
}

  1. 设置聊天的头像为圆形

[RCIMsharedRCIM].globalConversationAvatarStyle =RC_USER_AVATAR_CYCLE;
//设置头像是圆形还是方形，默认是方形，聊天列表
[RCIMsharedRCIM].globalConversationPortraitSize =CGSizeMake(50,50);
//设置头像大小，默认是46*46，设置时必须大于36*36，否则无效

5.获取对话列表

 NSArray *array = [NSArray arrayWithObjects:[NSNumber numberWithInteger:ConversationType_PRIVATE]
 ,[NSNumber numberWithInteger:ConversationType_DISCUSSION],nil]; 
 NSArray *listArray = [[RCIMClient sharedRCIMClient] getConversationList:array];

六.遇到的问题

在聊天列表页，总是自己的信息不能显示出来，但在另一个APP上信息显示正常，并且没有发现两者什么不同，表示很郁闷，于是自己用了一个简单粗暴的方法，更新SDK中的用户信息缓存。

  //刷新融云对应用户信息
     RCUserInfo *user = [[RCUserInfo alloc]init];
     user.userId = @"666666";
     user.name = @"用户2";
     user.portraitUri = @"https://ss0.baidu.com/73t1bjeh1BF3odCf/it/u=1756054607,4047938258&fm=96&s=94D712D20AA1875519EB37BE0300C008";
    [[RCIM sharedRCIM]refreshUserInfoCache:user withUserId:userId];


demo地址


因为项目目前需求为单聊，以后会有群聊，聊天室，后续加上此功能。


本篇独发金蝶云社区

图标赞 1
1人点赞
还没有人点赞，快来当第一个点赞的人吧！
图标打赏
0人打赏
还没有人打赏，快来当第一个打赏的人吧！

推荐阅读

APP和微信小程序之间的交互

很早之前就知道移动APP分享到微信消息，点击打开后就进入了小程序，这个功能的实现感觉合情合理，很是简单。昨天听到可以直接在APP中打开小程序，感觉有点不可思议， …

    文章

    3,490

如何实现不同的用户打开同一个单据时展示不同的 …

关键词：单据、单据体、分录、按条件显示 一、需求背景 有个别需求在业务单据打开的时候，按条件显示对应的分录数据。例如如下讲师评审的业务单据，为了避免讲师的评审规 …

    文章

    5,238

如何实现页签控件，添加子页签的功能

关键词：页签 一、需求 页签控件添加子页签。 由于通过代码添加控件的方式比较复杂，而且添加的子页签属于静态页签，无法关闭，所以需要通过其他方式来添加子页签控件。 …

    文章

    2,739