IM之阿里百川SDK

最新公司的项目比较赶,国庆期间也在赶项目。很久没有发表新的动态了。由于公司要求一定要使用阿里百川的即时通讯,一起分享下经验。下周再分享环信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

三. 集成与核心功能(主要针对单聊)

整理好之后剩下如下文件

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

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,324评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,303评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,192评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,555评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,569评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,566评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,927评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,583评论 0 257
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,827评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,590评论 2 320
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,669评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,365评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,941评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,928评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,159评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,880评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,399评论 2 342

推荐阅读更多精彩内容