TencentOpenAPI iOS SDK  v1.4 Beta
QQ互联开放平台 iOS SDK
 全部  文件 函数 变量 类型定义 枚举 枚举值 属性 
TencentOAuth类 参考

TencentOpenAPI授权登录及相关开放接口调用 更多...

#import <TencentOAuth.h>

继承自 NSObject .

Instance Methods

(id) - initWithAppId:andDelegate:
 
(BOOL) - authorize:inSafari:
 
(BOOL) - authorize:localAppId:inSafari:
 
(BOOL) - incrAuthWithPermissions:
 
(BOOL) - reauthorizeWithPermissions:
 
(BOOL) - handleOpenURL:
 
(void) - logout:
 
(BOOL) - isSessionValid
 
(BOOL) - getUserInfo
 
(BOOL) - getListAlbum
 
(BOOL) - getListPhotoWithParams:
 
(BOOL) - addShareWithParams:
 
(BOOL) - uploadPicWithParams:
 
(BOOL) - addAlbumWithParams:
 
(BOOL) - checkPageFansWithParams:
 
(BOOL) - addOneBlogWithParams:
 
(BOOL) - addTopicWithParams:
 
(BOOL) - setUserHeadpic:
 
(BOOL) - setUserHeadpic:andViewController:
 
(BOOL) - getVipInfo
 
(BOOL) - getVipRichInfo
 
(BOOL) - matchNickTips:
 
(BOOL) - getIntimateFriends:
 
(BOOL) - cancel:
 

Class Methods

(BOOL) + HandleOpenURL:
 

属性

NSString * accessToken
 
NSDate * expirationDate
 
id< TencentSessionDelegatesessionDelegate
 
NSString * localAppId
 
NSString * openId
 
NSString * redirectURI
 
NSString * appId
 

详细描述

TencentOpenAPI授权登录及相关开放接口调用

TencentOAuth实现授权登录逻辑以及相关开放接口的请求调用

Method Documentation

- (BOOL) addAlbumWithParams: (NSMutableDictionary *)  params

在QZone相册中创建一个新的相册

注意
OpenAPI权限申请
参数
params参数字典,字典的关键字参见TencentOAuthObject.h中的TCAddAlbumDic
返回
处理结果,YES表示API调用成功,NO表示API调用失败,登录态失败,重新登录
- (BOOL) addOneBlogWithParams: (NSMutableDictionary *)  params

在QZone中发表一篇日志

注意
OpenAPI权限申请
参数
params参数字典,字典的关键字参见TencentOAuthObject.h中的TCAddOneBlogDic
返回
处理结果,YES表示API调用成功,NO表示API调用失败,登录态失败,重新登录
- (BOOL) addShareWithParams: (NSMutableDictionary *)  params

分享到QZone

参数
params参数字典,字典的关键字参见TencentOAuthObject.h中的TCAddShareDic
返回
处理结果,YES表示API调用成功,NO表示API调用失败,登录态失败,重新登录
- (BOOL) addTopicWithParams: (NSMutableDictionary *)  params

在QZone中发表一条说说

注意
OpenAPI权限申请
参数
params参数字典,字典的关键字参见TencentOAuthObject.h中的TCAddTopicDic
返回
处理结果,YES表示API调用成功,NO表示API调用失败,登录态失败,重新登录
- (BOOL) authorize: (NSArray *)  permissions
inSafari: (BOOL)  bInSafari 

登录授权

参数
permissions授权信息列表
bInSafari是否使用safari进行登录.IOS SDK 1.3版本开始此参数废除
- (BOOL) authorize: (NSArray *)  permissions
localAppId: (NSString *)  localAppId
inSafari: (BOOL)  bInSafari 

登录授权

参数
permissions授权信息列表
localAppId应用APPID
bInSafari是否使用safari进行登录.IOS SDK 1.3版本开始此参数废除
- (BOOL) cancel: (id)  userData

退出指定API调用

参数
userData用户调用某条API的时候传入的保留参数
返回
处理结果,YES表示成功 NO表示失败
- (BOOL) checkPageFansWithParams: (NSMutableDictionary *)  params

检查是否是QZone某个用户的粉丝

参数
params参数字典,字典的关键字参见TencentOAuthObject.h中的TCCheckPageFansDic
返回
处理结果,YES表示API调用成功,NO表示API调用失败,登录态失败,重新登录
- (BOOL) getIntimateFriends: (NSMutableDictionary *)  params

获取最近的微博好友

参数
params参数字典,字典的关键字参见TencentOAuthObject.h中的TCGetIntimateFriendsDic
返回
处理结果,YES表示API调用成功,NO表示API调用失败,登录态失败,重新登录
- (BOOL) getListAlbum

获取用户QZone相册列表

注意
OpenAPI权限申请
返回
处理结果,YES表示API调用成功,NO表示API调用失败,登录态失败,重新登录
- (BOOL) getListPhotoWithParams: (NSMutableDictionary *)  params

获取用户QZone相片列表

注意
OpenAPI权限申请
参数
params参数字典,字典的关键字参见TencentOAuthObject.h中的TCListPhotoDic
返回
处理结果,YES表示API调用成功,NO表示API调用失败,登录态失败,重新登录
- (BOOL) getUserInfo

获取用户个人信息

返回
处理结果,YES表示API调用成功,NO表示API调用失败,登录态失败,重新登录
- (BOOL) getVipInfo

获取QQ会员信息(仅包括是否为QQ会员,是否为年费QQ会员)

注意
OpenAPI权限申请
返回
处理结果,YES表示API调用成功,NO表示API调用失败,登录态失败,重新登录
- (BOOL) getVipRichInfo

获取QQ会员详细信息

注意
OpenAPI权限申请
返回
处理结果,YES表示API调用成功,NO表示API调用失败,登录态失败,重新登录
- (BOOL) handleOpenURL: (NSURL *)  url

处理应用拉起协议

参数
url处理被其他应用呼起时的逻辑
返回
处理结果,YES表示成功,NO表示失败
+ (BOOL) HandleOpenURL: (NSURL *)  url

(静态方法)处理应用拉起协议

参数
url处理被其他应用呼起时的逻辑
返回
处理结果,YES表示成功,NO表示失败
- (BOOL) incrAuthWithPermissions: (NSArray *)  permissions

增量授权,因用户没有授予相应接口调用的权限,需要用户确认是否授权

参数
permissions需增量授权的信息列表
返回
增量授权调用是否成功
- (id) initWithAppId: (NSString *)  appId
andDelegate: (id< TencentSessionDelegate >)  delegate 

初始化TencentOAuth对象

参数
appId第三方应用在互联开放平台申请的唯一标识
delegate第三方应用用于接收请求返回结果的委托对象
返回
初始化后的授权登录对象
- (BOOL) isSessionValid

判断登录态是否有效

返回
处理结果,YES表示有效,NO表示无效,请用户重新登录授权
- (void) logout: (id< TencentSessionDelegate >)  delegate

退出登录

参数
delegate第三方应用用于接收请求返回结果的委托对象
- (BOOL) matchNickTips: (NSMutableDictionary *)  params

获取微博好友名称输入提示,即通过字符串查找匹配的微博好友

参数
params参数字典,字典的关键字参见TencentOAuthObject.h中的TCMatchNickTipsDic
返回
处理结果,YES表示API调用成功,NO表示API调用失败,登录态失败,重新登录
- (BOOL) reauthorizeWithPermissions: (NSArray *)  permissions

重新授权,因token废除或失效导致接口调用失败,需用户重新授权

参数
permissions授权信息列表,同登录授权
返回
授权调用是否成功
- (BOOL) setUserHeadpic: (NSMutableDictionary *)  params

设置QQ头像 使用默认的效果处理设置头像的界面

注意
OpenAPI权限申请
参数
params参数字典,字典的关键字参见TencentOAuthObject.h中的TCSetUserHeadpic
返回
处理结果,YES表示API调用成功,NO表示API调用失败,登录态失败,重新登录
- (BOOL) setUserHeadpic: (NSMutableDictionary *)  params
andViewController: (UIViewController **)  viewController 

设置QQ头像 会返回设置头像由第三方自己处理界面的弹出方式

注意
OpenAPI权限申请
参数
params参数字典,字典的关键字参见TencentOAuthObject.h中的TCSetUserHeadpic
viewController设置头像的界面
返回
处理结果,YES表示API调用成功,NO表示API调用失败,登录态失败,重新登录
- (BOOL) uploadPicWithParams: (NSMutableDictionary *)  params

上传照片到QZone指定相册

注意
OpenAPI权限申请
参数
params参数字典,字典的关键字参见TencentOAuthObject.h中的TCUploadPicDic
返回
处理结果,YES表示API调用成功,NO表示API调用失败,登录态失败,重新登录

属性说明

- (NSString*) accessToken
readwritenonatomiccopy

Access Token凭证,用于后续访问各开放接口

- (NSString*) appId
readwritenonatomicretain

第三方应用在互联开放平台申请的appID

- (NSDate*) expirationDate
readwritenonatomiccopy

Access Token的失效期

- (NSString*) localAppId
readwritenonatomiccopy

第三方应用在开发过程中设置的URLSchema,用于浏览器登录后后跳到第三方应用

- (NSString*) openId
readwritenonatomiccopy

用户授权登录后对该用户的唯一标识

- (NSString*) redirectURI
readwritenonatomiccopy

用户登录成功过后的跳转页面地址

- (id<TencentSessionDelegate>) sessionDelegate
readwritenonatomicassign

已实现的开放接口的回调委托对象


该类的文档由以下文件生成: