通过接入QQ登录功能,用户可使 用QQ帐号快速登录你的网站,降低注册门槛,为你的 网站带来海量新用户。


网站应用接入QQ分享组件,方便用户将资讯 等内容分享给QQ好友、群、讨论组或空间,进行 快速社交传播,


为你的网站带回大量流量。

手把手教你接入QQ互联完美教程如下:


一,成为开发者

开发者通过以下几个步骤,即可接入互联开放平台: 

注册开发者→创建应用→通过审核并获取接口权限

1.注册开发者

1. 在QQ互联开放平台首页 https://connect.qq.com/ ,点击右上角的“登录”按钮,使用QQ帐号登录,如下图所示:

重要提示:
开发者QQ号码一旦注册不能变更,建议使用公司公共QQ号码而不是员工私人号码注册,以免遇到员工离职等情况造成不必要的麻烦。


2. 登录成功后会跳转到开发者注册页面,在注册页面按要求提交公司或个人的基本资料。下图所示的是公司注册页面:

二,创建应用

 

网站应用及移动应用接入申请

 
应用接入前,首先需进行申请,获得对应的appid与appkey,以保证后续流程中可正确对网站与用户进行验证与授权。

1.1 创建应用

开发者注册完成后,点击“应用管理”按钮。

跳转到qq互联管理中心页面,点击创建应用。

选择需要创建的应用类型,我们以网站应用为例:

点击创建网站应用后,按要求完善信息:

  1. 网站回调地址填写规范:http://wiki.connect.qq.com/%E5%9B%9E%E8%B0%83%E5%9C%B0%E5%9D%80%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98%E5%8F%8A%E4%BF%AE%E6%94%B9%E6%96%B9%E6%B3%95

  2. 备案信息填写规范:http://www.miitbeian.gov.cn/publish/query/indexFirst.action


网站信息填写完成,点击“创建应用”后,网站应用创建完成,点击“应用管理”,进入管理中心,在管理中心可以查看到网站获取的appid和appkey,如下图所示:

备注:创建移动应用与网站应用步骤方法一致,在此不赘述。
 

1.2 网站信息完善

点击“应用中心”,应用右侧的“查看”,进入应用详情页面。

应用详情页面可点击“修改”来编辑应用“基本信息”和“平台信息”。


点击“应用接口”可查看已获取的接口,使用QQ登录功能。


三,SDK下载

腾讯QQ互联平台为广大开发者整理了以下SDK列表,辅助开发者快速接入QQ登录、分享等功能。

使用时请注意:
1. 对于非官方SDK包,由于腾讯未对其进行验证,因此无法保证其可用性。使用时遇到问题请直接与作者联系或在论坛上反馈,腾讯公司将不提供相关的技术支持。
2. 本页面提供的SDK全部基于OAuth2.0协议,不再支持OAuth1.0。
3. QQ互联将于2019年12月1日进行Universal Links校验,为不影响应用使用QQ的登录及分享能力, 请各位开发者升级到SDK3.3.7版本后务必按照接入指南进行Universal Links的适配。点击查看详情

SDK for 移动应用接入

SDK类型最近更新日期文件大小说明
iOS_SDK_V3.3.72019-10-1616.37MV3.3.7功能亮点介绍:


  • 支持第三方直接唤起手Q小程序

  • 支持第三方直接唤起并使用手Q的IM能力,如聊天会话、语音通话、视频通话等

  • 支持同一个AppID的场景下(iPhone版本和iPadHD版本),区分多个UniversalLink的处理能力

Android_SDK_V3.3.72019-12-193.49MV3.3.7功能亮点介绍:


  • 新增IM能力,包括聊天、语音、通话

  • 新增互联小程序/小游戏能力

SDK for 网站接入

SDK类型最近更新日期文件大小说明
 JS SDK2012-05-30      /方便网站快速接入QQ登录,QQ互联提供了JS-widget。
JS-widget是JS封装的SDK,只需要在网站引入JS文件,就可以用封装好的方法访问对应的API,开发简单。使用说明:详见 JS SDK使用说明

 

修改历史
V1.0.1 解决了与浏览器已知的兼容性问题。
V1.0.0 适用于基于OAuth2.0的JavaScript网站接入。

PHP SDK v2.22018-03-19106 KV3.3.3功能亮点介绍:
使用说明:详见下载包中doc文件夹中的文档。
修改历史:V2.2修复了一个安全问题。

 

MD5:
0e6a40779bd2caca959c429b3443c4a1


四,Universal Links适配FAQ

1. 系统及版本要求

Universal Links方案是基于苹果在iOS13系统上针对隐私政策的调整,相关的验证环境请首先确认:

  • 1. SDK版本: OpenSdk3.3.7或以上

  • 2. 手Q版本: 8.1.3或以上

  • 3. 系统版本: iOS13或以上


2. 确认手机QQ的Universal Links正常

确认手机QQ(8.1.3或以上)版本在苹果设备上Universal Links正常,这是为了保证OpenSdk和手机QQ之间的通信正常。

在系统的Safari浏览器中输入 https://qm.qq.com,下拉查看是否有打开QQ的入口,如图一所示:

教你接入QQ互联开发者平台应用完美教程 第15张
图一

若无该打开入口,可能是系统拉取手机QQ的Universal Links失败,请检查当前手机的网络状态是否正常,或者更新/重装手机QQ。


3. 确认APP自身的Universal Links正常

按照接入指引中apple-app-site-association配置文件的编写格式,部署ok。同样按照第2点的方式,确认APP自身的Universal Links是否可以正常打开。


4. 分享交互行为确认

【场景一】

未使用授权登录的情况下,“首次”进行分享,唤起手机QQ-->分享成功后弹窗提醒只有一个选项(即返回APP),并无“留在QQ”的选项。

教你接入QQ互联开发者平台应用完美教程 第16张
图二

后续分享成功后,选项卡可选择留在QQ。

教你接入QQ互联开发者平台应用完美教程 第17张
图三

【场景二】

场景一中若在无“留在QQ”的状态下,没有点击返回第三方APP,下次再进行分享时,会出现如图四的“安全校验页”。

教你接入QQ互联开发者平台应用完美教程 第18张
图四

此时交互为:从APP唤起手Q-->出现安全校验页-->校验成功后返回第三方APP-->再次拉起手Q完成分享。

这种多次跳转的过程,每个用户只会出现一次,若多次出现该类跳转,请按上述检查下Universal Links的有效性。


5. 第三方APP客户端代码确认

5.1 请务必确保第三方APP的客户端已经处理了系统的如下回调函数,具体详情可参见sdkDemo,如下图所示。

- (BOOL)application:(UIApplication *)application continueUserActivity:
(NSUserActivity *)userActivity restorationHandler:(void(^)
(NSArray<id<UIUserActivityRestoring>> * __nullable
restorableObjects))restorationHandler NS_AVAILABLE_IOS(8_0);
教你接入QQ互联开发者平台应用完美教程 第19张
图五

5.2 当出现了图4的安全校验页,并紧接着正常打开了第三APP;若此时“停留在第三方APP中,并未出现二次跳装的过程”,则检查如下接口的初始化代码,即 delegate不可为nil 

/**
* 初始化TencentOAuth对象
* \param appId 不可为nil,第三方应用在互联开放平台申请的唯一标识
* \param delegate 不可为nil,第三方应用用于接收请求返回结果的委托对象
* \return 初始化后的授权登录对象
*/
- (id)initWithAppId:(NSString *)appId
andDelegate:(id<TencentSessionDelegate>)delegate;