快速集成腾讯云通讯IMSDK 注册登录功能

云通讯简介

腾讯是国内最大也是最早的即时通信开发商，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字节 <密码 < 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下载地址