iOS QQ第三方登录
一.集成SDK
首先下载官网SDK
iOS_SDK下载,目前来说最新的包是V3.2.1,下载完解压后你会看到
- TencentOpenAPI.framework打包了iOS SDK的头文件定义和具体实现
- TencentOpenApi_iOS_Bundle.bundle 打包了iOS SDK需要的资源文件
然后将这两个文件拖入到工程中
二.配置工程
1.导入库文件：
SystemConfiguration.frameworkSecurity.framework
CoreTelephony.framework
CoreGraphics.Framework
libiconv.tbd
libsqlite3.tbd
libstdc++.tbd
libz.tbd
2. 修改必要的工程配置属性：
在工程配置中的“Build Settings”一栏中找到“Linking”配置区，给“Other Linker Flags”配置项添加属性值“-fobjc-arc”
3.Info.Plist设置
在工程配置中的"Info"中找到"URL Types",添加一条新的“URL scheme”.
注意:
Identifier: tencentopenapi URL Schemes: tencent + appid其中Identifier 和URL Schemes是必填项。Identifier是tencentopenapi，URL Schemes是tencent加上你在官网申请的appid
4.针对ios9以后，需要添加白名单
找到工程的Info.plist,然后添加"LSApplicationQueriesSchemes"
<key>LSApplicationQueriesSchemes</key> <array> <string>mqqapi</string> <string>mqq</string> <string>mqqOpensdkSSoLogin</string> <string>mqqconnect</string> <string>mqqopensdkdataline</string> <string>mqqopensdkgrouptribeshare</string> <string>mqqopensdkfriend</string> <string>mqqopensdkapi</string> <string>mqqopensdkapiV2</string> <string>mqqopensdkapiV3</string> <string>mqzoneopensdk</string> <string>mqqopensdkapiV3</string> <string>mqqopensdkapiV3</string> <string>mqzone</string> <string>mqzonev2</string> <string>mqzoneshare</string> <string>wtloginqzone</string> <string>mqzonewx</string> <string>mqzoneopensdkapiV2</string> <string>mqzoneopensdkapi19</string> <string>mqzoneopensdkapi</string> <string>mqzoneopensdk</string> </array>
三.集成代码
在AppDelegate.m中：
#import "AppDelegate.h"
#import <TencentOpenAPI/QQApiInterface.h>
#import <TencentOpenAPI/TencentOAuth.h>
@interface AppDelegate ()<QQApiInterfaceDelegate>
@end
@implementation AppDelegate
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// Override point for customization after application launch.
return YES;
}
-(BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<NSString *,id> *)options{
/**
处理由手Q唤起的跳转请求
\param url 待处理的url跳转请求
\param delegate 第三方应用用于处理来至QQ请求及响应的委托对象
\return 跳转请求处理结果，YES表示成功处理，NO表示不支持的请求协议或处理失败
*/
[QQApiInterface handleOpenURL:url delegate:self];
return [TencentOAuth HandleOpenURL:url];
}
/**
处理来至QQ的请求
*/
- (void)onReq:(QQBaseReq *)req{
NSLog(@" ----req %@",req);
}
/**
处理来至QQ的响应
*/
- (void)onResp:(QQBaseResp *)resp{
NSLog(@" ----resp %@",resp);
}
/**
处理QQ在线状态的回调
*/
- (void)isOnlineResponse:(NSDictionary *)response{
}
在你登录的类中：
#define APP_ID @"你获得的appid"
#import "ViewController.h"
#import <TencentOpenAPI/TencentOAuth.h>
#import <TencentOpenAPI/TencentApiInterface.h>
@interface ViewController ()<TencentSessionDelegate>
{
TencentOAuth *_tencentOAuth;
NSMutableArray *_permissionArray; //权限列表
}
@end
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
// Do any additional setup after loading the view, typically from a nib.
}
- (IBAction)QQLogin:(id)sender {
_tencentOAuth=[[TencentOAuth alloc]initWithAppId:APP_ID andDelegate:self];
//设置权限数据 ， 具体的权限名，在sdkdef.h 文件中查看。
_permissionArray = [NSMutableArray arrayWithObjects: kOPEN_PERMISSION_GET_SIMPLE_USER_INFO,nil];
//登录操作
[_tencentOAuth authorize:_permissionArray inSafari:NO];
}
/**
* 登录成功后的回调
*/
- (void)tencentDidLogin{
/** Access Token凭证，用于后续访问各开放接口 */
if (_tencentOAuth.accessToken) {
//获取用户信息。 调用这个方法后，qq的sdk会自动调用
//- (void)getUserInfoResponse:(APIResponse*) response
//这个方法就是 用户信息的回调方法。
[_tencentOAuth getUserInfo];
}else{
NSLog(@"accessToken 没有获取成功");
}
}
/**
* 登录失败后的回调
* \param cancelled 代表用户是否主动退出登录
*/
- (void)tencentDidNotLogin:(BOOL)cancelled{
if (cancelled) {
NSLog(@" 用户点击取消按键,主动退出登录");
}else{
NSLog(@"其他原因， 导致登录失败");
}
}
/**
* 登录时网络有问题的回调
*/
- (void)tencentDidNotNetWork{
NSLog(@"没有网络了， 怎么登录成功呢");
}
/**
* 因用户未授予相应权限而需要执行增量授权。在用户调用某个api接口时，如果服务器返回操作未被授权，则触发该回调协议接口，由第三方决定是否跳转到增量授权页面，让用户重新授权。
* \param tencentOAuth 登录授权对象。
* \param permissions 需增量授权的权限列表。
* \return 是否仍然回调返回原始的api请求结果。
* \note 不实现该协议接口则默认为不开启增量授权流程。若需要增量授权请调用\ref TencentOAuth#incrAuthWithPermissions: \n注意：增量授权时用户可能会修改登录的帐号
*/
- (BOOL)tencentNeedPerformIncrAuth:(TencentOAuth *)tencentOAuth withPermissions:(NSArray *)permissions{
// incrAuthWithPermissions是增量授权时需要调用的登录接口
// permissions是需要增量授权的权限列表
[tencentOAuth incrAuthWithPermissions:permissions];
return NO; // 返回NO表明不需要再回传未授权API接口的原始请求结果；
// 否则可以返回YES
}
/**
* [该逻辑未实现]因token失效而需要执行重新登录授权。在用户调用某个api接口时，如果服务器返回token失效，则触发该回调协议接口，由第三方决定是否跳转到登录授权页面，让用户重新授权。
* \param tencentOAuth 登录授权对象。
* \return 是否仍然回调返回原始的api请求结果。
* \note 不实现该协议接口则默认为不开启重新登录授权流程。若需要重新登录授权请调用\ref TencentOAuth#reauthorizeWithPermissions: \n注意：重新登录授权时用户可能会修改登录的帐号
*/
- (BOOL)tencentNeedPerformReAuth:(TencentOAuth *)tencentOAuth{
return YES;
}
/**
* 用户通过增量授权流程重新授权登录，token及有效期限等信息已被更新。
* \param tencentOAuth token及有效期限等信息更新后的授权实例对象
* \note 第三方应用需更新已保存的token及有效期限等信息。
*/
- (void)tencentDidUpdate:(TencentOAuth *)tencentOAuth{
NSLog(@"增量授权完成");
if (tencentOAuth.accessToken
&& 0 != [tencentOAuth.accessToken length])
{ // 在这里第三方应用需要更新自己维护的token及有效期限等信息
// **务必在这里检查用户的openid是否有变更，变更需重新拉取用户的资料等信息** _labelAccessToken.text = tencentOAuth.accessToken;
}
else
{
NSLog(@"增量授权不成功，没有获取accesstoken");
}
}
/**
* 用户增量授权过程中因取消或网络问题导致授权失败
* \param reason 授权失败原因，具体失败原因参见sdkdef.h文件中\ref UpdateFailType
*/
- (void)tencentFailedUpdate:(UpdateFailType)reason{
switch (reason)
{
case kUpdateFailNetwork:
{
// [email protected]"增量授权失败，无网络连接，请设置网络";
NSLog(@"增量授权失败，无网络连接，请设置网络");
break;
}
case kUpdateFailUserCancel:
{
// [email protected]"增量授权失败，用户取消授权";
NSLog(@"增量授权失败，用户取消授权");
break;
}
case kUpdateFailUnknown:
default:
{
NSLog(@"增量授权失败，未知错误");
break;
}
}
}
/**
* 获取用户个人信息回调
* \param response API返回结果，具体定义参见sdkdef.h文件中\ref APIResponse
* \remarks 正确返回示例: \snippet example/getUserInfoResponse.exp success
* 错误返回示例: \snippet example/getUserInfoResponse.exp fail
*/
- (void)getUserInfoResponse:(APIResponse*) response{
NSLog(@" response %@",response);
}
- (void)didReceiveMemoryWarning {
[super didReceiveMemoryWarning];
// Dispose of any resources that can be recreated.
}
@end