IOS SDK API使用说明
IOS SDK API使用说明 (1)
1. SSO安全登录QQ帐号 (3)
1.1授权登录 (3)
1.2获取用户授权参数说明 (4)
2. 分享到QQ和QQ空间 (5)
2.1 分享到QQ好友 (5)
2.2 分享到QQ空间 (5)
2.3 分享示例代码(详细请参见SDK中Demo) (5)
3. 调用OpenAPI (10)
3.1 OpenAPI参数字典封装 (10)
3.2 设置用户头像调用示例 (10)
3.3 使用增量授权 (11)
3.4 返回数据说明 (13)
3.5 返回码说明 (13)
4. WPA临时会话 (15)
4.1 发起QQ临时会话 (15)
4.2 获取指定QQ号码的在线状态 (15)
5. QZone (16)
5.1 获取用户信息 (16)
5.2分享到QZone (17)
5.3 创建QZone相册 (17)
5.4 获取相册列表 (18)
5.5 上传图片 (19)
5.6 发表说说 (19)
5.7 验证空间粉丝 (21)
5.8 分享文本到QZone写说说 (21)
5.9 分享图片到QZone写说说 (21)
5.9 分享图片到QZone写说说 (22)
6. 处理QQ业务的回调 (23)
1. SSO安全登录QQ帐号
iOS SDK支持应用跳转到手机QQ进行登录,给用户提供更加安全、快捷的体验。
如果用户没有安装手机QQ,且开发者具有webview权限,则显示登录页;如果开发者没有webvi ew权
生活相册限,sdk版本大于等于2.9,则显示登录页,sdk版本小于2.9,则显示下载页。由于跳转至下载页在当前苹果app审核有被拒风险,所以,希望开发者尽快升级是用最新版sdk。
1.1授权登录
整个授权过程可以分为,发送请求获取用户授权以及获取用户授权结果两个部分。
✓发送请求获取用户授权:
在取得用户授权之前,首先必须清楚自己需要用户的哪些信息,iOS SDK提供多种选择,开发者可以根据自己的需要请求用户不同信息的授权。具体可以获取的授权信息参见1.2获取用户授权参数说明。
在设置完需要请求的授权信息之后,就可以发送请求了(备注:inSafari参数从iOS SDK1.3版本后废除)。
NSArray* permissions = [NSArray arrayWithObjects:
kOPEN_PERMISSION_GET_USER_INFO,
kOPEN_PERMISSION_GET_SIMPLE_USER_INFO,
kOPEN_PERMISSION_ADD_SHARE,
nil];
[[[sdkCall getinstance] oauth] authorize:permissions inSafari:NO];
✓获取用户授权结果
获取用户授权结果,采用的是通知中心的方式,所以开发者需要先监听响应的通知,登录结果分为三种,登录成功(kLoginSuccessed)、登录失败(kLoginFailed)和登录取消(kLoginCancelled)。监听方式如下:
[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(loginSuccesse d) name:kLoginSuccessed object:[sdkCall getinstance]];
[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(loginFailed) na me:kLoginFailed object:[sdkCall getinstance]];
[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(loginCancelled) name:kLoginCancelled object:[sdkCall getinstance]];
如果登录成功,则开发者可以通过[sdkCall getinstance].oauth取得响应的accessToken和openI d,这两个参数在此后的获取用户信息、分享等其他操作中有重要的作用。
1.2获取用户授权参数说明
kOPEN_PERMISSION_GET_USER_INFO - 获取用户信息
kOPEN_PERMISSION_GET_SIMPLE_USER_INFO - 移动端获取用户信息
kOPEN_PERMISSION_GET_VIP_RICH_INFO - 获取会员用户详细信息
kOPEN_PERMISSION_GET_VIP_INFO - 获取会员用户基本信息
kOPEN_PERMISSION_ADD_TOPIC - 发表一条说说到QQ空间(需要申请权限) kOPEN_PERMISSION_ADD_ONE_BLOG - 发表一篇日志到QQ空间(需要申请权限) kOPEN_PERMISSION_ADD_ALBUM - 创建一个QQ空间相册(需要申请权限) kOPEN_PERMISSION_UPLOAD_PIC - 上传一张照片到QQ空间相册(需要申请权限) kOPEN_PERMISSION_LIST_ALBUM - 获取用户QQ空间相册列表(需要申请权限) kOPEN_PERMISSION_ADD_SHARE - 同步分享到QQ空间、腾讯微博
kOPEN_PERMISSION_CHECK_PAGE_FANS - 验证是否认证空间粉丝
kOPEN_PERMISSION_ADD_PIC_T - 上传图片并发表消息到腾讯微博
kOPEN_PERMISSION_DEL_T - 删除一条微博信息
kOPEN_PERMISSION_GET_REPOST_LIST - 获取一条微博的转播或评论信息列表kOPEN_PERMISSION_GET_INFO - 获取登录用户自己的详细信息
kOPEN_PERMISSION_GET_OTHER_INFO - 获取其他用户的详细信息
kOPEN_PERMISSION_GET_FANSLIST - 获取登录用户的听众列表
kOPEN_PERMISSION_GET_IDOLLIST - 获取登录用户的收听列表
kOPEN_PERMISSION_ADD_IDOL - 收听腾讯微博上的用户
kOPEN_PERMISSION_DEL_IDOL - 取消收听腾讯微博上的用户
kOPEN_PERMISSION_GET_INTIMA TE_FRIENDS_WEIBO - 获取微博中最近at的好友kOPEN_PERMISSION_MA TCH_NICK_TIPS_WEIBO - 获取微博中匹配昵称的好友
2. 分享到QQ和QQ空间
2.1 分享到QQ好友
在用户安装了手机QQ时通过手机QQ进行分享,否则调用浏览器页面进行分享。
其中文本消息,图文消息和音频消息的title是必须的,summary可以不填,具体调用请参考2.3 分享示例代码。
使用分享到QQ好友功能需要设置QQ业务回调,请参考6.处理QQ业务的回调。
2.2 分享到QQ空间
分享到QQ空间的接口用于取代老的分享接口addShareWithParams(该接口已经废弃)。
在用户安装了手机QQ(4.6版本以上)时通过手机QQ中的QZone结合版进行分享,否则调用浏览器页面进行分享。分享时调用浏览器页面进行分享。其中title是必须的,summary可以不填,具体调用请参考2.3 分享示例代码。使用分享到QQ空间功能需要设置QQ业务回调,请参考6.处理QQ业务的回调。
在分享到QQ好友和QQ空间的时候,根据是本地分享还是浏览器中的分享,支持分享的消息类型不同。
因为webQQ好友分享和web QQ空间的分享都不支持非URL类型的分享,所以这里建议在分享到QQ好友或者QQ空间的时候尽量避免这两种类型的调用,避免发生不支持的错误。
分享消息类型QQ好友QQ空间web QQ好友web QQ空间QQApiTextObject 支持不支持不支持不支持QQApiImageObject 支持不支持不支持不支持QQApiNewsObject 支持支持支持支持QQApiAudioObject 支持支持支持支持QQApiVideoObject 支持支持支持支持QQApiGroupT ribeImageObject 仅部落不支持不支持不支持QQApiAddFriendObject 游戏好友不支持不支持不支持QQApiFileObject 仅数据线不支持不支持不支持
仅部落不支持不支持不支持QQApiGameConsortiumBindingGro
upObject
2.3 分享示例代码(详细请参见SDK中Demo)
下面是各种分享消息的实例代码,作为开发者调用QQ好友分享和QQ空间分享的参考:(注:如果可以分享到QQ空间,则会在示例代码中给出;不给出,则表示空间不支持该类分享)
纯文本分享
版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。
发表评论