一.首先看下动态图:
二.集成步骤
1.参考官方文档 http://www.rongcloud.cn/docs/ios.html#base_function_discussion
注册开发者账号
创建应用
注册了开发者帐号之后,在进行开发 App 之前,您需要前往融云开发者控制台创建应用。创建完应用之后,在您的应用中,会自动创建两套环境,即:开发环境和生产环境
开发环境专门用于开发测试,生产环境专门用于您的应用上线正式商用。两套环境相互隔离,每个环境都有相应的 App Key 和 App Secret。两个环境消息不互通。
获取 Token
在融云控制台中荔枝FM(我的应用)->API调试->获取Token
SDK集成
我是用cocoapods导入的
①cd + 路径(定位到项目所在路径)
②pod init (创建podfile文件)
③添加需要的第三方
④pod install(pod update)
导入成功后,就可以使用了!
初始化、连接服务器
在AppDelegate.m里
#import <RongIMKit/RongIMKit.h>
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
//初始化sdk
[[RCIM sharedRCIM] initWithAppKey:kSDKKey];
//连接服务器
[[RCIM sharedRCIM] connectWithToken:kToken1 success:^(NSString *userId) {
NSLog(@"登陆成功。当前登录的用户ID:%@", userId);
[[NSUserDefaults standardUserDefaults]setObject:userId forKey:@"userId"];
[[NSUserDefaults standardUserDefaults] synchronize];
} error:^(RCConnectErrorCode status) {
NSLog(@"登陆的错误码为:%ld", (long)status);
} tokenIncorrect:^{
//token过期或者不正确。
//如果设置了token有效期并且token过期,请重新请求您的服务器获取新的token
//如果没有设置token有效期却提示token错误,请检查您客户端和服务器的appkey是否匹配,还有检查您获取token的流程。
NSLog(@"token错误");
}];
return YES;
}
会话界面
-(void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath
{
NSDictionary *dic = self.listArray[indexPath.row];
RCConversationType type = ConversationType_PRIVATE;
if (indexPath.row>4) {
type = ConversationType_DISCUSSION;
}
//新建一个聊天会话View Controller对象,建议这样初始化
SingleChatVC *chat = [[SingleChatVC alloc] initWithConversationType:type targetId:dic[@"userId"]];
//设置会话的目标会话ID。(单聊、客服、公众服务会话为对方的ID,讨论组、群聊、聊天室为会话的ID)
//设置聊天会话界面要显示的标题
chat.title = dic[@"name"];
//显示聊天会话界面
[self.navigationController pushViewController:chat animated:YES];
}
//SingleChatVC class
@interface SingleChatVC : RCConversationViewController
消息界面
//.h
#import <UIKit/UIKit.h>
#import <RongIMKit/RongIMKit.h>
#import <RongIMLib/RongIMLib.h>
@interface NewsList : RCConversationListViewController
@end
.m
- (void)viewDidLoad {
///重写显示相关的接口,必须先调用super,否则会屏蔽SDK默认的处理
[super viewDidLoad];
self.view.backgroundColor = [UIColor whiteColor];
//设置需要显示哪些类型的会话
[self setDisplayConversationTypes:@[@(ConversationType_PRIVATE),
@(ConversationType_DISCUSSION),
@(ConversationType_CHATROOM),
@(ConversationType_GROUP),
@(ConversationType_APPSERVICE),
@(ConversationType_SYSTEM)]];
// //设置需要将哪些类型的会话在会话列表中聚合显示
[self setCollectionConversationType:@[@(ConversationType_DISCUSSION),
@(ConversationType_GROUP)]];
}
//重写RCConversationListViewController的onSelectedTableRow事件
-(void)onSelectedTableRow:(RCConversationModelType)conversationModelType conversationModel:(RCConversationModel *)model atIndexPath:(NSIndexPath *)indexPath
{
RCConversationViewController *conversationVC = [[RCConversationViewController alloc] init];
conversationVC.conversationType = model.conversationType;
conversationVC.targetId = model.targetId;
conversationVC.title = @"聊天室";
conversationVC.hidesBottomBarWhenPushed = YES;
[self.navigationController pushViewController:conversationVC animated:YES];
}
遇到的问题
点击键盘中的+ 号时,崩溃
解决办法是在info.plist文件里添加描述字段