云通讯简介

腾讯是国内最大也是最早的即时通信开发商，QQ和微信已经成为每个互联网用户必不可少的应用。现在，腾讯将高并发、高可靠的即时通信能力进行开放，开发者可以很容易的根据腾讯提供的SDK将即时通信功能集成入APP中。

详细功能介绍;

集成

下载SDK

创建新工程

创建新工程.jpg

将下载的IMSDK拖入到工程中

Libs.png

关于各SDK解释

必选SDK：

必须是一个版本成套使用，不同版本不可混用

ImSDK.framework IM接口SDK

QALSDK.framework 网络SDK

TLSSDK.framework 登录SDK

可选SDK：

IMCore.framework IM核心功能

如果使用IM聊天必须加入，如果只用登录功能(如只使用音视频的情况，可不加入)

如果不加入IMCore.framework，使用时需 #import "ImSDK/ImSDKSimple.h"，不要包含其他头文件，否则可能会引起编译错误

IMSDKBugly.framework Crash上报功能

如无特殊需要，推荐使用，在控制台页面可以查看Crash率等信息

如果不加入此SDK，需要调用 [TIMManager sharedInstance] disableCrashReport];

其他SDK：

QALHttpSDK.framework 网络透传SDK

只有用到网络透传功能时使用

添加系统依赖库

CoreTelephony.framework

SystemConfiguration.framework

libc++.dylib

libz.dylib

libsqlite3.dylib

更改工程Other Linker Flags -> -ObjC

Other linker Flags.png

工程Info.plist文件增加

NSAppTransportSecurity

NSAllowsArbitraryLoads

添加工程pch文件

导入一下头文件

#import

#import

#import

#import "TLSSDK/TLSAccountHelper.h"

#import "TLSSDK/TLSLoginHelper.h"

#import "TLSSDK/TLSRefreshTicketListener.h"

#import "TLSSDK/TLSOpenLoginListener.h"

#import "TLSSDK/TLSHelper.h"

编译工程，如果没有报错，继续下一步

登录腾讯开发者平台

登录开发者账号.png

腾讯开发者需要实名认证

创建应用

创建应用.png

腾讯分配的会自动分配SdkAppId

帐号体系集成

独立模式

托管模式

关于独立模式和托管模式详细的区别详见

详解

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

账号体系集成.png

得到appid 和accountType

初始化SDK

在Appdelegate中

//初始化TIMSDK

TIMManager *manager = [TIMManager sharedInstance];

[manager disableCrashReport];

[manager initSdk:1400014178 accountType:@"7221"];

[[QalSDKProxy sharedInstance]initWithAppid:1400014178 andSDKAppid:1400014178 andAccType:7221];

TLSLoginHelper *helper = [[TLSLoginHelper getInstance]init:1400014178 andAccountType:7221 andAppVer:@"1.0"];

[[TLSAccountHelper getInstance]init:1400014178 andAccountType:7221 andAppVer:@"1.0"];

简单搭建登录界面

Simulator Screen Shot 2016年9月5日 下午5.44.14.png

注册

- (IBAction)registerButtonClick:(id)sender

{

if (self.nameTextField.text.length == 0)

{

NSLog(@"请输入用户名");

return;

}else if (self.nameTextField.text.length > 24)

{

NSLog(@"用户名最长不超过24字节");

return;

}

if (self.passWordTextField.text.length == 0)

{

NSLog(@"请输入密码");

return;

}else if (self.passWordTextField.text.length < 8)

{

NSLog(@"请输入长度为8-16位密码");

return;

}else if (self.passWordTextField.text.length > 16)

{

NSLog(@"请输入长度为8-16位密码");

return;

}

//注册

/**

* 字符串账号+密码注册接口

* @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 协议

}

SDK用户名和密码限制

用户名 <24字节

8字节

注册成功回调

#pragma mark - TLSPwdLoginListener

- (void)OnStrAccountRegSuccess:(TLSUserInfo *)userInfo

{

NSLog(@"注册成功---userInfo = %@",userInfo);

}

-(void)OnStrAccountRegFail:(TLSErrInfo *)errInfo

{

NSLog(@"注册失败---errInfo = %@",errInfo);

}

-(void)OnStrAccountRegTimeout:(TLSErrInfo *)errInfo

{

NSLog(@"注册超时---errInfo = %@",errInfo);

}

登录

- (IBAction)loginButtonClick:(id)sender

{

if (self.nameTextField.text.length == 0)

{

NSLog(@"请输入用户名");

return;

}else if (self.nameTextField.text.length > 24)

{

NSLog(@"用户名最长不超过24字节");

return;

}

if (self.passWordTextField.text.length == 0)

{

NSLog(@"请输入密码");

return;

}else if (self.passWordTextField.text.length < 8)

{

NSLog(@"请输入长度为8-16位密码");

return;

}else if (self.passWordTextField.text.length > 16)

{

NSLog(@"请输入长度为8-16位密码");

}

//注意这里是登录TLS，如果登录成功后就进入主界面，请求会话或者好友列表会返回用户没有登录错误，因此这里需要再TLS登录成功后，继续登录IMSDK

int result = [[TLSLoginHelper getInstance]TLSPwdLogin:self.nameTextField.text andPassword:self.passWordTextField.text andTLSPwdLoginListener:self];

}

登录回调

#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 = self.nameTextField.text;

login.userSig = [[TLSHelper getInstance] getTLSUserSig:userInfo.identifier];

login.sdkAppId = 1400014178;

login.appidAt3rd = @"1400014178";

//这里必须配置

[IMAPlatform configWith:login.config];

//直接登录

[[HUDHelper sharedInstance] syncLoading:@"正在登录"];

[[IMAPlatform sharedInstance] login:login succ:^{

[[HUDHelper sharedInstance] syncStopLoadingMessage:@"登录成功"];

[UIApplication sharedApplication].keyWindow.rootViewController = [[KLTabBarController alloc]init];

[[IMAPlatform sharedInstance]configHost:login];//必须配置configHost

} fail:^(int code, NSString *msg) {

[[HUDHelper sharedInstance] syncStopLoadingMessage:IMALocalizedError(code, msg) delay:2 completion:^{

}];

NSLog(@"IM登录失败------%@",msg);

}];

}

/**

* 密码登陆失败

*

* @param errInfo 错误信息

*/

-(void)OnPwdLoginFail:(TLSErrInfo *)errInfo

{

NSLog(@"密码登录失败----errInfo = %@",errInfo);

}

/**

* 密码登陆超时

*

* @param errInfo 错误信息

*/

-(void)OnPwdLoginTimeout:(TLSErrInfo *)errInfo

{

NSLog(@"密码登录超时----errInfo = %@",errInfo);

}

实现自动登录功能

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

//获取最后一些登录的用户

TLSUserInfo *user = [helper getLastUserInfo];

//判断用户是否需要自动登录

BOOL login = [helper needLogin:user.identifier];

if (login == YES) {

//重新登录

self.window.rootViewController = [[KLLoginOrRegisterViewController 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";

[IMAPlatform configWith:login.config];

//直接登录

[[HUDHelper sharedInstance] syncLoading:@"正在登录"];

[[IMAPlatform sharedInstance] login:login succ:^{

[[HUDHelper sharedInstance] syncStopLoadingMessage:@"登录成功"];

[UIApplication sharedApplication].keyWindow.rootViewController = [[KLTabBarController alloc]init];

[[IMAPlatform sharedInstance]configHost:login];

} fail:^(int code, NSString *msg) {

[[HUDHelper sharedInstance] syncStopLoadingMessage:IMALocalizedError(code, msg) delay:2 completion:^{

}];

NSLog(@"IM登录失败------%@",msg);

}];

}

return YES;

}

欢迎github上下载demo下载地址