项目中集成QQ登录与分享

QQ

前言

在很多项目中都会使用第三方登录,登录方式大致都是QQ、微信、微博这三个爸爸。下面的文章将会简单介绍一下个人在项目中集成QQ登录与分享功能的流程以及在过程中遇到的问题。

准备工作

  1. 首先需要在腾讯开放平台申请成为应用开发者。
    我注册的是个人开发者,需要提交的材料包括姓名、手机号、身份证号、邮箱、居住地址,最重要的是个人手持身份证的照片(大小限制在2M以内)
  2. 下载SDK
    SDK
    iOS SDK包中带有两个文件:
    TencentOpenAPI.framework打包了iOS SDK的头文件定义和具体实现。
    TencentOpenApi_iOS_Bundle.bundle 打包了iOS SDK需要的资源文件。

SDK中文件

SDK环境搭建

开发时,我使用的是Xcode 8以及iOS 8+环境。

  1. TencentOpenAPI.frameworkTencentOpenApi_iOS_Bundle.bundle拖入到工程
  2. 添加依赖库
    添加依赖库
  3. 关联TencentOpenApi_iOS_Bundle.bundle文件
    关联Bundle文件
  4. 在工程配置中的“Build Settings”一栏中找到“Linking”配置区,给“Other Linker Flags”配置项添加属性值“-fobjc-arc”。
    修改必要属性
  5. 配置URL Scheme
    配置URL Scheme
  6. 在iOS9.0以后,需要添加白名单
    在info.plist文件中加入 LSApplicationQueriesSchemes。SDK中demo下有该字段,可以去复制。

白名单

接入代码

AppDelegate中代码

  1. 引入头文件并遵循代理
    头文件和代理
  2. 处理跳转请求
    处理跳转请求

ViewController.m中代码

1.QQ登录

1
2
3
4
// appID是在腾讯开放平台创建应用所分配的
TencentOAuth *loginOAuth = [[TencentOAuth alloc] initWithAppId:appID andDelegate:self];
NSArray *permissions = @[kOPEN_PERMISSION_GET_SIMPLE_USER_INFO, kOPEN_PERMISSION_ADD_SHARE, kOPEN_PERMISSION_GET_INFO, kOPEN_PERMISSION_GET_USER_INFO];
[loginOAuth authorize:permissions];

permissions是请求权限类型数组,权限内容如下图:
权限
请求登录后,会跳转到手机QQ获取权限,之后可以在回调代理中处理登录状态

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
/**
* 登录成功后的回调
*/
- (void)tencentDidLogin;

/**
* 登录失败后的回调
* \param cancelled 代表用户是否主动退出登录
*/
- (void)tencentDidNotLogin:(BOOL)cancelled;

/**
* 登录时网络有问题的回调
*/
- (void)tencentDidNotNetWork;

QQ登录成功后,如果想要获取QQ用户信息,则可在tencentDidLogin方法中编写下述代码:

1
2
3
4
5
6
7
- (void)tencentDidLogin {
// 判断是否获取到Access Token凭证,用于后续访问各开发接口,例如:发表说说到QQ空间、获取用户QQ控件相册列表等
if (_loginOAuth.accessToken) {
// 获取用户信息
[_loginOAuth getUserInfo];
}
}

接下来,在getUserInfoResponse:方法中获取用户信息:

1
2
3
- (void)getUserInfoResponse:(APIResponse *)response {
NSLog(@"用户信息:%@",response);
}

2.QQ分享
QQ分享可以分享给好友,也可以分享到QQ空间。

  • 分享URL给好友

    1
    2
    3
    4
    5
    6
    // 初始化授权登录对象
    _oauth = [[TencentOAuth alloc] initWithAppId:appid andDelegate:self];
    QQApiURLObject *urlObject = [QQApiURLObject objectWithURL:[NSURL URLWithString:@"https://itunes.apple.com/cn/app/id1223932262?mt=8"] title:@"团组发票管理" description:@"很好用的哟我开发的哟哈哈哈哈" previewImageData:UIImageJPEGRepresentation([UIImage imageNamed:@"test"], 1) targetContentType:QQApiURLTargetTypeNews];
    SendMessageToQQReq *req = [SendMessageToQQReq reqWithContent:urlObject];
    // 分享给好友
    [QQApiInterface sendReq:req];
  • 分享到QQ空间

    1
    2
    3
    4
    5
    _oauth = [[TencentOAuth alloc] initWithAppId:appid andDelegate:self];
    QQApiTextObject *txtObj = [QQApiTextObject objectWithText:@"这是一段文字哟"];
    SendMessageToQQReq *req = [SendMessageToQQReq reqWithContent:txtObj];
    //将内容分享到qq
    QQApiSendResultCode sent = [QQApiInterface SendReqToQZone:req];

其他功能

SDK中还可以实现其他功能,在这里不一一详述,有需求大家可以仔细阅读文档,或者查看官方Demo中的API。

引用文档