通过接入QQ登录功能,用户可使 用QQ帐号快速登录你的网站,降低注册门槛,为你的 网站带来海量新用户。
网站应用接入QQ分享组件,方便用户将资讯 等内容分享给QQ好友、群、讨论组或空间,进行 快速社交传播,
为你的网站带回大量流量。
手把手教你接入QQ互联完美教程如下:
一,成为开发者
开发者通过以下几个步骤,即可接入互联开放平台:
注册开发者→创建应用→通过审核并获取接口权限
1.注册开发者
1. 在QQ互联开放平台首页 https://connect.qq.com/ ,点击右上角的“登录”按钮,使用QQ帐号登录,如下图所示:
开发者QQ号码一旦注册不能变更,建议使用公司公共QQ号码而不是员工私人号码注册,以免遇到员工离职等情况造成不必要的麻烦。
二,创建应用
网站应用及移动应用接入申请
应用接入前,首先需进行申请,获得对应的appid与appkey,以保证后续流程中可正确对网站与用户进行验证与授权。
1.1 创建应用
开发者注册完成后,点击“应用管理”按钮。
跳转到qq互联管理中心页面,点击创建应用。
选择需要创建的应用类型,我们以网站应用为例:
点击创建网站应用后,按要求完善信息:
网站信息填写完成,点击“创建应用”后,网站应用创建完成,点击“应用管理”,进入管理中心,在管理中心可以查看到网站获取的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.7 | 2019-10-16 | 16.37M | V3.3.7功能亮点介绍:
|
Android_SDK_V3.3.7 | 2019-12-19 | 3.49M | V3.3.7功能亮点介绍:
|
SDK for 网站接入
SDK类型 | 最近更新日期 | 文件大小 | 说明 |
---|---|---|---|
JS SDK | 2012-05-30 | / | 方便网站快速接入QQ登录,QQ互联提供了JS-widget。 JS-widget是JS封装的SDK,只需要在网站引入JS文件,就可以用封装好的方法访问对应的API,开发简单。使用说明:详见 JS SDK使用说明。
修改历史: |
PHP SDK v2.2 | 2018-03-19 | 106 K | V3.3.3功能亮点介绍: 使用说明:详见下载包中doc文件夹中的文档。 修改历史:V2.2修复了一个安全问题。
MD5: |
四,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的Universal Links失败,请检查当前手机的网络状态是否正常,或者更新/重装手机QQ。
3. 确认APP自身的Universal Links正常
按照接入指引中apple-app-site-association配置文件的编写格式,部署ok。同样按照第2点的方式,确认APP自身的Universal Links是否可以正常打开。
4. 分享交互行为确认
【场景一】
未使用授权登录的情况下,“首次”进行分享,唤起手机QQ-->分享成功后弹窗提醒只有一个选项(即返回APP),并无“留在QQ”的选项。
后续分享成功后,选项卡可选择留在QQ。
【场景二】
场景一中若在无“留在QQ”的状态下,没有点击返回第三方APP,下次再进行分享时,会出现如图四的“安全校验页”。
此时交互为:从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); |
5.2 当出现了图4的安全校验页,并紧接着正常打开了第三APP;若此时“停留在第三方APP中,并未出现二次跳装的过程”,则检查如下接口的初始化代码,即 delegate不可为nil 。
/** * 初始化TencentOAuth对象 * \param appId 不可为nil,第三方应用在互联开放平台申请的唯一标识 * \param delegate 不可为nil,第三方应用用于接收请求返回结果的委托对象 * \return 初始化后的授权登录对象 */ - (id)initWithAppId:(NSString *)appId andDelegate:(id<TencentSessionDelegate>)delegate; |