IM之阿里百川SDK
2016-10-22 本文已影响1857人
flowerflower
最新公司的项目比较赶，国庆期间也在赶项目。很久没有发表新的动态了。由于公司要求一定要使用阿里百川的即时通讯，一起分享下经验。下周再分享环信SDK
12.gif
一.即时通讯简介
1.1 XMPP简介
-
XMPP一个即时通讯的协议，它规范了用于即时通信在网络上数据传输格式的，比如登录，获取好友列表等等的格式，XMPP在网络传输的数据是XML格式 -
XMPP是一个基于Socket通过的网络协议，目的就是为了保护长连接，以实现即时通讯功能 -
XMPP的客户端是使用一个XMPPFramework框架实现 -
XMPP的服务器是使用Openfire，一个开源的服务器
1.2 第三方即时通讯SDK
- 不需要公司内部搭建服务器
- 可使公司可以节约时间成本
- 客户端的开发，使用第三方SDK比XMPPFramework更简洁方便
- 是在
XMPP的基础上进行二次开发，对服务器Openfire和客户端进行功能模型的添加和客户端SDK的封装，本质还是使用XMPP,基于Socket的网络通信 - 内部实现了数据缓存，会把聊天记录添加到数据库，把附件（如音频文件，图片文件）下载到本地，使程序员更多时间是花到用户即时体验上
只要你使用第三方的即时通讯,无论你是使用环信还是融云还是阿里的,首先第一步就是集成，集成千篇一律，对着官方文档完成集成即可,集成问题则不再细说
二.阿里百川SDK准备工作
2.1 注册账号
2.2 根据build id创建应用,集成的时候需要替换阿里AppKey值
Snip20161021_14.png
三. 集成与核心功能(主要针对单聊)
-
1 集成阿里百川即时通讯SDK集成
-
2 查看示例demo并熟悉阿里百川的示例demo下载
-
3 让示例demo变成你的东西，根据项目需求，对其进行增删改减。把
SPKitExample类名改成SPKitManager这样意思更明确，再者把SPKitExample类里面所有的example全部清除
整理好之后剩下如下文件
Snip20161021_11.png
四. 步骤具体化
1.初始化IMSDK
在AppDelegate中导入#import "SPKitManager.h"头文件，并在didFinishLaunchingWithOptions方法中初始化IMSDK
[[SPKitManager sharedInstance] callThisInDidFinishLaunching];
2.设置SPKitManager
首先在SPKitManager.h添加一个block块来检查登录状态
-(void)checkLoginRun:(void(^)())callback;
其次在SPKitManager.m声明一个BOOL属性判断用户是否登录，并实现checkLoginRun方法,为了保护用户账号密码的安全性，我们对用户的账号密码进行MD5加密处理。XXXX一般是以项目名称做其前缀进行加密，不过具体还是得看公司要求。
@property(nonatomic)BOOL isLogined;
-(void)checkLoginRun:(void(^)())callback{
[self login:callback];
}
-(void)login:(void(^)())callback{
if(self.isLogined){
if (callback) {
callback();
}
}else{
@synchronized(self){
if(self.isLogined) {
if (callback) {
callback();
}
return;
}
YISUserModel<Optional>* user = [YISUserManager shareInstance].user.user;
if(user == nil || user.id == nil){return;}
NSString *uid = [YISTools MD5String: user.id];
NSString *pwd = [YISTools MD5String:[NSString stringWithFormat:@"XXXX%@",user.id]];
[self callThisAfterISVAccountLoginSuccessWithYWLoginId:uid passWord:pwd preloginedBlock:^{}
successBlock:^{
self.isLogined = YES;
if (callback) {
callback();
} } failedBlock:^(NSError *aError) {
DDLogInfo(@"aError:%@",aError);
}]; }
}
}
3.创建会话列表
- 3.1导入头文件3个
#import <WXOUIModule/YWConversationListViewController.h>
#import "SPKitManager.h"
#import <WXOpenIMSDKFMWK/YWConversation.h>
- 3.2声明属性
@property(nonatomic, strong) SPKitManager* spkit;//聊天Manager
@property (weak, nonatomic) IBOutlet UIView *msgListView;
@implementation YISMessageViewController{
NSString *currentId;
YWConversationListViewController *conversationListController;
}
- 3.3设置会话列表
viewDidLoad->调用[self setupIMList](判断用户是否登录以及是否切换账号等问题的处理)->[self _setupIMList](设置会话列表)
-(void)setupIMList{
BOOL isLogin = [YISUserManager shareInstance].isLogin;
if (!isLogin) {
[[NSNotificationCenter defaultCenter] postNotificationName:kLoginNotification object:nil];
return;
}
NSString *uid = [YISUserManager shareInstance].user.user.id;
if(currentId != nil && ![currentId isEqualToString: uid]){
[self.msgListView removeFromSuperview];
[conversationListController removeFromParentViewController];
DDLogDebug(@"currentId%@--userid:%@",currentId,uid);
}else if (currentId != nil){
return;
}
self.spkit = [SPKitManager sharedInstance];
[self.spkit checkLoginRun:^{
[self _setupIMList];
}];
}
-(void)_setupIMList{
conversationListController = [self.spkit.ywIMKit makeConversationListViewController];
conversationListController.view.frame = [UIScreen mainScreen].bounds;
conversationListController.view.backgroundColor =[UIColor clearColor];
__weak __typeof(conversationListController) weakConversationListController;
weakConversationListController = conversationListController;
YWConversationsListDidSelectItemBlock selectItemBlock;
selectItemBlock = ^(YWConversation *aConversation) {
if ([aConversation isKindOfClass:[YWCustomConversation class]]) {
YWCustomConversation *customConversation = (YWCustomConversation *)aConversation;
[customConversation markConversationAsRead];
}
else {
[[SPKitManager sharedInstance] openConversationViewControllerWithConversation:aConversation
fromNavigationController:weakConversationListController.navigationController];
} };
[conversationListController setDidSelectItemBlock:selectItemBlock];
[self.spkit CustomizeConversationCellWithConversationListController:conversationListController];
conversationListController.didDeleteItemBlock = ^ (YWConversation *aConversation) {};
self.msgListView = conversationListController.view;
[self.view addSubview:self.msgListView];
[self addChildViewController:conversationListController];
[self didMoveToParentViewController:conversationListController];
__weak typeof(self.navigationController) weakController = self.navigationController;
[self.spkit.ywIMKit setUnreadCountChangedBlock:^(NSInteger aCount) {
NSString *badgeValue = aCount > 0 ?[ @(aCount) stringValue] : nil;
weakController.tabBarItem.badgeValue = badgeValue;
}];
}
4.退出登录
上面有有提到账号切换问题，而在app退出登录时阿里也要退出，否则会导致此种情况，登录新的账号时还残留着上一个账号的聊天列表。如果程序每次卸载再重新安装不会发现此问题，但是没有必要这样，用户体验会及其不好。
例如:
[[YISUserManager shareInstance]logout];
[[SPKitManager sharedInstance]Logout];
额外补充
替换阿里的默认头像
WXFrameworks->WXOUIModuleResources.bundle->pub_ico_single_120@2x/pub_ico_single_120@3x
