腾讯云通讯IMSDK

详细功能介绍文档中心
集成SDK下载

1.gif

2.gif

因为我这里不集成服务器,所以我选择托管模式,由腾讯服务器负责保存用户信息和负责用户数据的校验工作(注意每个创建的应用只能选择一次模式,如果需要修改账号体系,只能重新创建应用)


快速集成登陆注册功能:效果图如下

4.gif

腾讯登录服务(Tencent Login Service,TLS)是腾讯为开发者快速完成帐号集成接入音视频或即时通信云服务(后面简称云服务)而提供的一套通用帐号登录组件。实现包括QQ、微信、新浪微博、人人在内的多种帐号类型登录使用云服务。开发者可以通过简单的SDK集成,便捷的接口调用,即可实现原本复杂的登录验证服务,使代码量急剧减少。
TLS SDK 开发手册集成
TLS SDK 不需要用户每次都手动登录,通过调用[[TLSLoginHelper getInstance] needlogin:@"用户账号"],如果返回结果为 false, 即可以直接调用换票接口登录,拿到最新票据。否则完成完整的登录流程。

//请求刷新票据
NSString * userAccount = [[TLSLoginHelper getInstance] getLastUserInfo].identifier;
if (![[TLSLoginHelper getInstance] needLogin:userAccount ])
{
// userAccount 用户最近一次使用的帐号
// self 刷新票据回调,需要实现TLSPwdLoginListener协议,不能为nil
    [[TLSLoginHelper getInstance] TLSRefreshTicket:userAccount andTLSRefreshTicketListener:self];
}
成功回调....
失败或超时回调如下,此时可以重新走登录流程

获取UserSig:
https://www.qcloud.com/doc/product/269/1508
https://www.qcloud.com/doc/product/269/1509


初始化:

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
//初始化IMSDk
   TIMManager *manager =  [TIMManager sharedInstance];
    [manager setLogLevel:(TIM_LOG_NONE)];
    [manager disableCrashReport];
    [manager initSdk:1400014178 accountType:@"7221"];
    [manager setUserStatusListener:self];//设置用户状态通知回调

 //初始化QalSDK--网络接入服务
   [[QalSDKProxy sharedInstance]initWithAppid:1400014178 andSDKAppid:1400014178 andAccType:7221];
 //初始化TLSAccountHelper 实例
 //强烈注意:TLSSDK依赖QALSDK,因此需要先初始化QALSDK。
   [[TLSAccountHelper getInstance]init:1400014178 andAccountType:7221 andAppVer:@"1.0"];
   [[TLSLoginHelper getInstance]init:1400014178 andAccountType:7221 andAppVer: @"1.0"];


    TLSLoginHelper *helper = [[TLSLoginHelper getInstance];
    //获取最后一些登录的用户
    TLSUserInfo *user = [helper getLastUserInfo];
    //判断用户是否需要自动登录
    BOOL login = [helper needLogin:user.identifier];
    if (login == YES) {
        //重新登录
        self.window.rootViewController = [[LoginViewController alloc]init];
    }else
    {//TLS 不需要登录后,登录TIMSDK
        TIMLoginParam *login = [[TIMLoginParam alloc]init];
        login.accountType = @"7221";
        login.identifier = user.identifier;
        login.userSig = [[TLSHelper getInstance] getTLSUserSig:user.identifier];
        login.sdkAppId = 1400014178;
        login.appidAt3rd = @"1400014178";
        [[TIMManager sharedInstance] login:login succ:^{
            aleraView(@"登陆成功");
        } fail:^(int code, NSString *msg) {
            aleraView(@"登陆失败");
           if (code == 6208) {
            aleraView(msg);
        }
        }];
    return YES;
}

#pragma - TIMUserStatusListener
/**
 *  踢下线通知
 */
-(void)onForceOffline{
    aleraView(@"用户被踢");
}

/**
 *  断线重连失败
 */
-(void)onReConnFailed:(int)code err:(NSString *)err{
    aleraView(@"断线重连失败");
}

/**
 *  用户登录的userSig过期(用户需要重新获取userSig后登录)
 */
- (void)onUserSigExpired{
    aleraView(@"用户登录的userSig过期");
}

注册

/**
 *  字符串账号+密码注册接口
 *  @param account - 用户输入的账号名,最长不得超过24字节
 *  @param password - 用户输入的密码,密码最短8字节,最长16字节
 *  @param listener - 回调接口 需要实现TLSStrAccountRegProtocol协议
 *  @return 0表示调用成功;其他表示调用失败,返回码见:_TLS_RETURN_VALUES
 */
    [[TLSAccountHelper getInstance]TLSStrAccountReg:self.nameTextField.text andPassword:self.passWordTextField.text andTLSStrAccountRegListener:self];
//遵守TLSStrAccountRegListener 协议
#pragma mark - TLSStrAccountRegListener

- (void)OnStrAccountRegSuccess:(TLSUserInfo *)userInfo
{
    NSLog(@"TLS注册成功---userInfo = %@",userInfo);
    aleraView(@"注册成功");
}

-(void)OnStrAccountRegFail:(TLSErrInfo *)errInfo
{
    NSLog(@"TLS注册失败---errInfo = %@",errInfo);
    aleraView(@"注册失败");
}

-(void)OnStrAccountRegTimeout:(TLSErrInfo *)errInfo
{
    NSLog(@"TLS注册超时---errInfo = %@",errInfo);
}

在多数情况下,用户需要感知新消息的通知,这时只需注册新消息通知回调 TIMMessageListener,在用户登录状态下,会拉取离线消息,为了不漏掉消息通知,需要在登录之前注册新消息通知。

 [[TIMManager sharedInstance] setMessageListener:(self)];
   //遵守TIMMessageListener 协议

- (void) onNewMessage:(NSArray *)msgs{
    aleraView([msgs objectAtIndex:0]);
}

登陆视频:https://www.qcloud.com/course/detail/96
需要再TLS登录成功后,继续登录IMSDK

 //输入用户名和密码,调用密码登录接口
[[TLSAccountHelper getInstance]TLSStrAccountReg:_name.text andPassword:_password.text andTLSStrAccountRegListener:self];
 //遵守TLSPwdLoginListener 协议
#pragma mark -TLSPwdLoginListener
/**
 *  密码登陆要求验证图片验证码
 *
 *  @param picData 图片验证码
 *  @param errInfo 错误信息
 */
-(void)OnPwdLoginNeedImgcode:(NSData *)picData andErrInfo:(TLSErrInfo *)errInfo
{
    NSLog(@"登录异常请输入图片验证码----errInfo = %@", errInfo);
}

/**
 *  密码登陆请求图片验证成功
 *
 *  @param picData 图片验证码
 */
-(void)OnPwdLoginReaskImgcodeSuccess:(NSData *)picData
{
    NSLog(@"图片验证码验证成功---%@",picData);
}

/**
 *  密码登陆成功
 *
 *  @param userInfo 用户信息
 */
-(void)OnPwdLoginSuccess:(TLSUserInfo *)userInfo
{
  NSLog(@"TLS 密码登录成功----errInfo = %@",userInfo);
    //登录
    TIMLoginParam *login = [[TIMLoginParam alloc]init];
    login.accountType = @"7221";
    login.identifier = _name.text;
    login.userSig = [[TLSHelper getInstance] getTLSUserSig:userInfo.identifier];
    login.sdkAppId = 1400014178;
    login.appidAt3rd = @"1400014178";
    
    [[TIMManager sharedInstance] login:login succ:^{
        aleraView(@"登陆成功");
    } fail:^(int code, NSString *msg) {
        aleraView(@"登陆失败");
         if (code == 6208) {
            aleraView(msg);
        }
    }];
}
/**
 *  密码登陆失败
 *
 *  @param errInfo 错误信息
 */
-(void)OnPwdLoginFail:(TLSErrInfo *)errInfo
{
    NSLog(@"密码登录失败----errInfo = %@",errInfo);
}

/**
 *  密码登陆超时
 *
 *  @param errInfo 错误信息
 */
-(void)OnPwdLoginTimeout:(TLSErrInfo *)errInfo
{
    NSLog(@"密码登录超时----errInfo = %@",errInfo);
}

登出

    [[TIMManager sharedInstance] logout:^{
        aleraView(@"登出成功");
    } fail:^(int code, NSString *msg) {
        aleraView(@"登出失败");
    }];

用户在线状态通知

[manager setUserStatusListener:self];//设置用户状态通知回调
//遵守TIMUserStatusListener 协议
/**
 *  踢下线通知
 */
-(void)onForceOffline{
    aleraView(@"用户被踢");
}

/**
 *  断线重连失败
 */
-(void)onReConnFailed:(int)code err:(NSString *)err{
    aleraView(@"断线重连失败");
}

/**
 *  用户登录的userSig过期(用户需要重新获取userSig后登录)
 */
- (void)onUserSigExpired{
    aleraView(@"用户登录的userSig过期");
}

发送一条消息

    TIMMessage * msg = [[TIMMessage alloc]init];
    TIMTextElem * elem = [[TIMTextElem alloc]init];
    [elem setText:@"我发了一条消息"];
    [msg addElem:elem];
    TIMConversation * sess = [[TIMManager sharedInstance ]getConversation:TIM_C2C receiver:@"tom1"];
    [sess sendMessage:msg succ:^{
        aleraView(@"发送成功");
    } fail:^(int code, NSString *msg) {
        aleraView(@"发送失败");
    }];

获取消息

    TIMConversation * sess = [[TIMManager sharedInstance]getConversation:TIM_C2C receiver:@"tom1"];
    [sess getMessage:2 last:nil succ:^(NSArray *msgs) {
        aleraView(@"获取消息成功");
    } fail:^(int code, NSString *msg) {
        aleraView(@"获取消息失败");
    }];

消息通知

 [[TIMManager sharedInstance]setMessageListener:(self)];//消息通知回调
//遵守TIMMessageListener 协议

-(void)onNewMessage:(NSArray *)msgs{
    aleraView([msgs objectAtIndex:0]);
}

刷新会话未读记数

[[TIMManager sharedInstance] setRefreshListener:(self)];
//遵守TIMRefreshListener 协议

-(void)onRefresh{
    //重新获取会话列表 刷新会话未读记数
    NSArray * lis = [[TIMManager sharedInstance]getConversationList];
    int unread = 0;
    for (TIMConversation * sess in lis) {
        unread += [sess getUnReadMessageNum];
    }
    NSString * unRead = [NSString stringWithFormat:@"未读计数%d",unread];
    aleraView(unRead);
}

用户资料与关系链

//设置自己的昵称
    NSString * nick = @"123";
   [[TIMFriendshipManager sharedInstance] SetNickname:nick succ:^() {
        NSLog(@"SetNickname Succ");
    } fail:^(int code, NSString * err) {
        NSLog(@"SetNickname fail: code=%d err=%@", code, err);
    }];

//好友验证方式
TIMFriendAllowType allowType = TIM_FRIEND_NEED_CONFIRM;
[[TIMFriendshipManager sharedInstance] SetAllowType:allowType succ:^() {
    NSLog(@"SetAllowType Succ");
} fail:^(int code, NSString * err) {
    NSLog(@"SetAllowType fail: code=%d err=%@", code, err);
}];

//设置自己的头像
NSString * faceUrl = @"http://faceurl";

[[TIMFriendshipManager sharedInstance] SetFaceURL:faceUrl succ:^() {
    NSLog(@"SetFaceURL Succ");
} fail:^(int code, NSString * err) {
    NSLog(@"SetFaceURL fail: code=%d err=%@", code, err);
}];

//获取自己的资料
[[TIMFriendshipManager sharedInstance] GetSelfProfile:^(TIMUserProfile * profile) {
    NSLog(@"GetSelfProfile identifier=%@ nickname=%@ allowType=%d", profile.identifier, profile.nickname, profile.allowType);
} fail:^(int code, NSString * err) {
    NSLog(@"GetSelfProfile fail: code=%d err=%@", code, err);
}];

//获取好友的资料
NSMutableArray * arr = [[NSMutableArray alloc] init];

[arr addObject:@"iOS_002"];
[arr addObject:@"iOS_003"];

[[TIMFriendshipManager sharedInstance] GetFriendsProfile:arr succ:^(NSArray * arr) {
    for (TIMUserProfile * profile in arr) {
        NSLog(@"user=%@", profile);
    }
}fail:^(int code, NSString * err) {
    NSLog(@"GetFriendsProfile fail: code=%d err=%@", code, err);
}];


//添加好友
NSMutableArray * users = [[NSMutableArray alloc] init];

TIMAddFriendRequest* req = [[TIMAddFriendRequestalloc] init];

// 添加好友 iOS_002
req.identifier = [NSString stringWithUTF8String:"iOS_002"];
// 添加备注 002Remark
req.remark = [NSString stringWithUTF8String:"002Remark"];
// 添加理由
req.addWording = [NSString stringWithUTF8String:"i am 002"];

[users addObject:req];

[[TIMFriendshipManager sharedInstance] AddFriend:users succ:^(NSArray * arr) {
    for (TIMFriendResult * res in arr) {
        if (res.status != TIM_FRIEND_STATUS_SUCC) {
            NSLog(@"AddFriend failed: user=%@ status=%d", res.identifier, res.status);
        }
        else {
            NSLog(@"AddFriend succ: user=%@ status=%d", res.identifier, res.status);
        }
    }
} fail:^(int code, NSString * err) {
    NSLog(@"add friend fail: code=%d err=%@", code, err);
}];


//同意/拒绝 好友申请
/**
 *  响应对方好友邀请
 *
 *  @param users     响应的用户列表,TIMFriendResponse列表
 *  @param succ      成功回调,返回 TIMFriendResult* 列表
 *  @param fail      失败回调
 *
 *  @return 0 发送请求成功
 */
-(int) DoResponse:(NSArray*)users succ:(TIMFriendSucc)succ fail:(TIMFail)fail;


// 获取所有好友
[[TIMFriendshipManager sharedInstance] GetFriendList:^(NSArray * arr) {
    for (TIMUserProfile * profile in arr) {
        NSLog(@"friend: %@", profile.identifier);
    }
}fail:^(int code, NSString * err) {
    NSLog(@"GetFriendList fail: code=%d err=%@", code, err);;
}];

ImSDK离线推送视频

离线推送

3.gif

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念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

推荐阅读更多精彩内容

  • 点击查看原文 Web SDK 开发手册 SDK 概述 网易云信 SDK 为 Web 应用提供一个完善的 IM 系统...
    layjoy阅读 13,652评论 0 15
  • 云通讯简介 腾讯是国内最大也是最早的即时通信开发商,QQ和微信已经成为每个互联网用户必不可少的应用。现在,腾讯将高...
    captain_Lu阅读 20,757评论 12 10
  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,580评论 18 139
  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,391评论 25 707
  • 中国古代有一对夫妇,因为家庭的阶级差异,在婚后被迫分离,每年只有七月初七这天可以见上一面。 后来他们的故事变成民间...
    澜润她世界阅读 265评论 0 0