快速集成騰訊云通訊IMSDK 注冊(cè)登錄功能

云通訊簡(jiǎn)介

騰訊是國(guó)內(nèi)最大也是最早的即時(shí)通信開(kāi)發(fā)商，QQ和微信已經(jīng)成為每個(gè)互聯(lián)網(wǎng)用戶必不可少的應(yīng)用?，F(xiàn)在，騰訊將高并發(fā)、高可靠的即時(shí)通信能力進(jìn)行開(kāi)放，開(kāi)發(fā)者可以很容易的根據(jù)騰訊提供的SDK將即時(shí)通信功能集成入APP中。
詳細(xì)功能介紹;

集成

下載SDK

下載地址

創(chuàng)建新工程
創(chuàng)建新工程.jpg
將下載的IMSDK拖入到工程中
Libs.png

關(guān)于各SDK解釋
必選SDK：

    必須是一個(gè)版本成套使用，不同版本不可混用
    ImSDK.framework         IM接口SDK
    QALSDK.framework        網(wǎng)絡(luò)SDK
    TLSSDK.framework        登錄SDK

可選SDK：

    IMCore.framework        IM核心功能
    如果使用IM聊天必須加入，如果只用登錄功能（如只使用音視頻的情況，可不加入）
    如果不加入IMCore.framework，使用時(shí)需 #import "ImSDK/ImSDKSimple.h"，不要包含其他頭文件，否則可能會(huì)引起編譯錯(cuò)誤
    IMSDKBugly.framework    Crash上報(bào)功能
    如無(wú)特殊需要，推薦使用，在控制臺(tái)頁(yè)面可以查看Crash率等信息
    如果不加入此SDK，需要調(diào)用 [TIMManager sharedInstance] disableCrashReport];

其他SDK：

    QALHttpSDK.framework        網(wǎng)絡(luò)透?jìng)鱏DK
    只有用到網(wǎng)絡(luò)透?jìng)鞴δ軙r(shí)使用
添加系統(tǒng)依賴庫(kù)
CoreTelephony.framework
SystemConfiguration.framework
libc++.dylib
libz.dylib
libsqlite3.dylib
更改工程O(píng)ther Linker Flags -> -ObjC
Other linker Flags.png
工程Info.plist文件增加
<key>NSAppTransportSecurity</key>
    <dict>
        <key>NSAllowsArbitraryLoads</key>
        <true/>
    </dict>
添加工程pch文件

導(dǎo)入一下頭文件

#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"

編譯工程，如果沒(méi)有報(bào)錯(cuò)，繼續(xù)下一步

登錄騰訊開(kāi)發(fā)者平臺(tái)

地址

登錄開(kāi)發(fā)者賬號(hào).png

騰訊開(kāi)發(fā)者需要實(shí)名認(rèn)證
創(chuàng)建應(yīng)用
創(chuàng)建應(yīng)用.png

騰訊分配的會(huì)自動(dòng)分配SdkAppId

帳號(hào)體系集成
  • 獨(dú)立模式
  • 托管模式
    關(guān)于獨(dú)立模式和托管模式詳細(xì)的區(qū)別詳見(jiàn)
    詳解
    因?yàn)槲疫@里不集成服務(wù)器，所以我選擇托管模式，由騰訊服務(wù)器負(fù)責(zé)保存用戶信息和負(fù)責(zé)用戶數(shù)據(jù)的校驗(yàn)工作（注意每個(gè)創(chuàng)建的應(yīng)用只能選擇一次模式，如果需要修改賬號(hào)體系，只能重新創(chuàng)建應(yīng)用）
    賬號(hào)體系集成.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"];
簡(jiǎn)單搭建登錄界面
Simulator Screen Shot 2016年9月5日 下午5.44.14.png
注冊(cè)
- (IBAction)registerButtonClick:(id)sender
{
    if (self.nameTextField.text.length == 0)
    {
        NSLog(@"請(qǐng)輸入用戶名");
        return;
    }else if (self.nameTextField.text.length > 24)
    {
        NSLog(@"用戶名最長(zhǎng)不超過(guò)24字節(jié)");
        return;
    }

    if (self.passWordTextField.text.length == 0)
    {
        NSLog(@"請(qǐng)輸入密碼");
        return;
    }else if (self.passWordTextField.text.length < 8)
    {
        NSLog(@"請(qǐng)輸入長(zhǎng)度為8-16位密碼");
        return;
    }else if (self.passWordTextField.text.length > 16)
    {
        NSLog(@"請(qǐng)輸入長(zhǎng)度為8-16位密碼");
        return;
    }
//注冊(cè)
/**
 *  字符串賬號(hào)+密碼注冊(cè)接口
 *  @param account - 用戶輸入的賬號(hào)名，最長(zhǎng)不得超過(guò)24字節(jié)
 *  @param password - 用戶輸入的密碼，密碼最短8字節(jié)，最長(zhǎng)16字節(jié)
 *  @param listener - 回調(diào)接口 需要實(shí)現(xiàn)TLSStrAccountRegProtocol協(xié)議
 *  @return 0表示調(diào)用成功；其他表示調(diào)用失敗，返回碼見(jiàn)：_TLS_RETURN_VALUES
 */
    [[TLSAccountHelper getInstance]TLSStrAccountReg:self.nameTextField.text andPassword:self.passWordTextField.text andTLSStrAccountRegListener:self];
//遵守TLSStrAccountRegListener 協(xié)議
}

SDK用戶名和密碼限制

  • 用戶名 <24字節(jié)
  • 8字節(jié) <密碼 < 16字節(jié)
注冊(cè)成功回調(diào)
#pragma mark - TLSPwdLoginListener

- (void)OnStrAccountRegSuccess:(TLSUserInfo *)userInfo
{
    NSLog(@"注冊(cè)成功---userInfo = %@",userInfo);
}

-(void)OnStrAccountRegFail:(TLSErrInfo *)errInfo
{
    NSLog(@"注冊(cè)失敗---errInfo = %@",errInfo);
}

-(void)OnStrAccountRegTimeout:(TLSErrInfo *)errInfo
{
    NSLog(@"注冊(cè)超時(shí)---errInfo = %@",errInfo);
}
登錄
- (IBAction)loginButtonClick:(id)sender
{
    if (self.nameTextField.text.length == 0)
    {
        NSLog(@"請(qǐng)輸入用戶名");
        return;
    }else if (self.nameTextField.text.length > 24)
    {
        NSLog(@"用戶名最長(zhǎng)不超過(guò)24字節(jié)");
        return;
    }

    if (self.passWordTextField.text.length == 0)
    {
        NSLog(@"請(qǐng)輸入密碼");
        return;
    }else if (self.passWordTextField.text.length < 8)
    {
        NSLog(@"請(qǐng)輸入長(zhǎng)度為8-16位密碼");
        return;
    }else if (self.passWordTextField.text.length > 16)
    {
        NSLog(@"請(qǐng)輸入長(zhǎng)度為8-16位密碼");
    }
    //注意這里是登錄TLS，如果登錄成功后就進(jìn)入主界面，請(qǐng)求會(huì)話或者好友列表會(huì)返回用戶沒(méi)有登錄錯(cuò)誤，因此這里需要再TLS登錄成功后，繼續(xù)登錄IMSDK
    int result = [[TLSLoginHelper getInstance]TLSPwdLogin:self.nameTextField.text andPassword:self.passWordTextField.text andTLSPwdLoginListener:self];
}
登錄回調(diào)
#pragma mark -TLSPwdLoginListener
/**
 *  密碼登陸要求驗(yàn)證圖片驗(yàn)證碼
 *
 *  @param picData 圖片驗(yàn)證碼
 *  @param errInfo 錯(cuò)誤信息
 */
-(void)OnPwdLoginNeedImgcode:(NSData *)picData andErrInfo:(TLSErrInfo *)errInfo
{
    NSLog(@"登錄異常請(qǐng)輸入圖片驗(yàn)證碼----errInfo = %@", errInfo);
}

/**
 *  密碼登陸請(qǐng)求圖片驗(yàn)證成功
 *
 *  @param picData 圖片驗(yàn)證碼
 */
-(void)OnPwdLoginReaskImgcodeSuccess:(NSData *)picData
{
    NSLog(@"圖片驗(yàn)證碼驗(yàn)證成功---%@",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 錯(cuò)誤信息
 */
-(void)OnPwdLoginFail:(TLSErrInfo *)errInfo
{
    NSLog(@"密碼登錄失敗----errInfo = %@",errInfo);
}

/**
 *  密碼登陸超時(shí)
 *
 *  @param errInfo 錯(cuò)誤信息
 */
-(void)OnPwdLoginTimeout:(TLSErrInfo *)errInfo
{
    NSLog(@"密碼登錄超時(shí)----errInfo = %@",errInfo);
}
實(shí)現(xiàn)自動(dòng)登錄功能
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

//獲取最后一些登錄的用戶
    TLSUserInfo *user = [helper getLastUserInfo];
//判斷用戶是否需要自動(dòng)登錄
    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下載地址

最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點(diǎn)，簡(jiǎn)書(shū)系信息發(fā)布平臺(tái)，僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容