云通讯简介
腾讯是国内最大也是最早的即时通信开发商，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文件增加
<key>NSAppTransportSecurity</key>
<dict>
<key>NSAllowsArbitraryLoads</key>
<true/>
</dict>
添加工程pch文件
导入一下头文件
#import <ImSDK/ImSDK.h>
#import <QALSDK/QalSDKProxy.h>
#import <QALSDK/QalSDKCallbackProtocol.h>
#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字节 <密码 < 16字节
注册成功回调
#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下载地址
